Resend admin invite for an Organization

post

https://api.benjipays.com/v2/organizations/{organizationId}/resend-invite

Access: Requires DISTRIBUTOR actor type

Resends the admin onboarding invite email for an Organization. Deletes any existing incomplete invites and creates a new one.

Workflow:

Deletes existing incomplete invite(s) from loginInvites collection
Creates and sends new invite using existing inviteUser() flow
Creates activity log entry

Email:

If email provided in request body, uses that email
Otherwise, uses organization's existing admin email

Requirements:

Organization must be in pending_activation status
Cannot resend invite to already activated organization (returns 409)
Organization must belong to authenticated distributor

Requires JWT authentication and 'partners:organizations:resend-invite' scope.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

organizationId

string

required

^[0-9a-fA-F]{24}$

MongoDB ObjectId of the organization

Body Params

string

^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

Optional new email address for the admin invite

Headers

X-Request-ID

uuid

Optional client-supplied unique ID for one request. The server generates a UUID v4 if omitted and always echoes the value in the response.

X-Correlation-ID

uuid

Optional ID that flows across service boundaries for distributed tracing. The server generates a UUID v4 if omitted and always echoes the value in the response.

Idempotency-Key

string

length between 1 and 255

^[a-zA-Z0-9]+$

Optional client-supplied key that makes retries safe for POST/PATCH/PUT. Scoped per actor; cached for 24 hours. Replays return the cached response with X-Idempotency-Replayed: true. Same key with a different body returns 409. In-flight duplicates return 429 with Retry-After. See the Idempotency section in the API overview.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200Invite resent successfully

400Bad Request - Invalid email format

401Unauthorized - Invalid or missing authentication token

403Forbidden - Distributor actor type required

404Not Found - Organization not found or does not belong to distributor

409Conflict - Organization is already activated

429Too Many Requests - Rate limit exceeded