Skip to main content
DELETE
Delete a custom toolkit

Authorizations

x-api-key
string
header
default:your-project-api-key
required

Your Composio project API key. Create or copy it from the Composio dashboard.

Path Parameters

slug
string
required

Custom toolkit slug to delete Slug of the project-owned custom toolkit to delete

Required string length: 1 - 37
Pattern: ^[a-zA-Z0-9_]+$
Example:

"CUSTOM_MY_TOOLKIT"

Query Parameters

revoke_on_delete
boolean | null
default:true

When true (the default), the delete starts background jobs, one per auth config, that revoke the upstream credentials of the toolkit's connected accounts, and the response lists them in revoke_job_ids. Pass false to keep the credentials. Revocation is irreversible — recovering a deleted entity does not restore working credentials.

Response

Successfully deleted toolkit

slug
string
required

Slug of the deleted toolkit

Example:

"CUSTOM_MY_TOOLKIT"

deleted
enum<boolean>
required

Whether the toolkit was deleted

Available options:
true
revoke_job_ids
string[]
required

Background revoke jobs started for this delete, one per auth config. Empty when revoke_on_delete=false.

auth_configs_deleted
number
required

Number of auth configs deleted

connected_accounts_deleted
number
required

Number of connected accounts deleted