List turns

GET /v1/sessions/{session_id}/turns

Permission: read:sessions
Tokens: API key, CLI user token, Session token

Read every turn and message of a session, oldest first. A turn is pending until the agent starts on it, running while it works, then completed, failed, stopped, or cancelled.

Path parameters

session_idstringrequired

{

}

import os

from ellipsis import Ellipsis

client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])

result = client.sessions.turns.list("session_example")
print(result)

import { Ellipsis } from '@ellipsis-dev/sdk';

const client = new Ellipsis({
  apiKey: process.env.ELLIPSIS_API_TOKEN!,
});

const result = await client.sessions.turns.list("session_example");
console.log(result);

curl "https://api.ellipsis.dev/v1/sessions/{session_id}/turns" \
  -H "Authorization: Bearer $ELLIPSIS_API_TOKEN"

Response

messagesarray<SessionMessage>required

Every message, delivered and pending, oldest first.

turnsarray<SessionTurn>required

Every turn, ordered by index.

Path parameters

Response

On this page