# Re-send user invitation

URL: /en/docs/api/v1/users/id/invite/post
Last Updated: 2026-07-30T21:15:30.711Z

## Description
No description available.

## Available Actions
- Execute POST request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### POST /api/v1/users/{id}/invite

**Re-send user invitation**

Triggers a new invitation email for an existing tenant user. Only tenant admins can re-send invitations.

Before sending the message, the API verifies:
- The requesting user has the admin role
- The target user exists and belongs to the same tenant
- The user's original role is reused for the invite

Use this endpoint when a teammate loses their invite email or you need to restart the onboarding process.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Path parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | Yes | ID of the user to re-invite |

**Responses:**

- `200` - Invitation email was queued successfully
  - `ok` (boolean): Indicates the invite email was enqueued

  Example (Invite re-sent):
  
  ```json
  {
  "ok": true
}
  ```
- `400` - Bad Request - user ID missing or tenant context invalid
  - `error` (string, required): Human-readable error message
  - `code` (string): Optional machine-readable error code

  Example (Tenant context missing):
  
  ```json
  {
  "error": "Missing tenant context"
}
  ```
- `401` - Unauthorized - missing or invalid authentication token
- `403` - Forbidden - requester is not an admin or user is not part of your tenant
  - `error` (string, required): Human-readable error message
  - `code` (string): Optional machine-readable error code

  Example (Non-admin user):
  
  ```json
  {
  "error": "Admin role required to re-invite users."
}
  ```

  Example (User not in tenant):
  
  ```json
  {
  "error": "User is not part of your tenant"
}
  ```
- `404` - Not Found - user does not exist
  - `error` (string, required): Human-readable error message
  - `code` (string): Optional machine-readable error code

  Example (User not found):
  
  ```json
  {
  "error": "User not found"
}
  ```
- `500` - Internal server error - Directus invite failed
  - `error` (string, required): Human-readable error message
  - `code` (string): Optional machine-readable error code

  Example (Invite error):
  
  ```json
  {
  "error": "Failed to re-send invitation due to an internal error."
}
  ```

**Code samples:**

cURL:

```bash
curl -X POST "https://app.orbiqhq.com/api/v1/users/550e8400-e29b-41d4-a716-446655440000/invite" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

```