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/

Retrieves details for a specific session.

​
Path Parameters

​
session_id
string
required
The ID of the session to retrieve. Must be a valid session ID with the session_ prefix.

​
Response

Returns the Session object.
​
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 that are additive to the agent’s capabilities.Each capability object contains:
  • ref (string): Capability reference ID
  • config (object, optional): Configuration overrides for the capability
​
status
string
Current session status: started, active, or idle.Status transitions:
  • started → Initial state
  • active → Processing a turn
  • idle → Waiting for input
Sessions work indefinitely — after processing, status returns to idle.
​
features
string[]
Computed at read time by aggregating features from all active capabilities (not stored in database).
​
created_at
string
ISO 8601 timestamp when the session was created.
​
updated_at
string
ISO 8601 timestamp when the session was last updated.

​
Example

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

​
Error Responses

  • 404 Not Found - Session does not exist or is not accessible
  • 401 Unauthorized - Missing or invalid authentication

​
Notes

  • Sessions are top-level entities under organizations
  • The features field is computed at read time from active capabilities
  • Session capabilities are additive to the agent’s capabilities