Skip to content

Set your display name, language and theme

PATCH
/v1/me
curl --request PATCH \
--url https://beta-api.plune.ai/v1/me \
--header 'Content-Type: application/json' \
--cookie plune_session=<plune_session> \
--data '{ "name": "Olena Kovalenko" }'

The Account page, «Your name» (api.ts → setMyName). The name is what every screen shows where a row names you — a case you wrote, a run you launched, a result you marked, the Members list — in place of your address; null clears it. The language (en, uk) and the theme (dark, light) of the dashboard are kept here too (#1016, api.ts → setMyPreferences), so another browser opens the way this one does: the dashboard reads them from GET /v1/me when you sign in, and sends one only when you chose it — null is «never chose», and the browser’s own preference stands in. Any of the three, and at least one; what the body does not name is left as it was. Session-only, as the tokens are: a leaked CLI token must not be able to rename you.

Media type application/json

What a person may say about themselves: any of name, locale, theme, emailJobEnds and acceptTerms, and at least one. What the body does not name is left as it was; null takes a value back.

object
>= 1 properties
name

Trimmed; 1 to 100 characters, or null — the address stands in again.

string
nullable >= 1 characters <= 100 characters
locale

The dashboard’s language, or null for «never chose» — the browser’s own preference stands in again.

string
nullable
Allowed values: en uk
theme

The dashboard’s theme, or null for «never chose».

string
nullable
Allowed values: dark light
emailJobEnds

«Also by email» on or off (#1925). Saved when switched; the bell is told either way.

boolean
acceptTerms

The first sign-in screen’s box, ticked (#2490): records now and the current versions of the Terms of Service and the Privacy Policy, which the server knows - a client never sends a version. Only true; false is a 400.

boolean
Examples

The display name

{
"name": "Olena Kovalenko"
}

The signed-in user, as it is now

Media type application/json
object
userId
required
string format: uuid
email
required
string format: email
name
required

The display name (B8-team T3) — what every screen shows where a row names this person, in place of the address. null until given on the Account page.

string
nullable <= 100 characters
locale
required

The language the person chose for the dashboard (#1016), kept with the account so another browser opens in it. null until they choose one: the browser’s own preference stands in, and nothing is written on its behalf.

string
nullable
Allowed values: en uk
theme
required

The theme the person chose for the dashboard (#1016), kept with the account like locale. null until they choose one.

string
nullable
Allowed values: dark light
emailJobEnds
required

«Also by email» (#1925): the end of a long operation the person started (an import, an export, an ingest, a sync) comes as a letter to the sign-in address too. The notification on the bell comes either way. false for every account until the person turns it on.

boolean
consent
required

When the person accepted the Terms of Service and the Privacy Policy on the first sign-in screen (#2490), and the version of each (the date the page was last updated). null until then.

object
at
required
string format: date-time
termsVersion
required
string
nullable
privacyVersion
required
string
nullable
consentRequired
required

true while consent is null or names a version older than the current one: the dashboard then shows the first sign-in screen in place of every page (#2490). No other route of the api refuses on it, so API tokens keep working.

boolean
tier

Free and Personal are an account’s, Team and Enterprise a company’s; Free may also be a company’s, as the row that cancels its Team.

string
Allowed values: free personal team enterprise
tierState

Worked out from the grants at the database’s clock, never stored. active: a paid grant covers now. grace: it ended or was cancelled less than 14 days ago, and the limits are still the tier’s. expired: the 14 days are over — Free. disabled: the operator switched it off — Free at once, and nothing is deleted for 14 days. No grant ever is plain Free, active.

string
Allowed values: active grace expired disabled
options

What a grant carries besides its tier. A free grant carries none.

object
saml
boolean
extra_storage_packs
integer
<= 1000
extra_full_months
integer
<= 120
seats

The seats a payment bought (#1055). Only a payment writes it; the owner’s grant cannot.

integer
>= 1
tierValidUntil

When the paid period ends (or ended, in grace); null without an end and on Free.

string format: date-time
nullable
tierGraceEndsAt

Until when nothing is deleted: the end of the 14 days in grace and disabled; null when active or expired.

string format: date-time
nullable
role
required

What this account is allowed to be, e.g. user or owner. Open-ended: new roles appear without a client release.

string
Example
{
"userId": "u-shop",
"email": "owner@example.com",
"role": "user",
"name": "Olena Kovalenko",
"locale": "uk",
"theme": "light",
"emailJobEnds": false,
"consent": {
"at": "2026-11-17T13:30:00.000Z",
"termsVersion": "2026-11-17",
"privacyVersion": "2026-11-17"
},
"consentRequired": false,
"tier": "personal",
"tierState": "active",
"options": {},
"tierValidUntil": "2027-10-15T09:00:00.000Z",
"tierGraceEndsAt": null
}

Not JSON, an empty body, a name that is empty or over 100 characters, or a language or a theme the dashboard does not offer

Media type application/json
object
error
required
string
Example
{
"error": "validation failed — name: a name cannot be empty — send null to clear it"
}

No / invalid session

Session valid but the user no longer exists

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}
Retry-After
integer

Seconds until the window rolls over