Dispach
HTTP API
POST
/v1/agents

Authorization

bearer
headerAuthorizationBearer <token>

An operator key or the configured token.

Request Body

application/json
  1. body
answers?

A subset of the wizard's steps, as strings. GET /v1/provision lists every step with its prompt, default and choices. Send this or template, not both.

template?string

Create the agent from a template in this server's sandbox instead of from answers. Needs name; takes vars.

Length1 <= length
name?string

The new agent's name, with template. Its slug becomes the id; the template sees both as {{agent.name}} and {{agent.id}}.

vars?

Values for the template's declared variables. A secret variable's value goes to the agent's .env and is never returned.

Response Body

created; adopted is empty with an error if it is not running

Example Request
curl -X POST 'http://localhost:7420/v1/agents' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
Empty