Skip to main content
GET /v1/sessions/{session_id} Retrieves the full details of a single session by ID.

Path parameters

ParameterTypeDescription
session_idstringSession ID with the sess_ prefix

Headers

HeaderRequiredDescription
AuthorizationYesBearer $QODER_PAT

Example request

curl -X GET https://api.qoder.com/api/v1/cloud/sessions/sess_019e3bb1e8c171fd9abbb1477ffb84cc \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK Returns the full Session object (same structure as the create response).
{
  "id": "sess_019e3bb1e8c171fd9abbb1477ffb84cc",
  "type": "session",
  "agent_id": "agent_019e390add9f7bac9b6cc806db46fcbd",
  "agent": {
    "id": "agent_019e390add9f7bac9b6cc806db46fcbd",
    "type": "agent",
    "name": "test-agent-e2e",
    "model": "ultimate",
    "system": "You are a test assistant.",
    "tools": [],
    "mcp_servers": [],
    "skills": [],
    "metadata": {},
    "version": 2,
    "archived_at": null,
    "created_at": "2026-05-18T03:04:33.952256Z",
    "updated_at": "2026-05-18T03:05:28.023697Z"
  },
  "environment_id": "env_019e2590d33f711fabf42f2857cecd8a",
  "title": "API-doc-verification-session",
  "status": "idle",
  "turn_status": "idle",
  "metadata": {},
  "resources": [],
  "vault_ids": [],
  "memory_store_ids": [],
  "environment_variables": {},
  "stats": {
    "active_seconds": 0,
    "duration_seconds": 0
  },
  "archived_at": null,
  "created_at": "2026-05-18T15:26:15.747298Z",
  "updated_at": "2026-05-18T15:26:15.747298Z"
}

Response fields

The response has the same Session object shape as Create a session. The nested agent object is the snapshot used by this session and does not include legacy instructions or default_environment fields.

Errors

HTTPTypeTrigger
401authentication_errorPAT invalid or expired
404not_found_errorSession does not exist
See Errors for the full error envelope.

Start a session

Run an agent against an environment as a stateful conversation.