Skip to main content

Start registration process

POST 

/v1/registration

Preview: The API is in development or testing phases and the interface could still change slightly.

Starts a registration process with the provided form values. This endpoint:

  1. Creates a temporary user in the btx-tmp realm
  2. Starts a process instance with the provided form values
  3. Returns a process instance ID and authorization URL

The client should redirect the user to the authorization URL to complete authentication. PKCE parameters (state, nonce, code_challenge) are required for secure OAuth2 flow.

User Account Type: Anonymous User initiates the process. Upon completion, a Temporary User Account is created.
Scope: []

Request

Responses

Registration started successfully. Note that the API returns HTTP 200 even for validation errors, with the error information included in the response body.