Attach Tool

Attach an existing workspace tool definition (webhook / client / MCP) to the agent by its definition id. Idempotent. To create and attach in one step, POST to /v1/agents/{id}/tools instead.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

idstringRequired
toolIdstringRequired

Response

Tool attached.

Errors

401
Unauthorized Error
404
Not Found Error