Update current user

PATCH

/api/v1/users/me

curl --request PATCH \
  --url https://example.com/api/v1/users/me \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "email": "example", "fullname": "example", "preferred_language": "example" }'

Updates the current user’s profile fields.

Authorizations

• ApiKeyAuth

Request Body^required

Request body

Media typeapplication/json

object

email

string

fullname

string

preferred_language

PreferredLanguage is the UI language tag the operator picked. Validated against the supported-language list; an empty value leaves the stored preference unchanged (same semantics as the other patch fields).

string

Example^generated

{
  "email": "example",
  "fullname": "example",
  "preferred_language": "example"
}

Responses

200

OK

Media typeapplication/json

object

admin

boolean

email

string

fullname

string

last_access

string

permissions

object

key

additional properties

object

admin

boolean

carve

boolean

query

boolean

user

boolean

preferred_language

PreferredLanguage mirrors AdminUser.PreferredLanguage — the UI language the operator picked. Empty means “no server-side preference”; the SPA falls back to its own detection.

string

service

boolean

token_expire

string

username

string

uuid

string

Example^generated

{
  "admin": true,
  "email": "example",
  "fullname": "example",
  "last_access": "example",
  "permissions": {
    "additionalProperty": {
      "admin": true,
      "carve": true,
      "query": true,
      "user": true
    }
  },
  "preferred_language": "example",
  "service": true,
  "token_expire": "example",
  "username": "example",
  "uuid": "example"
}

400

Bad request

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

401

Unauthorized

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

403

Forbidden

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

404

Not found

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

409

Conflict

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

429

Too many requests

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

500

Internal server error

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

503

Service unavailable

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}