Levain LabsLevain Labs
ApiSessions

Create Session

Create a session for an agent.

Create a session for an agent.

Does not dispatch anything — the session is empty until a message is posted via POST /sessions/{id}/messages.

Provide agent_version_id for agents you designed; omit it for managed agents.

POST
/api/v1/sessions/

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Header Parameters

X-API-Key?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://api.levainlabs.com/api/v1/sessions/" \  -H "Content-Type: application/json" \  -d '{    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978"  }'
{
  "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": {}
    }
  ]
}