Account
Account endpoints of the Ellipsis REST API.
| Method | Path |
|---|---|
| GET | /v1/account/budget |
curl "https://api.ellipsis.dev/v1/account/budget" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY"import os
from ellipsis import Ellipsis
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
result = client.account.budget()
print(result)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
const result = await client.account.budget();
console.log(result);Request
Response
| Method | Path |
|---|---|
| GET | /v1/account/models |
Most expensive first, with the organization's default model flagged (`is_default_agent_model`: the `default_model` of `GET /v1/account/settings`). Reads the same registry as the dashboard's rate table, so a client's model picker can never drift from what's offered. The selectable set is global; only the flag is account-scoped.
curl "https://api.ellipsis.dev/v1/account/models" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY"import os
from ellipsis import Ellipsis
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
result = client.account.models.list()
print(result)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
const result = await client.account.models.list();
console.log(result);Request
Response
| Method | Path |
|---|---|
| PUT | /v1/account/settings |
Replaces both: `default_model` accepts an alias or canonical id and is stored canonical, and cannot be cleared (it is the only default a session's model resolves against); `budget_ceiling.session` is in US dollars, at most the platform ceiling, and null clears it. Refused for sandbox tokens (potentially prompt-injected code must not repoint the organization's defaults).
curl -X PUT "https://api.ellipsis.dev/v1/account/settings" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"default_model":"..."}'import os
from ellipsis import Ellipsis
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
result = client.account.settings.set(
"...",
)
print(result)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
const result = await client.account.settings.set({ default_model: '...' });
console.log(result);Request
Body parameters
The organization's spend ceilings.
Canonical model id every session falls back to when neither its request nor its automation names one. Always set: there is no platform default behind it, so a new organization starts on the model Ellipsis currently recommends and changes it here.
Response
| Method | Path |
|---|---|
| GET | /v1/account/settings |
The default model every session falls back to when neither its request nor its automation names one, and the per-session budget ceiling no session may exceed.
curl "https://api.ellipsis.dev/v1/account/settings" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY"import os
from ellipsis import Ellipsis
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
result = client.account.settings.get()
print(result)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
const result = await client.account.settings.get();
console.log(result);Request
Response
| Method | Path |
|---|---|
| GET | /v1/account/usage |
curl "https://api.ellipsis.dev/v1/account/usage" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY"import os
from ellipsis import Ellipsis
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
result = client.account.usage()
print(result)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
const result = await client.account.usage();
console.log(result);