API Reference / agent-controller

Replace an agent's configuration

patch https://api.intelig.ai/api/v1/intelig/agents/{name}/config

Auth: Authorization: ApiKey <key> (an API key sent as Bearer is rejected) or Authorization: Bearer <jwt> for a dashboard session. operationId: updateConfig

The document you send REPLACES the stored one; it is not merged. Read the current document from GET /agents/{name} first and send it back with your edits applied. Accepted keys are agent-specific. Requires the `agent:write` scope.

Example request

curl -X PATCH "https://api.intelig.ai/api/v1/intelig/agents/string/config" \
  -H "Authorization: ApiKey $INTELIG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "config": "string"
  }'

Path parameters

NameTypeRequiredDescription
name string yes

Request body

application/json

FieldTypeRequiredDescription
config JsonNode no The full configuration document. This replaces the stored one; it is not merged.

Response 200

application/json · ApiResponseAgentDetailResponse

FieldTypeDescription
success boolean
message string
data AgentDetailResponse

Status codes

  • 200 — OK
  • 401 — —
  • 404 — Not Found
  • 429 — —

Every response is wrapped in { success, message, data }. A 4xx means the request is wrong — do not retry it unchanged. A 429 carries Retry-After in seconds.