Platform API reference

Platform API · Me

patch/v1/me/profileAuth

Update the caller's profile. Currently only `displayName` is editable. An empty body is a no-op that returns the current profile. Cookie/JWT only — this is a human-self-service surface, not a PAK-mutation surface.

Request body

display_namestring

New display name. 1-128 chars. Optional — empty PATCH is a no-op.

Example: "Ada Lovelace"

Response · 200

id*string · uuid

Id of your account.

email*string

Your primary email, when you have one.

username*string

Your username.

display_name*string

Your display name, when set.

status*string

Account status (e.g. `active`, `suspended`).

email_verified_at*string · date-time

Timestamp when this account verified its primary email, or null if unverified.

avatar_url*string

Short-lived (15 min) presigned GET URL for the avatar object in private object storage. NULL when no avatar has been set; the frontend then renders initials. The API mints a fresh URL on every response, so a stable bookmark of this value is not meaningful.

Example

Request

PATCH https://api.platform-auth.productcraft.co/v1/me/profile
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "display_name": "Ada Lovelace"
}

Response

{
  "id": "00000000-0000-0000-0000-000000000000",
  "email": "string",
  "username": "string",
  "display_name": "string",
  "status": "string",
  "email_verified_at": "2026-01-01T00:00:00.000Z",
  "avatar_url": "string"
}