Platform
Platform endpoints of the Ellipsis REST API.
| Method | Path |
|---|---|
| GET | /v1/models |
Most expensive first, with the platform default flagged. Reads the same registry as the dashboard's rate table, so a client's model picker can never drift from what's offered. Behind auth but not account-scoped — the selectable set is global.
curl "https://api.ellipsis.dev/v1/models" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY"import os
from ellipsis import Ellipsis
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
result = client.models.list()
print(result)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
const result = await client.models.list();
console.log(result);Request
Response
| Method | Path |
|---|---|
| GET | /v1/me |
curl "https://api.ellipsis.dev/v1/me" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY"import os
from ellipsis import Ellipsis
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
result = client.me()
print(result)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
const result = await client.me();
console.log(result);Request
Response
| Method | Path |
|---|---|
| GET | /v1/budget |
curl "https://api.ellipsis.dev/v1/budget" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY"import os
from ellipsis import Ellipsis
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
result = client.budget()
print(result)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
const result = await client.budget();
console.log(result);Request
Response
| Method | Path |
|---|---|
| GET | /v1/usage |
curl "https://api.ellipsis.dev/v1/usage" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY"import os
from ellipsis import Ellipsis
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
result = client.usage()
print(result)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
const result = await client.usage();
console.log(result);Request
Response
| Method | Path |
|---|---|
| PUT | /v1/settings/organization |
Replaces both: `default_model` accepts an alias or canonical id and is stored canonical; `budget_ceiling.session` is in US dollars, at most the platform ceiling. Null clears each. Refused for sandbox tokens (potentially prompt-injected code must not repoint the organization's defaults).
curl -X PUT "https://api.ellipsis.dev/v1/settings/organization" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'import os
from ellipsis import Ellipsis
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
result = client.settings.organization.set()
print(result)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
const result = await client.settings.organization.set();
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, or null when unset (sessions then run the platform default).
Response
| Method | Path |
|---|---|
| GET | /v1/settings/organization |
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/settings/organization" \
-H "Authorization: Bearer $ELLIPSIS_API_KEY"import os
from ellipsis import Ellipsis
client = Ellipsis(api_key=os.environ["ELLIPSIS_API_TOKEN"])
result = client.settings.organization.get()
print(result)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
const result = await client.settings.organization.get();
console.log(result);