Messages API

Retrieve a message

Changed on

Returns the current status of a queued message. Completed responses include the Anthropic message fields. Use this operation with the X-Sail-Message-Id returned after a non-streaming timeout. Results can expire 10 minutes after first successful delivery.

get/messages/{messageID}

Request

  • Base URL
    https://api.sailresearch.com/v1
  • URL
    https://api.sailresearch.com/v1/messages/{messageID}
  • Auth
    • HTTP bearer
    • or API key in header x-api-key

Path parameters

messageIDstring required

Message ID returned by POST /v1/messages or X-Sail-Message-Id.

Response

Current message status or completed message output.

idstring required
type'message' required
status'queued' | 'in_progress' | 'completed' | 'failed' | 'cancelled' required
role'assistant'
modelstring
stop_reason'end_turn' | 'max_tokens' | 'tool_use' | 'stop_sequence' | 'refusal' | 'model_context_window_exceeded'
stop_sequencestring nullable
service_tier'asap' | 'balanced' | 'flex'

The completion window Sail selected for this request, including when no window was requested. The legacy request value standard is reported as balanced. Older stored responses may omit this field.

Changes