Get a Composer Session
The session’s current preview and its conversation, newest first. Use it to pick a session back up, or to show someone how the agent was designed.
agent is the current preview — the same body POST /agents accepts verbatim, reflecting every refinement so far.
Paging the conversation
messages is newest first. When there is an older page, nextCursor is present; pass it back as cursor to continue.
nextCursor means you have reached the beginning of the conversation.
Scope and lifetime
Requires theagents read scope. An unknown session, an expired one, and one belonging to another company are all a 404.
Sessions live 30 days; expiresAt says when this one goes. Once you create the agent, the conversation moves with it and is no longer read here — it is part of the agent.Authorizations
API key for authentication using Bearer scheme
Path Parameters
The composer session id returned by POST /agents/composer.
Query Parameters
Opaque cursor from a previous page's nextCursor.
Required for ATS API keys to specify which company to access. Ignored for standard company API keys.
Response
The session, its current preview and a page of the conversation.
The agent the composer would build. There is no id: this agent does not exist yet. Post this object to POST /agents to create it — it is accepted verbatim, with no ids or schemaVersion to strip first.
The conversation so far, newest first.
Pass as cursor to fetch the next (older) page. Absent at the start of the conversation.