Agent Sessions
List ai-agent monitor sessions for this workspace. Newest first, capped at 50.
API key for authentication, must be provided as a Bearer token. Generate an API key at https://alien.dev/api-keys
In: header
Query Parameters
Workspace name. Required for user/session/OAuth requests. Optional for API keys because API keys are workspace-scoped; if provided with an API key, it must match the key's workspace.
^(?!ws[-_])[a-z0-9](-?[a-z0-9])*$4 <= length <= 100Response Body
application/json
curl -X GET "https://example.com/v1/agent-sessions"{ "sessions": [ { "id": "string", "triggerType": "string", "subjectId": "string", "subject": { "deploymentName": "string", "deploymentGroupId": "string", "deploymentGroupName": "string", "releaseId": "string", "releaseCommitMessage": "string", "releaseCommitRef": "string", "projectId": "string", "projectName": "string" }, "status": "string", "createdAt": "string", "updatedAt": "string" } ]}Retrieve one ai-agent monitor session by id.
API key for authentication, must be provided as a Bearer token. Generate an API key at https://alien.dev/api-keys
In: header
Path Parameters
Query Parameters
Workspace name. Required for user/session/OAuth requests. Optional for API keys because API keys are workspace-scoped; if provided with an API key, it must match the key's workspace.
^(?!ws[-_])[a-z0-9](-?[a-z0-9])*$4 <= length <= 100Response Body
application/json
application/json
curl -X GET "https://example.com/v1/agent-sessions/string"{ "id": "string", "triggerType": "string", "subjectId": "string", "subject": { "deploymentName": "string", "deploymentGroupId": "string", "deploymentGroupName": "string", "releaseId": "string", "releaseCommitMessage": "string", "releaseCommitRef": "string", "projectId": "string", "projectName": "string" }, "status": "string", "createdAt": "string", "updatedAt": "string", "resultText": "string", "toolNames": [ "string" ], "error": "string", "pendingApproval": { "approvalId": "string", "toolCallId": "string", "toolName": "string", "input": null }}Incrementally read a session's event log (steps, tool calls, report deltas, approvals, status transitions). Pass the previous response's latestSeq as after to fetch only new events.
API key for authentication, must be provided as a Bearer token. Generate an API key at https://alien.dev/api-keys
In: header
Path Parameters
Query Parameters
Workspace name. Required for user/session/OAuth requests. Optional for API keys because API keys are workspace-scoped; if provided with an API key, it must match the key's workspace.
^(?!ws[-_])[a-z0-9](-?[a-z0-9])*$4 <= length <= 1000 <= value01 <= value <= 500200Response Body
application/json
application/json
curl -X GET "https://example.com/v1/agent-sessions/string/events"{ "events": [ { "seq": 0, "createdAt": "string", "type": "status", "payload": { "status": "string", "error": "string" } } ], "latestSeq": 0, "hasMore": true}Approve a halted ai-agent monitor session. Proxies to the ai-agent service, minting a fresh CLI session for the caller so the ai-agent's own auth applies.
API key for authentication, must be provided as a Bearer token. Generate an API key at https://alien.dev/api-keys
In: header
Path Parameters
Query Parameters
Workspace name. Required for user/session/OAuth requests. Optional for API keys because API keys are workspace-scoped; if provided with an API key, it must match the key's workspace.
^(?!ws[-_])[a-z0-9](-?[a-z0-9])*$4 <= length <= 100Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/agent-sessions/string/approve"{ "jobId": "string", "status": "string", "resumed": true}Stop (cancel) a running, queued, or halted ai-agent monitor session. Proxies to the ai-agent service, minting a fresh CLI session for the caller so the ai-agent's own auth applies. Idempotent — stopping an already-terminal session is a 200 no-op.
API key for authentication, must be provided as a Bearer token. Generate an API key at https://alien.dev/api-keys
In: header
Path Parameters
Query Parameters
Workspace name. Required for user/session/OAuth requests. Optional for API keys because API keys are workspace-scoped; if provided with an API key, it must match the key's workspace.
^(?!ws[-_])[a-z0-9](-?[a-z0-9])*$4 <= length <= 100Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/agent-sessions/string/stop"{ "jobId": "string", "status": "string", "canceled": true}