Auth API reference

Auth API · Consumer-Me

get/{app_slug}/v1/meAuth

Get the signed-in EndUser profile

Returns the EndUser identity, app membership, and role name. The flat `permissions[]` array is intentionally NOT included — permissions resolve from the role on demand. Call `GET /me/permissions` for the flat list when the client needs it for UI gating.

Path parameters

app_slug*string

Slug of the app.

Response · 200

id*string

EndUser account id (UUID).

username*string

Username inside the app.

Example: "ada"

display_name*string

Display name of the user.

Example: "Ada Lovelace"

role*string

App-level role name. Resolves per-request from the JWT.

Example: "member"

joined_at*string · date-time

When the EndUser joined the app.

created_at*string · date-time

When the account row was created.

email*string

Primary email contact value. `null` if the user has no email contact.

Example: "ada@example.com"

email_verified_at*string · date-time

When the primary email was verified. `null` until verification completes.

avatar_url*string

Stable avatar URL (`/:appSlug/v1/avatars/:accountId`) when the user has an avatar — uploaded, or captured from a Google/GitHub sign-in. `null` when no avatar exists. Does not expire; each hit 302s to a short-lived presigned URL (or the provider URL).

Example: "https://api.auth.productcraft.co/my-app/v1/avatars/8f14…"

Example

Request

GET https://api.auth.productcraft.co/{app_slug}/v1/me
Authorization: Bearer YOUR_TOKEN

Response

{
  "id": "string",
  "username": "ada",
  "display_name": "Ada Lovelace",
  "role": "member",
  "joined_at": "2026-01-01T00:00:00.000Z",
  "created_at": "2026-01-01T00:00:00.000Z",
  "email": "ada@example.com",
  "email_verified_at": "2026-01-01T00:00:00.000Z",
  "avatar_url": "https://api.auth.productcraft.co/my-app/v1/avatars/8f14…"
}