Account settings

Configure spend limits and record retention.

Account settings apply to every session and agent. Owners and admins change spending settings while signed in; API keys and session credentials can't change them.

Session budget ceiling

Set this in Agents > Settings.

SettingEffect
Session budget ceilingThe largest session budget a request can ask for

Spend limits

Set account limits, the default session budget, and optional per-developer limits in Billing > Limits. Account limits cover spend over the last 1, 7, and 28 days. Per-developer limits apply to each person and each API key separately.

A paid request starts only when every limit that applies has room, including agent and handler limits. Lowering a limit can stop paid requests in sessions that are already running. See Budgets for defaults and what happens at a limit.

Platform allowances

API > Limits shows your account's API request limits, storage quotas, concurrency limits, and spending ceilings. Custom values are marked Custom. Every API request counts toward the account total, and some endpoints also have their own cap.

Your account keeps up to 32 sessions alive at once by default. A session counts while its agent runs and for a minute after each turn. More sessions wait as queued and start in the order they were created as others end.

To request an increase, ask in your shared Slack channel with the Ellipsis team. To create one, open Help.

Budget alerts

Set alert thresholds in Billing > Limits. Alerts go to the Slack operations channel, notification emails, and Alerts. GET /v1/account/budget returns current limits and remaining spend.

Retention

See Security for how long session data is kept and when it's deleted.

Shared configuration

A GitHub repository named .ellipsis holds configuration for your whole organization:

1
.ellipsis/
2
agents/nightly-tests.yaml
3
environments/api-environment.yaml
4
github.yaml
5
slack.yaml
6
linear.yaml
7
sentry.yaml

In other repositories, agents and environments go in a .ellipsis/ directory. Integration files work only in the .ellipsis repository, and each defines the handler for its service. Folder names for agents and environments are up to you.

Credits and billing

See Pricing for credits, compute charges, and automatic recharge.

On this page

Schedule a demo