Get Messages

Retrieve conversation history for a session.

string

required

The session ID

Query Parameters

integer

Maximum number of messages to return (default: 50)

integer

Number of messages to skip (default: 0)

curl -X GET "https://api.artaios.ai/api/v1/runtime/session_abc123/messages/?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.artaios.ai/api/v1/runtime/session_abc123/messages/",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"limit": 10}
)
messages = response.json()

const response = await fetch('https://api.artaios.ai/api/v1/runtime/session_abc123/messages/?limit=10', {
  headers: {
    'x-api-key': 'YOUR_API_KEY'
  }
});
const messages = await response.json();

Response

Returns an array of message objects:

{
  "messages": [
    {
      "id": "msg_001",
      "role": "user",
      "content": "Hello, I need help with my account.",
      "timestamp": "2025-01-15T10:30:00Z"
    },
    {
      "id": "msg_002", 
      "role": "assistant",
      "content": "I'd be happy to help you with your account. What specific issue are you experiencing?",
      "timestamp": "2025-01-15T10:30:05Z"
    }
  ],
  "total": 2,
  "has_more": false
}

Execute Message Session Status

API Overview

Agents

Sessions

Runtime

Files

Collections

Knowledge Bases

Images

Query Parameters

Response

​Query Parameters

​Response

Query Parameters

Response