Everything the dashboard does, scriptable

The dashboard is a client of the same API you get. Start sessions from CI and scripts, read typed results back, and let agents spawn agents.

01

Spawning agents is as simple as POST /v1/sessions

Put an LLM decision-maker anywhere in your SDLC with no infra to manage. Spawn a session from any workflow and get typed, structured output back.

02

Deploy agents over the REST API

Call the REST API to start sessions from your own services and internal tools. Spawn an agent from a deploy hook or a webhook handler, poll for status, and read the result back programmatically.

POST/v1/runs200 OK
Request
{
"repo": "web-repo",
"prompt": "bump deps and open a PR"
}
Response
{
"id": "run_8f2c",
"status": "queued"
}

One request in, a structured result back

03

Agents that return typed data, not prose

Declare a JSON schema in the agent's YAML and every session exits through it. Downstream automation gets guaranteed shapes, and a session that cannot match the schema fails loudly instead of shipping malformed output.

agents/schema-migration-reviewer.yamlany JSON Schema
structured_output:  type: json_schema  json_schema:    type: object    properties:      findings:        type: array        items:          type: object          properties:            title: { type: string }            severity: { enum: [low, medium, high] }          required: [title, severity]    required: [findings]

The output schema declared in the agent's YAML

04

Agents become pipeline stages

An agent with a schema is a function with a contract, so agents chain into pipelines: agent to webhook to script to agent, with no defensive glue. The CLI ships inside every sandbox, so agents can spawn and orchestrate agents.

1review agentemits findings[] through the schema
2webhookyour service receives typed JSON
3scriptfiles tickets for severity: high
4fix agentstarts from each ticket, opens the PR
an agent with a schema is a function with a contract

Agents chained stage by stage into a pipeline

The full integration surface

Everything the API and the CLI expose, so anything the dashboard does your scripts can do too.

One REST API

Every endpoint lives at api.ellipsis.dev and returns JSON. The dashboard and the CLI are clients of the same public API.

Published OpenAPI spec

The full specification is published at www.ellipsis.dev/openapi.v1.json. The reference docs and the SDKs are generated from it.

Two credentials

API keys act as your organization for scripts and automations. User tokens from agent login act as you and attribute sessions to you.

One environment variable

ELLIPSIS_API_TOKEN is read by both the API examples and the CLI, so one exported key serves scripts and the terminal.

Stable error codes

Every error returns one envelope with a stable code field. Switch on the code, never the message text, and quote the request_id to support.

Sessions end to end

Start agent sessions, search and read everything they leave behind, stream live output, and stop or replay them.

Code reviews

Start a code review of a pull request and list every review with its outcome.

Agent configs

Manage saved agent configs, the defaults that pick one per repository, and the templates new agents start from.

Platform resources

Sandbox secrets, files, alerts, analytics, identity, budget, usage, and models are all endpoints.

Webhooks in preview

Outbound webhooks push session lifecycle events to your systems. Access is by request while the feature is in a gated preview.

Open-source CLI

brew install ellipsis-dev/cli/agent ships one binary named agent, with a device-code login and --json on most commands.

A skill for your coding agent

npx skills add ellipsis-dev/cli teaches Claude Code, Cursor, or Codex to start, watch, and search sessions for you.

Frequently asked questions

Explore the platform