Skip to Content
SeyloDocs
API referenceSign-in and account

Change your UI preferences

POST
/api/v1/auth.updatePreferences

Merges the given keys into the signed-in person's preferences; a key set to null is removed. At most 16 KB in total.

Any signed-in caller. Not available to MCP clients or the assistant.

Authorization

cookieseylo_session<token>

Request Body

application/json
  1. body
preferences*

Per-person UI choices that follow them across browsers, for example collapsed projects or color mode.

Response Body

Success.

application/json
  1. response
preferences*

Per-person UI choices that follow them across browsers, for example collapsed projects or color mode.

Example Request
curl -X POST 'https://example.com/api/v1/auth.updatePreferences' \  -H 'Content-Type: application/json' \  -d '{  "preferences": {}}'
Example Response
{  "preferences": {}}

Start setting up an authenticator app POST

Creates a new TOTP secret for the signed-in person and returns it as a QR-ready otpauth URL. It is not enforced until auth.totpConfirm. CONFLICT when 2FA is already on. Needs a sign-in or auth.reauth from the last 15 minutes (FORBIDDEN details.reason "reauth" otherwise). Any signed-in caller. Not available to MCP clients or the assistant.

Change your name POST

Changes the display name of the signed-in person. Email changes go through an owner or admin (users.update). Any signed-in caller. Not available to MCP clients or the assistant.