Get Session

curl "https://api.wordsmith.ai/api/v1/sessions/6d02931b-eaa1-4c77-b711-66038eb1bb2b" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

{
  "id": "6d02931b-eaa1-4c77-b711-66038eb1bb2b",
  "agent_id": "3135e518-9205-4887-9ab1-1d56dd38eafb",
  "title": "Liability cap in the supply agreement",
  "message_count": 4,
  "url": "https://app.wordsmith.ai/chat/6d02931b-eaa1-4c77-b711-66038eb1bb2b",
  "created_at": "2026-10-13T14:02:11Z",
  "updated_at": "2026-10-13T14:09:47Z"
}

GET

api

sessions

{session_id}

curl "https://api.wordsmith.ai/api/v1/sessions/6d02931b-eaa1-4c77-b711-66038eb1bb2b" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

{
  "id": "6d02931b-eaa1-4c77-b711-66038eb1bb2b",
  "agent_id": "3135e518-9205-4887-9ab1-1d56dd38eafb",
  "title": "Liability cap in the supply agreement",
  "message_count": 4,
  "url": "https://app.wordsmith.ai/chat/6d02931b-eaa1-4c77-b711-66038eb1bb2b",
  "created_at": "2026-10-13T14:02:11Z",
  "updated_at": "2026-10-13T14:09:47Z"
}

Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.

Returns one session: its agent, title, message count and a link that opens it in Wordsmith. Read its messages with List Messages. The session_id is the same id that Create Question returns. You can read any session you could open in the Wordsmith app, including one shared with you.

Authentication

Requires an API key, or an OAuth token with sessions:read.

Path parameters

string

required

The session id.

Response

Returns 200 with the session: the fields of a List Sessions item, plus message_count.

integer

The number of messages List Messages returns: each question and each answer counts as one.

curl "https://api.wordsmith.ai/api/v1/sessions/6d02931b-eaa1-4c77-b711-66038eb1bb2b" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

{
  "id": "6d02931b-eaa1-4c77-b711-66038eb1bb2b",
  "agent_id": "3135e518-9205-4887-9ab1-1d56dd38eafb",
  "title": "Liability cap in the supply agreement",
  "message_count": 4,
  "url": "https://app.wordsmith.ai/chat/6d02931b-eaa1-4c77-b711-66038eb1bb2b",
  "created_at": "2026-10-13T14:02:11Z",
  "updated_at": "2026-10-13T14:09:47Z"
}

Errors

Status	`error_code`	When
404	`resource_not_found`	No session with this id, or the caller cannot read it.

Preview

Agents, playbooks and blueprints

Sessions

Playbook authoring

Drafts

Files

Document actions

Operations

Research

Reports

Reviews

Organisation

Sharing

Usage and value

Repositories and search

Authentication

Path parameters

Response

Errors

​Authentication

​Path parameters

​Response

​Errors

Authentication

Path parameters

Response

Errors