List invitations
Lists the gallery's invitations, newest first, with cursor pagination. Filter with ?status=pending.
Lists the gallery's invitations, newest first, with cursor pagination. Filter with ?status=pending.
Authorization
bearerAuth invitations:readA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: invitations:read
Query Parameters
1 <= value <= 10020Value in
- "pending"
- "accepted"
- "revoked"
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "data": [ { "id": "string", "email": "string", "role": "owner", "status": "pending", "expires_at": "string", "created_at": "string" } ], "next_cursor": "string"}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}Revoke an invitation DELETE
Revokes a pending invitation, setting its status to revoked. The invited person can no longer redeem it.
Resend an invitation POST
Re-issues a pending invitation: mints a fresh redemption token, resets the 7-day expiry, and re-emails the invitee. Requires an Idempotency-Key header (the email is an irreversible side effect): a retry with the same key replays the original result for 24h instead of emailing again.