Me

Endpointhttps://api.kontorion.eu/v1

Get the current user and their memberships

GET

https://api.kontorion.eu/v1

/me

Returns the current user, their org memberships, the active org, workspaces, and realm roles. Dashboard-only - requires a Keycloak session. External API-key callers get 401.

Get the current user and their memberships › Headers

X-Workspace-Id

string

Selects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.

Workspace UUID or slug.

Get the current user and their memberships › Responses

object · required

GET/me

curl --request GET \
  --url https://api.kontorion.eu/v1/me

shell

Example Responses

{
  "data": {
    "active_org": "active_org",
    "active_workspace": "active_workspace",
    "orgs": [
      {
        "alias": "alias",
        "id": "0f8fad5b-d9cb-469f-a165-70867728950e",
        "name": "name",
        "roles": [
          "string"
        ]
      }
    ],
    "realm_roles": [
      "string"
    ],
    "user": {
      "email": "email",
      "id": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "locale": "locale",
      "name": "name",
      "picture": "picture",
      "timezone": "timezone"
    },
    "workspaces": [
      {
        "active_test_clock_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
        "created_at": "2024-08-25T15:00:00Z",
        "id": "0f8fad5b-d9cb-469f-a165-70867728950e",
        "mode": "mode",
        "name": "name",
        "organization_id": "0f8fad5b-d9cb-469f-a165-70867728950e",
        "slug": "slug",
        "status": "status",
        "updated_at": "2024-08-25T15:00:00Z"
      }
    ]
  }
}

json

application/json

List the current user's enrolled credential types

GET

https://api.kontorion.eu/v1

/me/credentials

Returns the credential types the user has enrolled - "password", "otp", "webauthn", "webauthn-passwordless", "recovery-authn-codes". Used by the 2FA settings page to render Connected/Setup state per row. API-key callers receive an empty list (no Keycloak user).

List the current user's enrolled credential types › Headers

X-Workspace-Id

string

Workspace UUID or slug.

List the current user's enrolled credential types › Responses

object · required

Get the current caller's effective permissions

GET

https://api.kontorion.eu/v1

/me/permissions

Returns the permissions the current request would pass through authorization gates - computed from the JWT claims (Keycloak path) or the API-key all-assignable bundle. The frontend component reads this to render permission-gated UI.

Get the current caller's effective permissions › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Get the current caller's effective permissions › Responses

object · required

Get the current user's dashboard preferences

GET

https://api.kontorion.eu/v1

/me/preferences

Returns the authenticated user's dashboard preferences. The row is created with schema defaults on first access.

Get the current user's dashboard preferences › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Get the current user's dashboard preferences › Responses

object · required

Update the current user's dashboard preferences

PATCH

https://api.kontorion.eu/v1

/me/preferences

Partial update - fields omitted from the body remain unchanged. The locale and timezone fields mirror onto the user profile so the per-request locale resolver sees the new value immediately.

Update the current user's dashboard preferences › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Update the current user's dashboard preferences › Request Body

currency

string | null

date_format

string | null

first_day_of_week

string | null

language

string | null

locale

string | null

object

number_format

string | null

theme

string | null

timezone

string | null

Update the current user's dashboard preferences › Responses

object · required

PATCH/me/preferences

curl --request PATCH \
  --url https://api.kontorion.eu/v1/me/preferences \
  --header 'Content-Type: application/json' \
  --data '
{
  "currency": "currency",
  "date_format": "date_format",
  "first_day_of_week": "first_day_of_week",
  "language": "language",
  "locale": "locale",
  "notification_channels": {
    "key": [
      "string"
    ]
  },
  "number_format": "number_format",
  "theme": "theme",
  "timezone": "timezone"
}
'

shell

Example Request Body

{
  "currency": "currency",
  "date_format": "date_format",
  "first_day_of_week": "first_day_of_week",
  "language": "language",
  "locale": "locale",
  "notification_channels": {
    "key": [
      "string"
    ]
  },
  "number_format": "number_format",
  "theme": "theme",
  "timezone": "timezone"
}

json

Example Responses

{
  "data": {
    "created_at": "2024-08-25T15:00:00Z",
    "currency": "currency",
    "date_format": "date_format",
    "first_day_of_week": "first_day_of_week",
    "language": "language",
    "locale": "locale",
    "notification_channels": {
      "key": [
        "string"
      ]
    },
    "number_format": "number_format",
    "theme": "theme",
    "timezone": "timezone",
    "updated_at": "2024-08-25T15:00:00Z",
    "user_id": "0f8fad5b-d9cb-469f-a165-70867728950e"
  }
}

json

application/json

Identity Providers Members

Get the current user and their memberships

GET

https://api.kontorion.eu/v1

/me

Returns the current user, their org memberships, the active org, workspaces, and realm roles. Dashboard-only - requires a Keycloak session. External API-key callers get 401.

Get the current user and their memberships › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Get the current user and their memberships › Responses

object · required

List the current user's enrolled credential types

GET

https://api.kontorion.eu/v1

/me/credentials

List the current user's enrolled credential types › Headers

X-Workspace-Id

string

Workspace UUID or slug.

List the current user's enrolled credential types › Responses

object · required

Get the current caller's effective permissions

GET

https://api.kontorion.eu/v1

/me/permissions

Get the current caller's effective permissions › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Get the current caller's effective permissions › Responses

object · required

Get the current user's dashboard preferences

GET

https://api.kontorion.eu/v1

/me/preferences

Returns the authenticated user's dashboard preferences. The row is created with schema defaults on first access.

Get the current user's dashboard preferences › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Get the current user's dashboard preferences › Responses

object · required

Update the current user's dashboard preferences

PATCH

https://api.kontorion.eu/v1

/me/preferences

Partial update - fields omitted from the body remain unchanged. The locale and timezone fields mirror onto the user profile so the per-request locale resolver sees the new value immediately.

Update the current user's dashboard preferences › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Update the current user's dashboard preferences › Request Body

currency

string | null

date_format

string | null

first_day_of_week

string | null

language

string | null

locale

string | null

object

number_format

string | null

theme

string | null

timezone

string | null

Update the current user's dashboard preferences › Responses

object · required