Retrieve messages from a conversation, ordered chronologically from oldest to newest. Supports pagination and filtering by role or status. Only the conversation owner can access their messages.

GET
/conversations/{conversationId}/messages

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

conversationIdstring

The unique identifier of the conversation to retrieve messages from

Formatuuid

Query Parameters

limit?integer

Maximum number of messages to return (default: all messages, max: 1000)

Range1 <= value <= 1000
offset?integer|null

Number of messages to skip for pagination (default: 0)

Range0 <= value
role?string

Filter messages by role (user, assistant, or human_agent)

Value in"user" | "assistant" | "human_agent"
status?string

Filter messages by status (complete, streaming, or error)

Value in"complete" | "streaming" | "error"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.siteassist.io/v2/conversations/123e4567-e89b-12d3-a456-426614174000/messages?limit=50&offset=0&role=assistant&status=complete"
{
  "object": "list",
  "data": [
    {
      "object": "message",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "createdAt": "string",
      "chatId": "f255124e-3419-4f6e-b7ee-17a6577db94d",
      "role": "assistant",
      "parts": [
        {
          "type": "text",
          "text": "Hello, world!"
        }
      ],
      "status": "streaming",
      "error": "string",
      "feedback": "like",
      "feedbackAt": "string",
      "metadata": "string",
      "humanAgent": null,
      "pageUrl": "string",
      "pageTitle": "string",
      "textSelection": "string"
    }
  ]
}
{
  "error": {
    "message": "Invalid request body. Content is required.",
    "code": "INVALID_REQUEST_BODY",
    "details": {
      "field": "content"
    }
  }
}
{
  "error": {
    "message": "Authentication required",
    "code": "UNAUTHORIZED"
  }
}
{
  "error": {
    "message": "A higher pricing plan is required to access this feature",
    "code": "PAYMENT_REQUIRED",
    "details": {
      "currentPlan": "free",
      "requiredPlan": "pro",
      "feature": "advanced_ai_models"
    }
  }
}
{
  "error": {
    "message": "Access denied to this conversation",
    "code": "FORBIDDEN"
  }
}
{
  "error": {
    "message": "Conversation not found!",
    "code": "CONVERSATION_NOT_FOUND",
    "details": {
      "conversationId": "123e4567-e89b-12d3-a456-426614174000"
    }
  }
}
{
  "error": {
    "message": "Resource already exists",
    "code": "CONFLICT",
    "details": {
      "resource": "conversation",
      "conflictingField": "id"
    }
  }
}
{
  "error": {
    "message": "Validation failed",
    "code": "VALIDATION_ERROR",
    "details": {
      "field": "content",
      "reason": "Content exceeds maximum length of 10000 characters"
    }
  }
}
{
  "error": {
    "message": "Rate limit exceeded. Please try again later.",
    "code": "RATE_LIMIT_EXCEEDED",
    "details": {
      "retryAfter": 60
    }
  }
}
{
  "error": {
    "message": "An internal server error occurred",
    "code": "INTERNAL_SERVER_ERROR"
  }
}
{
  "error": {
    "message": "Service temporarily unavailable",
    "code": "BAD_GATEWAY",
    "details": {
      "service": "ai_model_service"
    }
  }
}
{
  "error": {
    "message": "Service temporarily unavailable",
    "code": "SERVICE_UNAVAILABLE",
    "details": {
      "retryAfter": 30
    }
  }
}