PATCH
Update Preferences

Authorizations

Authorization
string
header
required

The access token from a signed-in console session, sent as Authorization: Bearer <token>. It must be issued for the Simnet API audience — an identity token, or a token for another application, is refused with 401.

There are no API keys, client secrets or service accounts yet, so this is a personal, short-lived credential carrying your full account access. Programmatic credentials with role-based access are on the roadmap. See Authentication.

Headers

X-Region-Context
string<uuid>

The region to run this request against, as a region UUID. Omit it to use your default region — your primary region if you have one, otherwise the first active one. See Regions.

Body

application/json

Recovered from the handler, which reads this body key by key rather than binding it to a typed class. These are the keys it reads; anything else you send is ignored rather than rejected.

timezone
string
language
string
dateFormat
string
timeFormat
string
theme
string
notificationsEmail
boolean
notificationsJobComplete
boolean
notificationsJobFailed
boolean
notificationsBilling
boolean
organizationName
string
organizationDescription
string
organizationWebsite
string
organizationLogoUrl
string
maintenanceDay
integer
maintenanceStartTime
string
maintenanceEndTime
string

Response

Accepted. Most mutations are asynchronous: the response carries a jobId and the work continues behind it, so a 2xx here means the request was accepted rather than finished. Poll GET /api/v1/jobs/{jobId} until the job is terminal before reading anything the operation was meant to produce. A response with no jobId completed synchronously. See Asynchronous work.

jobId
string

Follow this with GET /api/v1/jobs/{jobId}. Absent when the operation completed synchronously.

Example:

"8f2c41a9-3e77-4d60-b1aa-9c05e2f4d811"

id
string

The affected resource, where the operation returns one.

Example:

"b6d0e719-2c48-4a13-9f52-7e1b3a08c6d4"