Ivy Biosciences Docs/Call the platform/API/Reference/Reference/Sessions/GET /v1/sessions/{sessionId}/transcript
GET /v1/sessions/{sessionId}/transcript
Export session transcript — Export a formatted transcript for a session.
Auth: required. Send an
ivy_ API key (Authorization: Bearer ivy_… or X-Ivy-Api-Key), a Clerk session JWT (Authorization: Bearer …) or the Clerk __session cookie (browser sessions). See Authentication.Export a formatted transcript for a session. Supports three output formats:
markdown(default) — human-readable with tool call summariesjson— structured event arraytext— plain text, no markup
Request
Path parameters
sessionIdstring (uuid)
Session UUID (UUIDv7 — time-ordered)
Query parameters
formatenum ("markdown" | "json" | "text")
Output format (default: markdown)
Responses
200 OK
Transcript exported
Response shape: object
401 Unauthorized
Authentication required
Response shape: object
404 Not Found
Resource not found
Response shape: object
Was this page helpful?
GET /v1/sessions/{sessionId}/workspace
Get a session's workspace — Returns the project, campaign and chat that a session you own is attached to. Any id that is not yet known is returned as null.
POST /v1/sessions
Create a session — Creates an empty session owned by the caller and returns its id. The body is optional: set a title or a provider, model and tool config.