Skip to main content
GET
/
v1
/
sessions
List sessions
curl --request GET \
  --url https://api.traversal.com/v1/sessions \
  --header 'Authorization: Bearer <token>'
{
  "sessions": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "running",
      "input": "Our checkout service started returning 500 errors at 2024-03-15T14:30:00Z. Error rate jumped from 0.1% to 15%.",
      "created_at": "2024-03-15T14:35:00Z",
      "title": "Elevated error rate in checkout service",
      "updated_at": "2024-03-15T14:38:12Z",
      "messages": [
        {
          "id": "msg-001-uuid",
          "role": "user",
          "markdown_content": "## Investigation Summary\n\nI investigated the elevated error rate...",
          "created_at": "2024-03-15T14:38:12Z"
        }
      ]
    }
  ],
  "count": 123,
  "total": 123,
  "prev": 123,
  "next": 123
}

Documentation Index

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

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

Authorizations

​
Authorization
string
header
required

Bearer token in the Authorization header — for example, Authorization: Bearer trv_ak_your_api_key_here. Each key is bound to a specific user and organization.

Query Parameters

​
page
integer

Page number (1-indexed).

Required range: x >= 1
​
limit
integer

Number of sessions per page.

Required range: x >= 1

Response

A page of sessions.

​
sessions
object[]
required

Sessions on the current page.

​
count
integer
required

Number of sessions on this page.

​
total
integer
required

Total sessions across all pages.

​
prev
integer | null

Previous page number. null if first page.

​
next
integer | null

Next page number. null if last page.