List messages (PRIMARY data)

GET

/v1/sessions/{session_id}/messages

curl --request GET \
  --url https://app.everruns.com/api/v1/sessions/example/messages

• Production API

Parameters

Path Parameters

session_id

required

string

Session ID (prefixed, e.g., sess_…)

Responses

200

List of messages

Media type application/json

Response wrapper for list endpoints. All list endpoints return responses wrapped in a data field.

object

data

required

Array of items returned by the list operation.

Array<object>

Message - primary conversation data (API response)

object

content

required

Array of content parts

Array

One of:

object

Text content

object

text

required

string

type

required

string

Allowed values: text

object

Image content (base64 or URL)

object

base64

string | null

media_type

string | null

url

string | null

type

required

string

Allowed values: image

object

Image file content (reference to uploaded image by ID)

object

filename

Original filename (for display)

string | null

image_id

required

ID of the uploaded image (format: img_{32-hex})

string

type

required

string

Allowed values: image_file

object

Tool call content (assistant requesting tool execution)

object

arguments

required

id

required

string

name

required

string

type

required

string

Allowed values: tool_call

object

Tool result content (result of tool execution)

object

error

string | null

result

tool_call_id

required

ID of the tool call this result corresponds to

string

type

required

string

Allowed values: tool_result

controls

One of:

null

null

object

Runtime controls (model, reasoning, etc.)

object

error_disclosure

Error disclosure override for this turn: “generic”, “standard”, or “detailed”. Clamped to at most the mode allowed by the agent’s error_disclosure capability (capability absent => “standard”), so a client can narrow but never widen disclosure.

string | null

hints

Generic client hints — arbitrary key-value pairs declared by the client. Session-level defaults are set at session creation; per-message values override session hints key-by-key (shallow merge).

Examples: {"setup_connection": true, "rich_media": true}

object | null

locale

Locale override for this message turn (BCP 47, e.g. uk-UA). Overrides the session locale for backend-authored strings and prompts.

string | null

model_id

Model ID to use for this message (format: model_{32-hex}). Overrides session and agent model settings.

string | null

reasoning

One of:

null

null

object

Reasoning configuration

object

effort

Effort level for reasoning (low, medium, high)

string | null

created_at

required

Timestamp when this resource was created (RFC 3339).

string format: date-time

external_actor

One of:

null

null

object

External actor identity (for messages from external channels like Slack)

object

actor_id

required

Opaque actor identifier from the source channel (e.g. Slack user ID “U0123456789”)

string

actor_name

Resolved display name (e.g. “Alice”). Falls back to actor_id if absent.

string | null

metadata

Channel-specific metadata (e.g. team_id, channel_id)

object | null

source

required

Source channel identifier (e.g. “slack”, “discord”)

string

id

required

Unique message ID (format: message_{32-hex})

string

metadata

Message-level metadata (locale, etc.)

object | null

role

required

Message role in the conversation

string

Allowed values: system user agent tool_result

sequence

required

integer format: int32

session_id

required

Session ID this message belongs to (format: session_{32-hex})

string

Example

{
  "data": [
    {
      "content": [
        {
          "type": "text"
        }
      ],
      "controls": {
        "model_id": "model_01933b5a00007000800000000000001"
      },
      "id": "message_01933b5a00007000800000000000001",
      "role": "system",
      "session_id": "session_01933b5a00007000800000000000001"
    }
  ]
}

400

Invalid ID format

404

Session not found

500

Internal server error