Read one older page of an agent's turn history
Cursor (keyset) pagination over the stable (created_at, id) session
ordering, walking BACKWARDS from newest to oldest. Offsets are not
supported on purpose: a turn arriving mid-scroll shifts every offset
by one, so consecutive offset pages both duplicate and drop rows.
The page unit is the session row, not the turn. A session bundles its
markers and events, so a turn is never split across a page boundary;
the turn count per page is therefore normally limit but can exceed
it for older rows carrying several markers.
Omitting cursor returns the newest page. turns is oldest-first,
so a client prepends the array verbatim. nextCursor is null once
history is exhausted.
curl --request GET \
--url https://api.lusor.ai/v1/agents/{id}/turns \
--header 'X-Api-Key: <api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.lusor.ai/v1/agents/{id}/turns', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.lusor.ai/v1/agents/{id}/turns"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"turns": [
{
"id": "<string>",
"sessionId": "<string>",
"prompt": "<string>",
"status": "<string>",
"deviceId": "<string>",
"summary": "<string>",
"recording": true,
"queued": true,
"createdAt": "2023-11-07T05:31:56Z",
"startedAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z"
}
],
"nextCursor": "<string>",
"hasMore": true
}
}{
"error": "validation_error",
"details": {}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Authorizations
Workspace API key, created in the dashboard under Settings → API Keys.
Path Parameters
Agent UUID. Missing, inaccessible, and malformed IDs return an opaque 404.
Query Parameters
Workspace the request is scoped to. Optional for API keys: a key is bound to one workspace when it is created, and naming any other workspace returns an opaque 404.
Opaque anchor from the previous page, or turnsCursor from the agent detail.
512Sessions per page. Defaults to 20.
1 <= x <= 100Response
One page of history, oldest-first
Show child attributes
Show child attributes
Was this page helpful?
curl --request GET \
--url https://api.lusor.ai/v1/agents/{id}/turns \
--header 'X-Api-Key: <api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.lusor.ai/v1/agents/{id}/turns', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.lusor.ai/v1/agents/{id}/turns"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"turns": [
{
"id": "<string>",
"sessionId": "<string>",
"prompt": "<string>",
"status": "<string>",
"deviceId": "<string>",
"summary": "<string>",
"recording": true,
"queued": true,
"createdAt": "2023-11-07T05:31:56Z",
"startedAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z"
}
],
"nextCursor": "<string>",
"hasMore": true
}
}{
"error": "validation_error",
"details": {}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}