joinRequests
Identity module · 5 operations
List join request rows
GET/join-requests
A request to join an org, approved by an Admin. Returns a cursor page of join request rows the caller may see. The default order is `created_at` ascending. Supports sparse fieldsets and the filter grammar.
Create a join request
POST/join-requests
A request to join an org, approved by an Admin. Creates a join request. Requires `Idempotency-Key`; a replay returns the original response. The organization is derived from the credential or the parent row, never from the body.
Get a join request
GET/join-requests/{id}
A request to join an org, approved by an Admin. Returns one join request with its `ETag`. A join request the caller may not see returns 404.
Approve a join request
POST/join-requests/{id}/approve
Approves the request and creates the membership. Requires an Admin. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.
Decline a join request
POST/join-requests/{id}/decline
Declines the request. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.