Skip to content
Everruns
Search
Ctrl
K
Cancel
GitHub
Select theme
Dark
Light
Auto
Getting Started
Introduction
Docker Compose Quickstart
Architecture
Features
Capabilities
CLI
Event Reference
Events
SDK
Management UI
SRE Guide
Environment Variables
Admin Container
Runbooks
Authentication Configuration
Durable Execution Engine Setup
Encryption Key Rotation
Observability
Observability
Braintrust Integration
API Reference
Overview
agents
Overview
GET /v1/agents - List all active agents
POST /v1/agents - Create a new agent
POST /v1/agents/import - Import agent from Markdown, YAML, or JSON
GET /v1/agents/{agent_id} - Get agent by ID
DELETE /v1/agents/{agent_id} - Archive agent
PATCH /v1/agents/{agent_id} - Update agent
GET /v1/agents/{agent_id}/export - Export agent in Markdown format with YAML front matter
sessions
Overview
GET /v1/sessions - List sessions in organization
POST /v1/sessions - Create a new session
GET /v1/sessions/{session_id} - Get session
DELETE /v1/sessions/{session_id} - Delete session
PATCH /v1/sessions/{session_id} - Update session
POST /v1/sessions/{session_id}/cancel - Cancel current turn
messages
Overview
GET /v1/sessions/{session_id}/messages - List messages (PRIMARY data)
POST /v1/sessions/{session_id}/messages - Create message (user message triggers workflow)
events
Overview
GET /v1/sessions/{session_id}/events - List events (JSON)
GET /v1/sessions/{session_id}/sse - Stream events (SSE notifications)
llm-providers
Overview
List all LLM providers
Create a new LLM provider
Get a specific LLM provider
Delete an LLM provider
Update an LLM provider
llm-models
Overview
List all models across all providers
Get a specific model with provider info and profile
Delete a model
Update a model
List models for a specific provider
Create a new model for a provider
capabilities
Overview
GET /v1/capabilities - List all available capabilities
GET /v1/capabilities/{capability_id} - Get a specific capability
users
Overview
GET /v1/users - List all users
filesystem
Overview
GET /fs - Get root directory listing
POST /fs/_/copy - Copy file
POST /fs/_/grep - Search files
POST /fs/_/move - Move/rename file
POST /fs/_/stat - Get file or directory stat
GET /fs/*path - Get file content or directory listing
PUT /fs/*path - Update file content
POST /fs/*path - Create file or directory
DELETE /fs/*path - Delete file or directory
mcp-servers
Overview
GET /v1/mcp-servers - List all MCP servers
POST /v1/mcp-servers - Create a new MCP server
GET /v1/mcp-servers/{server_id} - Get MCP server by ID
DELETE /v1/mcp-servers/{server_id} - Delete MCP server
PATCH /v1/mcp-servers/{server_id} - Update MCP server
durable-schedules
Overview
GET /v1/durable/executions/:execution_id - Get execution details
GET /v1/durable/schedules - List schedules
POST /v1/durable/schedules - Create a new schedule
GET /v1/durable/schedules/:schedule_id - Get schedule details
DELETE /v1/durable/schedules/:schedule_id - Delete schedule
PATCH /v1/durable/schedules/:schedule_id - Update schedule
GET /v1/durable/schedules/:schedule_id/executions - List schedule executions
POST /v1/durable/schedules/:schedule_id/pause - Pause schedule
POST /v1/durable/schedules/:schedule_id/resume - Resume schedule
GET /v1/durable/schedules/:schedule_id/stats - Get schedule statistics
POST /v1/durable/schedules/:schedule_id/trigger - Manually trigger schedule
GitHub
Select theme
Dark
Light
Auto
Overview
Everruns API (0.2.0)
Section titled “Everruns API (0.2.0)”
API for managing AI agents, sessions, messages, and events
License:
MIT
OpenAPI version: 3.1.0
