TrieOH
IdentityXAPIAuthn

Check if IdentityX is set up

Returns 204 while setup is still pending (no first account yet) and 409 once the system has been set up — used by installers to decide whether to show the setup form. Public.

GET/auth/setup

Returns 204 while setup is still pending (no first account yet) and 409 once the system has been set up — used by installers to decide whether to show the setup form. Public.

Response Body

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/auth/setup"
Empty
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 409,
  "title": "Setup Complete"
}
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 500,
  "title": "Internal Server Error"
}
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 503,
  "title": "Identity Unavailable"
}

Health check GET

Harness-owned liveness probe. Returns 200 with a fixed body when the process is up. Not covered by rate limiting or auth.

Set up IdentityX POST

Creates the first account in the system as a super admin and enables authn. Succeeds only once — subsequent calls return 409 ("setup already complete"). Returns the freshly issued token pair (201).