Agents

List session events

Returns the session’s events in sequence order, after cursor. The cursor is an event’s sequence: pass a page’s next_cursor, or a session’s last_sequence to get only what happens next.

To follow the session live, send Accept: text/event-stream. The stream sends the following:

A session.status event, without an id, whose data is the Session.
Every event after the cursor, with id set to its sequence and event set to its type.
New events as they happen, and message.delta events with partial agent text. A message.delta event has no id, and its data is {turn_id, text}. The log doesn’t store it.
A heartbeat comment every 15 seconds.

The server closes the stream within 10 minutes. To resume, reconnect with Last-Event-ID.

GET

api

apps

{id}

sessions

{session_id}

events

List session events

curl --request GET \
  --url https://api.judt.ai/api/apps/{id}/sessions/{session_id}/events \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.judt.ai/api/apps/{id}/sessions/{session_id}/events"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.judt.ai/api/apps/{id}/sessions/{session_id}/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.judt.ai/api/apps/{id}/sessions/{session_id}/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.judt.ai/api/apps/{id}/sessions/{session_id}/events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.judt.ai/api/apps/{id}/sessions/{session_id}/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "sequence": 12,
      "turn_id": "<string>",
      "created_at": "2026-10-03T14:01:30.000Z",
      "type": "message",
      "role": "user",
      "text": "<string>"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

Authorizations

Authorization

string

header

required

An API token for one organization. You create and revoke tokens in the dashboard. A token scoped to one App can reach only that App, so give that kind of token to an agent. An organization-wide token can create a short-lived one with POST /api/tokens.

Headers

Last-Event-ID

integer

For streams, the sequence of the last event that you received. The stream resumes after it, and the header takes precedence over cursor.

Required range: x >= 0

Path Parameters

string

required

A unique ID that starts with app_.

Pattern: ^app_[0-9A-Za-z]{24}$

Example:

"app_Zj7XhMgplmTJcp5Dk4vcYuk0"

session_id

string

required

A unique ID that starts with ses_.

Pattern: ^ses_[0-9A-Za-z]{24}$

Example:

"ses_Zj7XhMgplmTJcp5Dk4vcYuk0"

Query Parameters

cursor

integer

default:0

Returns only events whose sequence is greater than this value.

Required range: x >= 0

limit

integer

default:100

The maximum number of events to return. Applies only to JSON responses.

Required range: 1 <= x <= 1000

Response

One page of events, or the live stream.

results

required

The results in this page.

A message from the user or the agent.

Show child attributes

has_more

boolean

required

True if more results follow this page; false otherwise.

next_cursor

string | null

required

Where the next page starts: to get it, list again with this value as cursor. A cursor from the last page later finds results added after it. Null if the list is empty.

List session events

curl --request GET \
  --url https://api.judt.ai/api/apps/{id}/sessions/{session_id}/events \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.judt.ai/api/apps/{id}/sessions/{session_id}/events"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.judt.ai/api/apps/{id}/sessions/{session_id}/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.judt.ai/api/apps/{id}/sessions/{session_id}/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.judt.ai/api/apps/{id}/sessions/{session_id}/events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.judt.ai/api/apps/{id}/sessions/{session_id}/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "sequence": 12,
      "turn_id": "<string>",
      "created_at": "2026-10-03T14:01:30.000Z",
      "type": "message",
      "role": "user",
      "text": "<string>"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

Overview

Account

Apps

Tokens

Secrets

Files

Sandbox

Deployments

Monitoring

Templates

Agents

Feedback

List session events

Authorizations

Headers

Path Parameters

Query Parameters

Response