Get agent status and recent history

Returns the current state, lifecycle metadata, and recent conversation history for a REST-created agent run.

GET /api/public/v1/agents/{agentId}

Bearer token

curl 'https://api.buildprint.ai/api/public/v1/agents/agent_01JXY9AZK4KV?historyLimit=100' \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "agentId": "agent_01JXY9AZK4KV",
  "kind": "agent",
  "status": "queued",
  "appId": "app_01JXY9AZK4KV",
  "projectId": "project_01JXY9AZK4KV",
  "projectName": "example",
  "reviewId": "review_01JXY9AZK4KV",
  "model": "claude-opus-4.6",
  "reasoningEffort": "example",
  "permission": "read_only",
  "permittedBranches": [
    "example"
  ],
  "createdAt": 1,
  "updatedAt": 1,
  "completedAt": 1,
  "lastError": "example",
  "history": [
    {
      "id": "id_01JXY9AZK4KV",
      "sequence": 1,
      "role": "user",
      "content": "example",
      "toolName": "example",
      "toolParameters": "example",
      "attachments": [
        {}
      ],
      "createdAt": 1
    }
  ],
  "lifecycle": {
    "conversationState": "draft",
    "sandboxState": "none",
    "queuedTurnCount": 1,
    "lastLifecycleEventAt": 1
  }
}

Agent found

Path parameters

· 1

agentId string required

Identifier of the agent conversation to retrieve.

Query parameters

· 1

historyLimit integer · min: 1· max: 500· default: 100

Maximum number of recent history items to return. Defaults to 100 and caps at 500.

Path parameters

Query parameters

Responses