API reference › Team › Roles and users

Resend a user's onboarding invite

POST /v1/users/{id}/resend-invite

Scope
team:write
Roles
admin, scheduler

Issues a new set-password link and invalidates the previous one. Limited to one resend per user per five minutes. An admin's invite can be resent only by another admin, and only until it is accepted (no password set and never signed in); super-admin accounts are never targets.

Parameters

Path parameters

NameTypeDescription
id requiredstring

Tenant user ID

Example USR-5RSWGE.

Every call also sends Authorization and X-Tenant-ID; see Getting started.

Example request

Shell
curl -X POST "https://api.fetchfido.ai/v1/users/{id}/resend-invite" \
  -H "Authorization: Bearer $FIDO_API_KEY" \
  -H "X-Tenant-ID: $FIDO_TENANT_ID"

Try it

Responses

200 Invite resent

Invite resent

JSON
{
  "success": true,
  "message": "Invite resent.",
  "data": {
    "inviteState": "invited",
    "inviteExpiresAt": "2026-01-15 09:00:00"
  }
}
Response fields (5)
FieldTypeDescription
successboolean

Example true.

messagestring

Example Invite resent..

dataobject
data.inviteStatestring

Example invited.

data.inviteExpiresAtstring (date-time)

Example 2026-01-15 09:00:00.

401 Not signed in

Missing, invalid or expired API key.

JSON
{
  "success": false,
  "message": "Invalid API key. Org and user tier keys must send an X-Tenant-ID header naming the organization the key was issued for.",
  "errors": null,
  "code": "API_KEY_MISSING"
}
Response fields (4)
FieldTypeDescription
successboolean

Example false.

messagestring

Example Invalid API key. Org and user tier keys must send an X-Tenant-ID header naming the organization the key was issued for..

errorsany or null

Null on this status.

codestring

Machine-readable reason, for branching on in client code.

One of: API_KEY_MISSING, API_KEY_INVALID, API_KEY_EXPIRED. Example API_KEY_MISSING.

403 Not allowed

Invites cannot be resent for this type of account, or the caller may not resend to an admin

JSON
{
  "success": false,
  "message": "You don't have permission to access this endpoint. This API key is missing the 'team:write' scope.",
  "errors": null,
  "code": ""
}
Response fields (4)
FieldTypeDescription
successboolean

Example false.

messagestring

Example You don't have permission to access this endpoint. This API key is missing the 'team:write' scope..

errorsany or null

Null on this status.

codestring

Always empty on this status.

Example .

404 Not found

No account found for the provided user

JSON
{
  "success": false,
  "message": "No account found for the provided user.",
  "errors": null,
  "code": ""
}
Response fields (4)
FieldTypeDescription
successboolean

Example false.

messagestring

Example No account found for the provided user..

errorsany or null
codestring

Example .

409 Conflict

Account has already set a password, or is an admin who has already signed in (including with SSO)

JSON
{
  "success": false,
  "message": "This account has already set a password.",
  "errors": null,
  "code": ""
}
Response fields (4)
FieldTypeDescription
successboolean

Example false.

messagestring

Example This account has already set a password..

errorsany or null
codestring

Example .

422 Validation failed

Account has no login of its own

JSON
{
  "success": false,
  "message": "This account has no login of its own.",
  "errors": null,
  "code": ""
}
Response fields (4)
FieldTypeDescription
successboolean

Example false.

messagestring

Example This account has no login of its own..

errorsany or null
codestring

Example .

429 Too many requests

Resent too recently

JSON
{
  "success": false,
  "message": "You've exceeded this API key's rate limit of 120 requests per minute. Try again in 37 seconds.",
  "errors": null,
  "code": "RATE_LIMITED"
}
Response fields (4)
FieldTypeDescription
successboolean

Example false.

messagestring

Example You've exceeded this API key's rate limit of 120 requests per minute. Try again in 37 seconds..

errorsany or null

Null on this status.

codestring

Machine-readable reason, for branching on in client code.

One of: RATE_LIMITED. Example RATE_LIMITED.