/v1/users/invites (POST)

POST

/v1/users/invites

curl --request POST \
  --url https://api.reindeer.example.tr/v1/users/invites \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "roles": [ "admin" ] }'

Scope users:write, fresh step-up. Creates an approval.

Authorizations

• mutualTLS
• session

Request Body^required

Media typeapplication/json

object

name

required

string

roles

required

Array<string>

Allowed values: admin approver auditor reader deleter operator uploader owner

Responses

202

Approval waiting for a second person

Media typeapplication/json

object

approval

object

id

string

kind

string

Allowed values: identity.create invite.create export.full deletion.accept key.declare-lost

summary

string

requested_by

string

requested_at

string format: date-time

not_before

string format: date-time

expires_at

string format: date-time

state

string

Allowed values: pending approved executing rejected expired executed failed cancelled

controllers

Everyone who controlled the requester when the request was made: the issuers of its codes, the person who requested a machine, and their controllers in turn

Array<string>

cool_off_seconds

integer

decided_by

string

decided_at

string format: date-time

cancelled_by

string

cancelled_at

string format: date-time

result

object

Example

{
  "approval": {
    "kind": "identity.create",
    "state": "pending"
  }
}