Skip to content
Plune Plune Docs

Set your display name

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" }'

Settings → General, «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. Session-only, as the tokens are: a leaked CLI token must not be able to rename you.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type application/json

The one thing a person may say about themselves. null clears the name; the address stands in again.

object
name
required

Trimmed; 1 to 100 characters, or null.

string
nullable >= 1 characters <= 100 characters
Examples
Example example 
{
  "name": "Olena Kovalenko"
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

The signed-in user, renamed

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 Settings → General.

string
nullable <= 100 characters
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": "[email protected]",
  "role": "user",
  "name": "Olena Kovalenko"
}

400

Section titled “400 ”

Not JSON, or a name that is empty or over 100 characters

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

401

Section titled “401 ”

No / invalid session

404

Section titled “404 ”

Session valid but the user no longer exists

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

429

Section titled “429 ”

Rate-limited: either the per-route throttle or a tenant quota. Retry-After carries the seconds until the window rolls over.

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

Headers

Section titled “Headers ”
Retry-After
integer

Seconds until the window rolls over