IronStratum

GET /v1/conversations/{id}

Conversation detail with turns and cost

The conversation's turns in exchange order plus the cost summary itemized from its linked usage_events rows. Key-scoped: missing, deleted, and foreign ids are indistinguishable 404s.

Parameters

Parameters for retrieveConversation
Field Type Required Description
id string yes Path

Request

No request body.

Responses

200 The conversation with turns + cost summary.

200 response fields for retrieveConversation
Field Type Required Description
id string no The conversation id clients pass as session_id.
model_alias string no —
created_at string no —
last_active_at string no —
turn_count integer no —
turns array of object no —
cost object no —

401 401

401 response fields for retrieveConversation
Field Type Required Description
error object yes —

404 404

404 response fields for retrieveConversation
Field Type Required Description
error object yes —

Example

curl https://api.ironstratum.com/v1/conversations/<id> \
  -H "Authorization: Bearer $IRONSTRATUM_API_KEY"

All operations · interactive reference · openapi.yaml