Signup invitations#

PropertyValue
Servicecrossfire
Operationinvitations
MethodGET
Path/api/member-invitations
Authenticationhuman
Success status200
Response dataPaginated collection
Request formatjson
Maximum request body2097152 bytes (service default)
Permission codesmember.invite

Listed permission codes are alternatives, not token scopes. The service also checks access to the requested records and rejects stale revisions or controller generations.

Path parameters#

empty object; unknown fields rejected

Validation#

check.empty

Referenced definitions:

Query parameters#

custom validation: page ; see function below

Query parameters are URL text. The validation function below specifies their format, defaults and combinations. Pagination applies only to operations that use it.

Additional checks#

The following checks apply in addition to the field limits.

Constraint on value:

export function page(input: unknown) {
    const parsed = checked(input, []);
    return parsed.ok ? pagination(parsed.value) : parsed;
}

Validation#

query.page

Referenced definitions:

Request body#

empty object; unknown fields rejected

Validation#

check.empty

Referenced definitions:

Response data#

array; 0–100 entries; item: object; fields below; unknown fields rejected ( invitation )

Field pathRepresentation and constraints
[].invitationIdlowercase opaque UUID
[].createdByMemberIdlowercase opaque UUID
[].roleCodemember or administrator
[].createdAtexact JSON integer; 0…9007199254740991
[].expiresAtexact JSON integer; 0…9007199254740991
[].consumedByMemberIdlowercase opaque UUID; JSON null permitted
[].revokedAtexact JSON integer; 0…9007199254740991; JSON null permitted

Validation#

check.list(res.invitation, 100)

Referenced definitions:

Response envelope#

A successful JSON response contains data and meta. Replace the data placeholder below with the response fields described above. Errors contain error instead of data.

{
  "data": "<value matching the response-data validator>",
  "meta": {
    "requestId": "00000000-0000-0000-0000-000000000001",
    "page": 1,
    "pageSize": 20,
    "totalItems": 0,
    "totalPages": 1
  }
}