Create an agent / attacca docs

`provider_id` names the endpoint the model is served from. There is no public providers endpoint — providers hold BYOK credentials and are managed only from the web app — so copy the `provider_id` off any agent from `GET /v1/agents`. A provider the account cannot see is rejected, which is what stops an agent from being pointed at another account's credentials.

provider_id names the endpoint the model is served from. There is no public providers endpoint — providers hold BYOK credentials and are managed only from the web app — so copy the provider_id off any agent from GET /v1/agents. A provider the account cannot see 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.

can_manage_agents?boolean

Whether the agent may read and edit other agents' configuration.

description?string|null

model*string

name*string

prompt_ids?array<string>

Ids of the prompts composing this agent's instructions, in order.

provider_id*string

The endpoint this agent's model is served from. There is no public providers endpoint — copy the provider_id off any agent returned by GET /v1/agents. Providers hold BYOK credentials, so they are managed only from the web app.

Formatuuid

supports_image?boolean|null

temperature?|

Formatdouble

tool_plugin_ids?array<string>

Tool plugins to enable, by id. See an existing agent's tool_plugin_ids for the vocabulary.

Response Body

`application/json`

curl -X POST "https://example.com/v1/agents" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "name": "string",    "provider_id": "fe3d49af-4061-436b-ae60-f7044f252a44"  }'

{  "can_manage_agents": true,  "created_at": "2019-08-24T14:15:22Z",  "description": "string",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "model": "string",  "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}

Create an agent

Authorization

Request Body

Response Body

200application/json

403application/json

404application/json

`application/json`

`application/json`

`application/json`