Skip to main content
GET
/
api
/
v1
/
sessions
List sessions
curl --request GET \
  --url https://api.agenhq.com/api/v1/sessions \
  --header 'x-api-key: <api-key>'
{
  "items": [
    {
      "id": "<string>",
      "title": "<string>",
      "workspace_id": "<string>",
      "user_id": "<string>",
      "branch_name": "<string>",
      "auto_commit": false,
      "status": "<string>",
      "origin": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "sandbox_id": "<string>",
      "model": "<string>",
      "agent_status": "<string>",
      "merged_at": "<string>",
      "deep_work_id": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.agenhq.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
status
string

Filter sessions by lifecycle status.

​
user_id
string

Filter sessions to those created by a specific user.

​
include
string

Include additional computed fields in each session item, for example mr_pipeline_summary.

Response

Default Response

​
items
object[]
required
​
next_cursor
string | null
required