Add capability to product | Runtype Documentation

Add a capability (flow or agent binding) to a product. Requires either flowId or agentId.

AuthorizationBearer

API key or Clerk session token

idstringRequired

This endpoint expects an object.

capabilityNamestringRequired1-100 characters

flowIdstringOptional

agentIdstringOptional

capabilityDescriptionstringOptional

parametersSchemaany or nullOptional

enabledbooleanOptional

Capability added

idstring

productIdstring

flowIdstring or null

agentIdstring or null

capabilityNamestring

capabilityDescriptionstring or null

enabledboolean

displayOrderinteger or null

createdAtstring

parametersSchemaany or null

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/products/id/capabilities \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"capabilityName": "User Authentication Flow"
>	}'

1	{
2	"id": "cap-9f8b7c6d-1234-4e56-8a9b-0c1d2e3f4a5b",
3	"productId": "prod-4a7d9e2f-5678-4b9c-8d0e-1f2a3b4c5d6e",
4	"flowId": "flow-3c2b1a0d-9876-4f5e-8d7c-0b1a2c3d4e5f",
5	"agentId": "",
6	"capabilityName": "User Authentication Flow",
7	"capabilityDescription": "Handles user login and session management",
8	"enabled": true,
9	"displayOrder": 1,
10	"createdAt": "2024-06-01T10:15:30Z",
11	"parametersSchema": null
12	}

$	curl -X POST https://api.runtype.com/v1/products/id/capabilities \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"capabilityName": "User Authentication Flow"
>	}'

1	{
2	"id": "cap-9f8b7c6d-1234-4e56-8a9b-0c1d2e3f4a5b",
3	"productId": "prod-4a7d9e2f-5678-4b9c-8d0e-1f2a3b4c5d6e",
4	"flowId": "flow-3c2b1a0d-9876-4f5e-8d7c-0b1a2c3d4e5f",
5	"agentId": "",
6	"capabilityName": "User Authentication Flow",
7	"capabilityDescription": "Handles user login and session management",
8	"enabled": true,
9	"displayOrder": 1,
10	"createdAt": "2024-06-01T10:15:30Z",
11	"parametersSchema": null
12	}