/v1/signup/finish

POST

/v1/signup/finish

curl --request POST \
  --url https://api.reindeer.example.tr/v1/signup/finish \
  --header 'Content-Type: application/json' \
  --data '{ "ceremony": "example", "credential": {} }'

Platform only. Verifies the passkey and, in one transaction, creates the founder’s account with the owner role, the pending organisation, its first history event, a session and an audit event that names both. A signup ceremony finishes nothing else and no other ceremony finishes a signup.

Request Body^required

Media typeapplication/json

object

ceremony

required

string

credential

required

PublicKeyCredential serialised as JSON

object

Example ^generated

{
  "ceremony": "example",
  "credential": {}
}

Responses

201

Session of the founder and the pending organisation

Media typeapplication/json

object

token

string

expires_at

string format: date-time

user

object

organization

object

id

string

name

string

state

string

Allowed values: pending active suspended

contact_email

string

data_source

string

terms_version

string

founder

string

founder_name

string

source

Staff views only: the network the signup came from, an IPv4 /24 or an IPv6 /48

string

created_at

string format: date-time

activated_at

string format: date-time

suspended_at

string format: date-time

events

Array<object>

object

at

string format: date-time

kind

string

Allowed values: signed_up activated suspended resumed

by

string

approval

string

reason

string

Example

{
  "organization": {
    "state": "pending",
    "events": [
      {
        "kind": "signed_up"
      }
    ]
  }
}

400

Ceremony_expired for an unknown, expired, spent or foreign ceremony; bad_json

401

Passkey_rejected

409

Terms_changed when the terms version changed during the signup; exists for a passkey already registered

429

Signup_rate or signup_source

503

Signups_paused