attacca

Create an agent

`model` is the opaque handle `GET /v1/models` returns for this account. `provider_id` is normally unnecessary: a catalogued model names its own provider, and that is the only kind of model this surface can reach without an endpoint of its own. A provider the account cannot reference is rejected, which is what stops an agent from being pointed at another account's credentials.

POST
/v1/agents

model is the opaque handle GET /v1/models returns for this account. provider_id is normally unnecessary: a catalogued model names its own provider, and that is the only kind of model this surface can reach without an endpoint of its own. A provider the account cannot reference is rejected, which is what stops an agent from being pointed at another account's credentials.

Authorization

api_key agents:write
AuthorizationBearer <token>

An atk_-prefixed API key, created under Settings → API keys.

In: header

Scope: agents:write

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/agents" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "name": "string"  }'
{  "can_manage_agents": true,  "created_at": "2019-08-24T14:15:22Z",  "description": "string",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "is_default": true,  "name": "string",  "owner_user_id": "65139110-7c3c-4777-b692-80c218be3b9d",  "prompt_ids": [    "string"  ],  "provider_id": "fe3d49af-4061-436b-ae60-f7044f252a44",  "supports_image": true,  "temperature": 0,  "tool_plugin_ids": [    "string"  ],  "updated_at": "2019-08-24T14:15:22Z",  "version": 0}