Add capability to agent | Runtype Documentation

Add a capability (flow, sub-agent, or tool binding) to an agent.

AuthorizationBearer

API key or Clerk session token

idstringRequired

This endpoint expects an object.

toolNamestringRequired1-100 characters

flowIdstringOptional

subAgentIdstringOptional

toolIdstringOptional

toolDescriptionstringOptional

parametersSchemaany or nullOptional

enabledbooleanOptional

Capability added

idstring

flowIdstring or null

subAgentIdstring or null

toolIdstring or null

toolNamestring

toolDescriptionstring or null

enabledboolean

displayOrderinteger or null

agentIdstring

parametersSchemaany or null

createdAtstring

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error

$	curl -X POST https://api.runtype.com/v1/agents/id/capabilities \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"toolName": "Email Automation Tool"
>	}'

1	{
2	"id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
3	"flowId": "flow-67890",
4	"subAgentId": "subagent-54321",
5	"toolId": "tool-98765",
6	"toolName": "Email Automation Tool",
7	"toolDescription": "Automates sending personalized email campaigns based on user behavior.",
8	"enabled": true,
9	"displayOrder": 1,
10	"agentId": "agent-12345",
11	"parametersSchema": null,
12	"createdAt": "2024-06-01T12:00:00Z"
13	}

$	curl -X POST https://api.runtype.com/v1/agents/id/capabilities \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"toolName": "Email Automation Tool"
>	}'

1	{
2	"id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
3	"flowId": "flow-67890",
4	"subAgentId": "subagent-54321",
5	"toolId": "tool-98765",
6	"toolName": "Email Automation Tool",
7	"toolDescription": "Automates sending personalized email campaigns based on user behavior.",
8	"enabled": true,
9	"displayOrder": 1,
10	"agentId": "agent-12345",
11	"parametersSchema": null,
12	"createdAt": "2024-06-01T12:00:00Z"
13	}