Profile and account reference
Profiles and LLM accounts are stored in the database. Manage them in Settings or through the profile and account APIs.
| Profile field | Value |
|---|---|
name | Required unique name. Immutable after creation |
harness | Inherited from the account. codex |
account_id | Account UUID. Can be changed to another account of the same harness |
model | Required model ID. A session can override it with agent.model |
description | Optional description |
active | Permits new sessions when the account is also active |
instructions | Shared instructions. Replaced by agent.instructions |
codex.effort | none, minimal, low, medium, high, xhigh, max, ultra |
codex.summary | auto, concise, detailed, none |
codex.personality | none, friendly, pragmatic |
codex.service_tier | Optional nonblank provider service-tier name |
| Account field | Value |
|---|---|
id | Generated UUID. Identifies the account in sessions and quota observations |
name | Editable display name |
harness | Immutable. codex |
auth_mode | Immutable. api_key or account |
active | Permits new sessions through active profiles |
credential_store | Immutable store name for account-file authorization |
api_key | Write-only provider key. Responses expose only api_key_mask |
auth_file | Authorization JSON supplied when creating an account-file account. Edit through the authorization-file API |
API-key values are encrypted in the database. Account files are stored in S3. Runtime TOML contains only infrastructure such as credential stores and services.
Credential store access
Supply S3 credentials to API and worker through AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY. See account authentication to prepare the store and authorization file.
| Credential store field | Value |
|---|---|
type | s3 |
bucket | Bucket name |
region | Region, defaults to us-east-1 |
endpoint_url | Optional custom S3-compatible service URL |
Codex option support depends on the selected model and credentials. Orpheus captures settings when creating a session. The public API cannot override codex.effort or other codex options. Select an appropriate profile instead.