Agents
Get an Agent session
Get an Agent session. The request enforces Agent roles, ownership, workspace boundaries, and lifecycle state.
GET
/
api
/
v1
/
agents
/
sessions
/
{agentSessionId}
Get an Agent session
curl --request GET \
--url https://api.revoengine.com/api/v1/agents/sessions/{agentSessionId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.revoengine.com/api/v1/agents/sessions/{agentSessionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/agents/sessions/{agentSessionId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"agentSessionId": "abababab-abab-4bab-8bab-abababababab",
"agentId": "99999999-9999-4999-8999-999999999999",
"checkpoint": {
"objective": "Prepare the release report.",
"completedWork": [
"Verified release evidence."
],
"decisions": [],
"openItems": [],
"nextSteps": [
"Compare with the previous month."
],
"artifacts": [],
"updatedAt": "2026-06-13T10:15:00.000Z"
},
"createdAt": "2026-06-13T10:00:00.000Z",
"lastUpdateAt": "2026-06-13T10:15:00.000Z",
"version": 2,
"rootAssistantThreadId": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
"currentRunId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"lastRunId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"
}Authorizations
Bearer JWT token or API Key (sk-*).
Path Parameters
Response
200 - application/json
Stable durable Agent session id.
Example:
"abababab-abab-4bab-8bab-abababababab"
Owning Agent id.
Example:
"99999999-9999-4999-8999-999999999999"
Bounded structured checkpoint automatically carried into successor runs.
Show child attributes
Show child attributes
Example:
{
"objective": "Prepare the release report.",
"completedWork": ["Verified release evidence."],
"decisions": [],
"openItems": [],
"nextSteps": ["Compare with the previous month."],
"artifacts": [],
"updatedAt": "2026-06-13T10:15:00.000Z"
}
Creation timestamp.
Example:
"2026-06-13T10:00:00.000Z"
Last update timestamp.
Example:
"2026-06-13T10:15:00.000Z"
Optimistic locking version.
Example:
2
Assistant thread shared by successor runs.
Example:
"cccccccc-cccc-4ccc-8ccc-cccccccccccc"
Current run in this session.
Example:
"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"
Most recently created run in this session.
Example:
"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"
⌘I
Get an Agent session
curl --request GET \
--url https://api.revoengine.com/api/v1/agents/sessions/{agentSessionId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.revoengine.com/api/v1/agents/sessions/{agentSessionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/agents/sessions/{agentSessionId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"agentSessionId": "abababab-abab-4bab-8bab-abababababab",
"agentId": "99999999-9999-4999-8999-999999999999",
"checkpoint": {
"objective": "Prepare the release report.",
"completedWork": [
"Verified release evidence."
],
"decisions": [],
"openItems": [],
"nextSteps": [
"Compare with the previous month."
],
"artifacts": [],
"updatedAt": "2026-06-13T10:15:00.000Z"
},
"createdAt": "2026-06-13T10:00:00.000Z",
"lastUpdateAt": "2026-06-13T10:15:00.000Z",
"version": 2,
"rootAssistantThreadId": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
"currentRunId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"lastRunId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"
}