Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/everruns/everruns/llms.txt

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

​
GET /v1/sessions

Returns a paginated list of sessions in the organization.

​
Query Parameters

​
agent_id
string
Optional filter to return only sessions assigned to a specific agent.Without this parameter, returns all sessions in the organization.
​
offset
integer
default:"0"
Number of items to skip for pagination.
​
limit
integer
default:"20"
Maximum number of items to return per page. Maximum value is 100.

​
Response

Returns a paginated response with session objects.
​
data
object[]
Array of Session objects for the current page. Ordered by created_at DESC.
​
total
integer
Total count of sessions across all pages.
​
offset
integer
Current offset (echoed from request).
​
limit
integer
Current limit (echoed from request).

​
Session Object

Each session in the data array contains:
​
id
string
The session’s public ID with the session_ prefix.
​
agent_id
string
The ID of the agent assigned to this session.
​
title
string
The session title.
​
tags
string[]
Tags associated with the session.
​
model_id
string
Model override for this session, if set.
​
capabilities
object[]
Session-level capabilities (additive to agent capabilities).
​
status
string
Current session status: started, active, or idle.
​
features
string[]
Computed at read time by aggregating features from all active capabilities.
​
created_at
string
ISO 8601 timestamp when the session was created.
​
updated_at
string
ISO 8601 timestamp when the session was last updated.

​
Examples

​
List all sessions

curl https://api.everruns.com/v1/sessions \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Filter by agent

curl "https://api.everruns.com/v1/sessions?agent_id=agent_01234567-89ab-cdef-0123-456789abcdef" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Pagination

# First page (default)
curl https://api.everruns.com/v1/sessions \
  -H "Authorization: Bearer YOUR_API_KEY"

# Second page
curl "https://api.everruns.com/v1/sessions?offset=20&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Custom page size
curl "https://api.everruns.com/v1/sessions?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Notes

  • Results are ordered by created_at DESC (newest first)
  • Default pagination limit is 20 items per page
  • Maximum pagination limit is 100 items per page
  • Without agent_id filter, returns all sessions in the organization