PUT /settings/sessions/defaults
Set the account-wide session defaults.
TypeScript SDKThe npm client, generated from the API spec.Python SDKThe PyPI client, sync and async.
| Method | Path |
|---|---|
| PUT | /v1/settings/sessions/defaults |
`model` accepts an alias or canonical id and is stored canonical; null clears it (sessions then fall back to the platform default). Refused for sandbox tokens (potentially prompt-injected code must not repoint the account's default model).
curl -X PUT "https://api.ellipsis.dev/v1/settings/sessions/defaults" \
-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.sessions.set_defaults()
print(result)import { Ellipsis } from '@ellipsis-dev/sdk';
const client = new Ellipsis({
apiKey: process.env.ELLIPSIS_API_TOKEN!,
});
const result = await client.settings.sessions.setDefaults();
console.log(result);Request
Example request body
{
"model": "string"
}
Body parameters
modelstring
Canonical model id every session falls back to when neither the request nor its agent config names one, or null when unset (sessions then run the platform default).
Response
Example response · 200
{
"model": "string"
}