listSessionEvents

GET

/api/v1/sessions/{sessionId}/events

Stored events after a cursor. For live updates use the stream.

listSessionEvents

curl --request GET \
  --url '<base-url>/api/v1/sessions/<sessionId>/events' \
  --cookie 'agenthold_session=<agenthold_session>'

const url = '<base-url>/api/v1/sessions/<sessionId>/events';
const options = {
  method: 'GET',
  headers: {cookie: 'agenthold_session=<agenthold_session>'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "<base-url>/api/v1/sessions/<sessionId>/events"

headers = {"cookie": "agenthold_session=<agenthold_session>"}

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

print(response.text)

Response example

[
  {
    "seq": 0,
    "at": "2019-08-24T14:15:22Z",
    "type": "prompt",
    "userId": "string",
    "data": {}
  }
]

{
  "error": "string"
}

Authorization

session
optional
API key in cookie

token
optional
HTTP Bearer
Authorization: Bearer <token>

Path parameters

sessionId
string
required

Query parameters

after
optional
integer
format: int64
limit
optional
integer
maximum: 5000 · minimum: 1

Returns

200

Events in order.

JSON

seq
integer
required
format: int64
at
string
required
format: date-time
type
string
·
one of 7 values
required
prompt: {text, user{id,name}}; update: an ACP SessionUpdate (discriminated by "sessionUpdate"); permission: {requestId, toolCall, options[{optionId,name,kind}], policy}; permission_resolved: {requestId, optionId, by}; turn_end: {stopReason}; error/notice: {message}.

Allowed values: prompt, update, permission, permission_resolved, turn_end, error, notice
data
object
required
userId
optional
string

404

Error.

JSON

error
string
required