API Reference agents

Create an agent

POST/projects/{project_id}/agents/

Hire an agent into the project team.

Parameters

Body field	Required	Description
name	yes	Roster identity
description	no	What this agent is for
model	no	Model the agent runs on (see List agent models)
provider	no	Provider serving the model
agent_type	no	Runtime kind, default dsh
docker_image	no	Custom image for the agent runtime
driver_config	no	Runtime driver options

Request

curl -X POST "$ALLYBUILD_API_URL/projects/$PROJECT_ID/agents/" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"
  -d '{
    "name": "reviewer",
    "description": "Reviews reports before publishing",
    "model": "deepseek-chat"
  }'

Response

{
  "id": "7c6d5e4f-...",
  "name": "reviewer",
  "model": "deepseek-chat",
  "provider": "",
  "agent_type": "dsh"
}