Read an agent session
curl --request GET \
--url https://api.video2ctx.dev/v1/agent/sessions/{sessionId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.video2ctx.dev/v1/agent/sessions/{sessionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.video2ctx.dev/v1/agent/sessions/{sessionId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"latestMessagePreview": "<string>",
"lastRunId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runCount": 2,
"createdAt": 1,
"updatedAt": 1,
"messages": [
{
"messageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conversationTurn": 2,
"parentMessageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"role": "user",
"status": "pending",
"content": "<string>",
"createdAt": 1,
"updatedAt": 1
}
],
"nextCursor": "<string>"
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}Agents
Read an agent session
Returns the authenticated user’s session metadata and a chronological page of user and assistant messages. The first page contains the newest turns, ordered oldest to newest within the page. Use nextCursor to load older turns. Tool calls, evidence packets, and internal events are not included.
GET
/
v1
/
agent
/
sessions
/
{sessionId}
Read an agent session
curl --request GET \
--url https://api.video2ctx.dev/v1/agent/sessions/{sessionId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.video2ctx.dev/v1/agent/sessions/{sessionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.video2ctx.dev/v1/agent/sessions/{sessionId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"latestMessagePreview": "<string>",
"lastRunId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runCount": 2,
"createdAt": 1,
"updatedAt": 1,
"messages": [
{
"messageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conversationTurn": 2,
"parentMessageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"role": "user",
"status": "pending",
"content": "<string>",
"createdAt": 1,
"updatedAt": 1
}
],
"nextCursor": "<string>"
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}{
"error": {
"code": "QUERY_REQUIRED",
"message": "<string>",
"details": "<unknown>",
"requestId": "<string>"
}
}Authorizations
bearerApiKeysessionCookiecliSessionapiKeydemoUser
Permanent personal API key created in the dashboard. Example: curl -H "Authorization: Bearer aty_…" https://your-host/v1/projects
Path Parameters
Session UUID returned by agent admission.
Minimum string length:
1Query Parameters
Maximum turns to return. Each turn produces one user message and one assistant message.
Required range:
1 <= x <= 100Opaque cursor for loading turns older than the current page.
Maximum string length:
500Response
The restored agent session.
Maximum string length:
80Maximum string length:
240Required range:
x >= 1Unix timestamp in milliseconds.
Required range:
x >= 0Unix timestamp in milliseconds.
Required range:
x >= 0Maximum array length:
200Show child attributes
Show child attributes