Conversations

List conversation messages

Returns the complete message history for the specified conversation thread, ordered chronologically. Each message includes its role, content, and metadata.

get/conversations/{conversation_id}/messages

Request

Base URL: https://console.hyperstack.cloud/ai/api/v1
URL: https://console.hyperstack.cloud/ai/api/v1/conversations/{conversation_id}/messages
Auth: API key in header api_key

Path parameters

conversation_idinteger required

Unique identifier of the conversation whose messages to retrieve. Use the id from List conversations.

Response

Example response

{
  "messages": [
    {
      "content": "What is in this image?",
      "image_attachment": {
        "file_reference": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "url": "https://your-bucket.s3.amazonaws.com/<file_reference>?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=..."
      },
      "role": "user"
    }
  ],
  "usage": {
    "completion_tokens": 159,
    "completion_tokens_details": {
      "accepted_prediction_tokens": 0,
      "audio_tokens": 0,
      "image_tokens": 0,
      "reasoning_tokens": 0,
      "rejected_prediction_tokens": 0,
      "text_tokens": 159,
      "video_tokens": 0
    },
    "prompt_tokens": 93,
    "prompt_tokens_details": {
      "audio_tokens": 0,
      "cache_creation_input_tokens": 0,
      "cache_read_input_tokens": 0,
      "cached_tokens": 0,
      "image_tokens": 79,
      "text_tokens": 14,
      "video_tokens": 0
    },
    "total_tokens": 252
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.