Skip to navigation

Toolkits · Attach a toolkit to an agent

View as Markdown

Attaches a toolkit by name. Every tool in it becomes available to the agent, which costs prompt budget on every run.

Attached toolkits are stored on the agent record rather than as separate rows, so they are keyed by name — there is no toolkit ID.

resource: agent://build-guide covers narrowing a large toolkit.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

agent_idstringRequired

Agent UUID or slug — both are accepted. From agents_listAgents.

Request

This endpoint expects an object.
namestringRequired

Toolkit name, from agents_listToolkits.

Response

Attached.