Sessions
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
{
}
1
import os
2
3
from ellipsis import Ellipsis
4
5
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
6
7
result = client.sessions.turns.list("session_example")
8
print(result)
1
import { Ellipsis } from '@ellipsis-dev/sdk';
2
3
const client = new Ellipsis({
4
apiKey: process.env.ELLIPSIS_API_TOKEN!,
5
});
6
7
const result = await client.sessions.turns.list("session_example");
8
console.log(result);
1
curl "https://api.ellipsis.dev/v1/sessions/{session_id}/turns" \
2
-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.