API ReferenceToolkits

Delete a custom toolkitv3.1

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

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.

Authorization

x-api-key<token>

Project API key authentication

In: header

Path Parameters

slugstringRequired

Custom toolkit slug to delete

Query Parameters

revoke_on_deletenullable boolean

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.

Default: true

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/api/v3.1/custom/toolkits/CUSTOM_MY_TOOLKIT"
{  "slug": "CUSTOM_MY_TOOLKIT",  "deleted": true,  "revoke_job_ids": [    "string"  ],  "auth_configs_deleted": 0,  "connected_accounts_deleted": 0}
Edit this page on GitHub