Toolkits

Delete a custom toolkit

Changed on

Experimental: custom toolkits are in pilot and this contract may change. Deletes a custom toolkit owned by the project, along with its tools, auth configs, and connected accounts, and revokes the upstream credentials of those connected accounts. Pass ?revoke_on_delete=false to keep the credentials. Composio-managed toolkits cannot be deleted and return 403.

delete/api/v3.1/custom/toolkits/{slug}

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3.1/custom/toolkits/{slug}
  • Auth
    • API key in header x-api-key
    • or API key in header x-user-api-key

Path parameters

slugstring required

Slug of the project-owned custom toolkit to delete

Example:CUSTOM_MY_TOOLKIT

Custom toolkit slug to delete

Query parameters

revoke_on_deleteboolean nullable

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

slugstring required

Slug of the deleted toolkit

deletedtrue required

Whether the toolkit was deleted

revoke_job_idsstring[] required

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

auth_configs_deletednumber required

Number of auth configs deleted

connected_accounts_deletednumber required

Number of connected accounts deleted

Example response

{
  "slug": "CUSTOM_MY_TOOLKIT"
}

Changes