Levain LabsLevain Labs
ApiSessions

Request Session Review

Run a verification pass on an agent-builder conversation.

Run a verification pass on an agent-builder conversation.

Dispatches a background turn that validates the draft version (recipe checks plus a code review, fixing what it can) and records the verdict the publish action reads. Verification normally runs automatically after each build turn — use this to re-run it manually. The pass carries no conversation message; watch its progress via the session's rounds.

Only valid on a conversation with the agent builder whose version is still a draft. Returns 409 when the version is already published or a turn is running or queued.

POST
/api/v1/sessions/{session_id}/review

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

session_id*Session Id
Formatuuid

Header Parameters

X-API-Key?string|null

Response Body

application/json

application/json

curl -X POST "https://api.levainlabs.com/api/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/review"
{
  "id": "string",
  "agent_id": "string",
  "agent_version_id": "string",
  "state": "string",
  "title": "string",
  "kind": "agent",
  "first_prompt": "string",
  "origin": "slack",
  "origin_provider": "string",
  "origin_provider_display": "string",
  "has_artifacts": true,
  "archived_at": "string",
  "created_at": "string",
  "last_activity_at": "string",
  "terminated_at": "string",
  "rounds": [],
  "events": [],
  "steered": true,
  "dispatched_run_id": "string"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}