Polyrankdocs
ApiLab

GET /v1/lab/agent/conversations/{id}

One of the caller’s assistant conversations: its status and the readable transcript (the caller’s messages, the assistant’s answers with any notice, which tools each step used, the result cards of those steps, and each answer’s share of today’s allowance). The truth for clients that do not stream; GET …/:id/events streams a turn live. 404 `lab_agent_disabled` while LAB_AGENT_ENABLED is off.

GET
/v1/lab/agent/conversations/{id}

One of the caller’s assistant conversations: its status and the readable transcript (the caller’s messages, the assistant’s answers with any notice, which tools each step used, the result cards of those steps, and each answer’s share of today’s allowance). The truth for clients that do not stream; GET …/:id/events streams a turn live. 404 lab_agent_disabled while LAB_AGENT_ENABLED is off.

AuthorizationBearer <token>

API key: Authorization: Bearer pk_live_… (mint at polyrank.app/api-keys)

In: header

Path Parameters

id*string

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/lab/agent/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "conversation": {    "id": "string",    "title": "string",    "status": "idle",    "error": "string",    "model": "string",    "created_at": "string",    "updated_at": "string"  },  "messages": [    {      "id": "string",      "role": "user",      "text": "string",      "notice": "string",      "tools": [        "string"      ],      "cards": [        {          "kind": "wallet_shortlist",          "v": 1,          "id": "string",          "title": "string",          "as_of": "string",          "window": {            "from": "string",            "to": "string"          },          "ranked_on": "string",          "wallets_ranked": -9007199254740991,          "in_sample": true,          "simulated": true,          "wallets": [            {              "rank": -9007199254740991,              "wallet": "string",              "copies": -9007199254740991,              "per10": 0,              "t": 0,              "fill_rate": 0,              "active_days": -9007199254740991,              "positions": -9007199254740991,              "win_rate": 0,              "categories": [                "string"              ],              "stands_out": true,              "username": "string"            }          ],          "picked": [],          "note": "string"        }      ],      "turn_pct_of_budget": 0,      "created_at": "string"    }  ]}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "issues": [    null  ],  "trace_id": "string"}