API referenceEndpoints

Read agent setup and live job readiness

Requires an authenticated user JWT. Generated from the production route registered in `internal/features/agents/inbound/setup.go`. Owner-only. Each job checks shared and job-specific answers, current tool grants/policy/availability and knowledge access. Failed checks remain unavailable. The role document is returned for trusted application adapters; clients can expose only the visible questions, choices and job summaries.

GET/v1/agents/{id}/setup

Requires an authenticated user JWT. Generated from the production route registered in internal/features/agents/inbound/setup.go. Owner-only. Each job checks shared and job-specific answers, current tool grants/policy/availability and knowledge access. Failed checks remain unavailable. The role document is returned for trusted application adapters; clients can expose only the visible questions, choices and job summaries.

Authorization

bearerAuth
AuthorizationBearer <token>

Engine-issued API key or tenant-signed JWT.

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/setup"
{  "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",  "revision": 0,  "answers": {    "property1": "string",    "property2": "string"  },  "preferences": {    "property1": "string",    "property2": "string"  },  "conversation_id": "cc71b11a-25cd-4c2d-9950-df2cc38e3407",  "role": {    "role_id": "string",    "edition": 1,    "name": "string",    "description": "string",    "expertise": "string",    "setup_instructions": "string",    "requirements": [      {        "key": "string",        "kind": "answer",        "label": "string",        "prompt": "string",        "shared": true,        "tool": "string"      }    ],    "preferences": [      {        "key": "string",        "label": "string",        "kind": "text",        "options": [          "string"        ],        "max_length": 1      }    ],    "setup_required": true,    "blinq_id": "163ce100-8211-4522-93e1-e382b5984dbb",    "blinq_version": 1,    "presentation": {      "color": "string",      "avatar": "string",      "availability": "available"    },    "executor_mode": "internal",    "core_workflow": [],    "jobs": []  },  "shared_ready": true,  "requirements": [    {      "key": "string",      "kind": "answer",      "label": "string",      "prompt": "string",      "shared": true,      "tool": "string",      "status": "ready",      "reason": "string"    }  ],  "jobs": [    {      "id": "string",      "name": "string",      "ready": true,      "missing": [        "string"      ]    }  ]}