Skip to main content
GET
/
v1
/
tasks
List tasks
curl --request GET \
  --url https://api.example.com/v1/tasks
{
  "sessions": [
    {}
  ],
  "sessionId": "<string>",
  "firstTask": {},
  "turnCount": 123,
  "latestStatus": "<string>",
  "latestCreatedAt": {},
  "latestUpdatedAt": {}
}

​
Query parameters

​
limit
number
default:"50"
How many sessions to return. Capped at 100.

​
Response — 200 OK

​
sessions
SessionSummary[]
Array of session summaries, most-recent-first.
Each SessionSummary contains:
​
sessionId
string
​
firstTask
Task
The first task in the session — useful for displaying the session’s “title” in a UI.
​
turnCount
number
Total tasks in the session.
​
latestStatus
string
Status of the most recent task in the session.
​
latestCreatedAt
string (ISO 8601)
​
latestUpdatedAt
string (ISO 8601)

​
Example

curl "$API_BASE/tasks?limit=20" \
  -H "Authorization: Bearer $API_KEY"

​
Notes

  • Grouping is server-side. The response gives you one row per conversation, not one row per task. That’s usually what you want for building a “chat history” sidebar in your UI.
  • Pagination. v1 doesn’t support cursor-based paging. If you need more than 100 sessions, filter by endUserId (coming soon as a dedicated endpoint) or query DynamoDB directly if you have that access.
  • No cross-tenant data. You only see sessions belonging to your own business.

​
Errors

CodeMeaning
401Missing Authorization header