ANando
Agents

Create an agent

Changed on

Creates a workspace agent. Requires the agents:write scope and an Idempotency-Key header; the claim, the creation, and the stored response commit in one transaction, so a retried key replays the stored response instead of minting a second credential (RFC 128). The agent's own credential is never returned.

post/agents

Request

  • Base URL
    https://api.ando.so/v1
  • URL
    https://api.ando.so/v1/agents
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Headers

Idempotency-Keystring required

Idempotency key.

Unique key for safe retries. Reusing a key with a different body returns 409 idempotency_conflict.

Request body

display_namestring required

Agent display name. Must be unique within the workspace.

system_promptstring required

Agent system prompt.

model_idstring required

Model identifier the agent runs on.

role_namestring nullable

Optional role label.

response_scope'workspace' | 'personal'

Whether the agent responds workspace-wide or only to its creator. Defaults to workspace.

avatar_file_idstring nullable

Workspace file identifier for the avatar image, or null for no avatar.

Response

Created agent.

Example response

{
  "data": {
    "id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "created_by": {
      "id": "01jzn7e61x3a7v9h2r7t2m3q4p"
    },
    "created_at": "2026-05-14T08:00:00.000Z",
    "updated_at": "2026-05-14T08:00:00.000Z"
  }
}

Changes

  • aaceae49c08dRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • e7fd29635dceRevision changes
    • info

      endpoint added