Build a complete agent — rules, tools and settings — in one atomic call

Preferred over create + configure + add_rule + add_function. Pass template_id to seed a proven ruleset.

POST /api/v1/agents/provision

cURL

curl --request POST \
  --url 'https://response.stateset.com/api/v1/agents/provision' \
  --header "Authorization: Bearer $RESPONSECX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Two-Person Tent",
  "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "type": "standard",
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "instructions": "Two-person tent, green — replacement for damaged pole set.",
  "goal": "string",
  "role": "string",
  "activated": true,
  "rules": [
    {
      "rule_name": "string",
      "rule_type": "string",
      "description": "Two-person tent, green — replacement for damaged pole set.",
      "activated": true,
      "conditions": {
        "any": null,
        "all": null
      },
      "actions": []
    }
  ],
  "functions": [
    {
      "function_name": "string",
      "endpoint": "https://example.com/webhooks/stateset",
      "method": "string",
      "description": "Two-person tent, green — replacement for damaged pole set.",
      "activated": true,
      "parameters": [],
      "headers": {},
      "timeout": 250
    }
  ],
  "settings": {
    "model_name": "string",
    "model_provider": "string",
    "model_type": "string",
    "temperature": 1.5,
    "max_tokens": 1,
    "top_p": 1.5,
    "escalation_tag_name": "string",
    "escalation_team_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "agent_take_over_tag": "string"
  }
}'

201

{
  "object": "string",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Two-Person Tent",
  "type": "standard",
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "activated": true,
  "goal": "string",
  "role": "string",
  "updated_at": "2026-08-31T14:22:05Z",
  "instructions": "Two-person tent, green — replacement for damaged pole set.",
  "settings": {
    "object": "string",
    "configured": true
  }
}

Preferred over create + configure + add_rule + add_function. Pass template_id to seed a proven ruleset.

Request body

ProvisionAgent

name · string · required

template_id · string

Seeds rules/attributes/examples from a starter template.

type · string

One of: assistant, customer_service, sales.

description · string

instructions · string

The system prompt / persona.

goal · string

role · string

activated · boolean

rules · object[]

functions · object[]

settings · object

Model config. Defaults to the template’s when a template is used.

Response

Agent

object · string

id · string

name · string,null

type · string,null

description · string,null

activated · boolean

goal · string,null

role · string,null

updated_at · string,null

instructions · string,null

Present on single-agent reads and writes only.

settings · AgentSettingsOut

Show AgentSettingsOut

object · string

configured · boolean

False when no settings row exists yet (fields are all null).

Status codes

Code	Meaning
201	The provisioned agent, with a summary of what was created
400	Invalid request. issues names the offending field(s).
401	Missing, invalid, or expired API key.
403	The key lacks a required scope.
409	Conflict — either the creation ceiling was reached for this organization (agent_limit_reached), or a request with the same Idempotency-Key is still in flight (idempotency_in_progress); retry the latter after the first attempt settles.
422	The Idempotency-Key was already used with a DIFFERENT request body (idempotency_key_reused). Reuse a key only to retry the identical request.
429	Rate limit exceeded.

Access

Required scope	agents:write
Rate limit	10 requests per minute

cURL

curl --request POST \
  --url 'https://response.stateset.com/api/v1/agents/provision' \
  --header "Authorization: Bearer $RESPONSECX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Two-Person Tent",
  "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "type": "standard",
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "instructions": "Two-person tent, green — replacement for damaged pole set.",
  "goal": "string",
  "role": "string",
  "activated": true,
  "rules": [
    {
      "rule_name": "string",
      "rule_type": "string",
      "description": "Two-person tent, green — replacement for damaged pole set.",
      "activated": true,
      "conditions": {
        "any": null,
        "all": null
      },
      "actions": []
    }
  ],
  "functions": [
    {
      "function_name": "string",
      "endpoint": "https://example.com/webhooks/stateset",
      "method": "string",
      "description": "Two-person tent, green — replacement for damaged pole set.",
      "activated": true,
      "parameters": [],
      "headers": {},
      "timeout": 250
    }
  ],
  "settings": {
    "model_name": "string",
    "model_provider": "string",
    "model_type": "string",
    "temperature": 1.5,
    "max_tokens": 1,
    "top_p": 1.5,
    "escalation_tag_name": "string",
    "escalation_team_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "agent_take_over_tag": "string"
  }
}'

201

{
  "object": "string",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Two-Person Tent",
  "type": "standard",
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "activated": true,
  "goal": "string",
  "role": "string",
  "updated_at": "2026-08-31T14:22:05Z",
  "instructions": "Two-person tent, green — replacement for damaged pole set.",
  "settings": {
    "object": "string",
    "configured": true
  }
}