Me

Endpointhttps://api.kontorion.eu/v1

Get the authenticated identity

GET

https://api.kontorion.eu/v1

/me

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

Get the authenticated identity › Responses

Session payload consumed by the frontend useSession hook

active_org

string

active_workspace

string

object[]

realm_roles

string[]

object

object[]

GET/me

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

shell

Example Responses

{
  "active_org": "active_org",
  "active_workspace": "active_workspace",
  "orgs": [
    {
      "alias": "alias",
      "id": "id",
      "name": "name",
      "roles": [
        "string"
      ]
    }
  ],
  "realm_roles": [
    "string"
  ],
  "user": {
    "email": "email",
    "id": "id",
    "locale": "locale",
    "name": "name",
    "picture": "picture",
    "timezone": "timezone"
  },
  "workspaces": [
    {
      "active_test_clock_id": "active_test_clock_id",
      "created_at": "created_at",
      "id": "id",
      "mode": "live",
      "name": "name",
      "organization_id": "organization_id",
      "slug": "slug",
      "status": "active",
      "updated_at": "updated_at"
    }
  ]
}

json

application/json

Get the caller's enrolled Keycloak credential types

GET

https://api.kontorion.eu/v1

/me/credentials

Returns the list of credential types the user has enrolled - "password", "otp", "webauthn", "webauthn-passwordless", "recovery-authn-codes". Used by the /settings/account/2fa page to render Connected/Setup state per row. API-key callers receive an empty list (no Keycloak user). Returns an empty list when the Keycloak admin client isn't configured (deployment-config gap; the page renders correctly for the empty case).

Get the caller's enrolled Keycloak credential types › Responses

types

string[]

Get the caller's resolved permission set

GET

https://api.kontorion.eu/v1

/me/permissions

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

Get the caller's resolved permission set › Responses

Resolved permission set for this request

is_system_admin

boolean

permissions

string[]

Get the current user's 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 preferences › Responses

created_at

string

currency

string

Currency: per-user override of the org's default_currency. ISO 4217 code, e.g. "EUR". Drives defaulting when a document doesn't specify its own currency.

date_format

string · enum

Enum values:

iso

first_day_of_week

string · enum

Enum values:

monday

sunday

saturday

language

string

Language: UI translation key (e.g. "de", "en"). Distinct from Locale, which drives number/date format grammar — a user may legitimately want German UI with Swiss number formatting.

locale

string

object

number_format

string · enum

Enum values:

1,234.56

1.234,56

1 234,56

theme

string · enum

Enum values:

light

dark

system

timezone

string

updated_at

string

user_id

string

Update the current user's 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 users.locale/timezone so the per-request locale resolver sees the new value immediately.

Update the current user's preferences › Request Body

currency

string

date_format

string · enum

Enum values:

iso

first_day_of_week

string · enum

Enum values:

monday

sunday

saturday

language

string

locale

string

object

number_format

string · enum

Enum values:

1,234.56

1.234,56

1 234,56

theme

string · enum

Enum values:

light

dark

system

timezone

string

Update the current user's preferences › Responses

created_at

string

currency

string

Currency: per-user override of the org's default_currency. ISO 4217 code, e.g. "EUR". Drives defaulting when a document doesn't specify its own currency.

date_format

string · enum

Enum values:

iso

first_day_of_week

string · enum

Enum values:

monday

sunday

saturday

language

string

Language: UI translation key (e.g. "de", "en"). Distinct from Locale, which drives number/date format grammar — a user may legitimately want German UI with Swiss number formatting.

locale

string

object

number_format

string · enum

Enum values:

1,234.56

1.234,56

1 234,56

theme

string · enum

Enum values:

light

dark

system

timezone

string

updated_at

string

user_id

string

PATCH/me/preferences

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

shell

Example Request Body

{
  "currency": "currency",
  "date_format": "iso",
  "first_day_of_week": "monday",
  "language": "language",
  "locale": "locale",
  "notification_channels": {
    "key": [
      "string"
    ]
  },
  "number_format": "1,234.56",
  "theme": "light",
  "timezone": "timezone"
}

json

Example Responses

{
  "created_at": "created_at",
  "currency": "currency",
  "date_format": "iso",
  "first_day_of_week": "monday",
  "language": "language",
  "locale": "locale",
  "notification_channels": {
    "key": [
      "string"
    ]
  },
  "number_format": "1,234.56",
  "theme": "light",
  "timezone": "timezone",
  "updated_at": "updated_at",
  "user_id": "user_id"
}

json

application/json

Webhooks (Keycloak)Account

Get the authenticated identity

GET

https://api.kontorion.eu/v1

/me

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

Get the authenticated identity › Responses

Session payload consumed by the frontend useSession hook

active_org

string

active_workspace

string

object[]

realm_roles

string[]

object

object[]

Get the caller's enrolled Keycloak credential types

GET

https://api.kontorion.eu/v1

/me/credentials

Get the caller's enrolled Keycloak credential types › Responses

types

string[]

Get the caller's resolved permission set

GET

https://api.kontorion.eu/v1

/me/permissions

Get the caller's resolved permission set › Responses

Resolved permission set for this request

is_system_admin

boolean

permissions

string[]

Get the current user's 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 preferences › Responses

created_at

string

currency

string

Currency: per-user override of the org's default_currency. ISO 4217 code, e.g. "EUR". Drives defaulting when a document doesn't specify its own currency.

date_format

string · enum

Enum values:

iso

first_day_of_week

string · enum

Enum values:

monday

sunday

saturday

language

string

Language: UI translation key (e.g. "de", "en"). Distinct from Locale, which drives number/date format grammar — a user may legitimately want German UI with Swiss number formatting.

locale

string

object

number_format

string · enum

Enum values:

1,234.56

1.234,56

1 234,56

theme

string · enum

Enum values:

light

dark

system

timezone

string

updated_at

string

user_id

string

Update the current user's 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 users.locale/timezone so the per-request locale resolver sees the new value immediately.

Update the current user's preferences › Request Body

currency

string

date_format

string · enum

Enum values:

iso

first_day_of_week

string · enum

Enum values:

monday

sunday

saturday

language

string

locale

string

object

number_format

string · enum

Enum values:

1,234.56

1.234,56

1 234,56

theme

string · enum

Enum values:

light

dark

system

timezone

string

Update the current user's preferences › Responses

created_at

string

currency

string

Currency: per-user override of the org's default_currency. ISO 4217 code, e.g. "EUR". Drives defaulting when a document doesn't specify its own currency.

date_format

string · enum

Enum values:

iso

first_day_of_week

string · enum

Enum values:

monday

sunday

saturday

language

string

Language: UI translation key (e.g. "de", "en"). Distinct from Locale, which drives number/date format grammar — a user may legitimately want German UI with Swiss number formatting.

locale

string

object

number_format

string · enum

Enum values:

1,234.56

1.234,56

1 234,56

theme

string · enum

Enum values:

light

dark

system

timezone

string

updated_at

string

user_id

string