Skip to content
Docs

A conversation

GET
/api/workspaces/{ws}/assistant/conversations/{id}

Its messages in order: yours, the assistant's (with its tool calls), each tool's compact answer and things you did in a card (event). cards are what the app shows inline: choices, connect, hire, confirm and step.

Authorization

session
cookiebetter-auth.session_token<token>

Set by POST /api/auth/sign-in/email.

Path Parameters

ws*string

The workspace id (from GET /api/me).

id*string

The id of what the path names: a hire, a connection, a skill, a shared file, a department, a position, a goal or an approval.

Response Body

The conversation and its messages.

Example Request
curl -X GET 'https://app.useroster.work/api/workspaces/string/assistant/conversations/string'
Example Response
Empty