Skip to content
Everruns
Search
Ctrl
K
Cancel
GitHub
Select theme
Dark
Light
Auto
Get Started
Capabilities
Integrations
Tutorials
Reference
Operations
Get Started
Capabilities
Integrations
Tutorials
Reference
Operations
Event Reference
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
POST /v1/agents/preview - Preview the final agent shape with capabilities applied
GET /v1/agents/{agent_id} - Get agent by ID
PUT /v1/agents/{agent_id} - Create or update agent (upsert)
DELETE /v1/agents/{agent_id} - Archive agent
PATCH /v1/agents/{agent_id} - Update agent
POST /v1/agents/{agent_id}/copy - Copy an 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
POST /v1/sessions/chat - Get or create global chat 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
Export session messages as a JSONL file
PUT /v1/sessions/{session_id}/pin - Pin session for current user
DELETE /v1/sessions/{session_id}/pin - Unpin session for current user
POST /v1/sessions/{session_id}/tool-results - Submit client-side tool results
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
Sync models from 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 users in current organization
POST /v1/users/me/switch-org - Switch current organization
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
session-resources
Overview
List lifecycle-managed resources for a session.
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
images
Overview
GET /v1/images - List images
POST /v1/images - Upload an image
GET /v1/images/{image_id} - Get image (returns binary data)
DELETE /v1/images/{image_id} - Delete an image
GET /v1/images/{image_id}/thumbnail - Get image thumbnail
session-databases
Overview
GET /v1/sessions/{session_id}/databases
POST /v1/sessions/{session_id}/databases
GET /v1/sessions/{session_id}/databases/{name}
DELETE /v1/sessions/{session_id}/databases/{name}
GET /v1/sessions/{session_id}/databases/{name}/schema
session-storage
Overview
GET /v1/sessions/{session_id}/storage/keys - List all key-value pairs
GET /v1/sessions/{session_id}/storage/secrets - List all secrets (names only)
harnesses
Overview
GET /v1/harnesses
POST /v1/harnesses
GET /v1/harnesses/config
POST /v1/harnesses/preview
GET /v1/harnesses/{harness_id}
DELETE /v1/harnesses/{harness_id}
PATCH /v1/harnesses/{harness_id}
POST /v1/harnesses/{harness_id}/copy - Copy a harness
skills
Overview
GET /v1/skills - List all skills
POST /v1/skills - Create skill from SKILL.md
POST /v1/skills/upload - Create skill from ZIP archive
POST /v1/skills/validate - Validate SKILL.md content
GET /v1/skills/{skill_id} - Get skill by ID
DELETE /v1/skills/{skill_id} - Delete skill
PATCH /v1/skills/{skill_id} - Update skill
GET /v1/skills/{skill_id}/content - Get full skill content
Organizations
GET /v1/orgs - List organizations the current user belongs to
POST /v1/orgs - Create a new organization
GET /v1/orgs/:org - Get organization details
PATCH /v1/orgs/:org - Update organization
Session Git
POST /v1/sessions/{session_id}/git/branches
DELETE /v1/sessions/{session_id}/git/branches/{name}
POST /v1/sessions/{session_id}/git/commit
GET /v1/sessions/{session_id}/git/diff
GET /v1/sessions/{session_id}/git/log
GET /v1/sessions/{session_id}/git/refs
GitHub
Select theme
Dark
Light
Auto
Overview
harnesses
Section titled “harnesses”
Harness management endpoints
