---
title: "Re-send a team invite"
method: POST
path: "/organization-roles/{organization_role_id}/resend-invite"
tags: ["Organization Roles"]
---

# Re-send a team invite

`POST /organization-roles/{organization_role_id}/resend-invite`

## Request

- Base URL: `https://api.purplegrain.com/api/v1`
- URL: `https://api.purplegrain.com/api/v1/organization-roles/{organization_role_id}/resend-invite`
- Auth: HTTP bearer

Re-delivers a pending or declined invite (SMS or email) to the invited
identifier: the role flips back to `pending`, the 7-day expiry window
restarts (`invite_sent_at` is refreshed), and the invite keeps the
**same** token — the link in the original message keeps working. Only
an owner of the role's organization may call this (same bar as
transfer-ownership). Resends are throttled per invite (60s cooldown);
inside the cooldown the call is a no-op that still returns the role.

## Path parameters

- `organization_role_id` string, required

## Response `200`

Invite re-sent (or cooldown no-op) — the updated role.

- OrganizationRolesShowResponseAttributes
  - `data` OrganizationRoleModelAttributes: Organization role in attributes-adapter shape (Accept application/json); fields at top level.
    - `id` string
    - `type` string
    - `status` 'pending' | 'accepted' | 'declined'
    - `permission` 'owner' | 'admin' | 'manager' | 'contractor' | 'viewer'
    - `invited_email` string, nullable
    - `invited_mobile` string, nullable
    - `invited` boolean
    - `inviter_name` string: Display name of the inviter (the organization owner).
    - `updated_at` string, date-time
    - `created_at` string, date-time
    - `organization` object: Inlined when include=organization
    - `user` object: Inlined when include=user

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden — caller is not an owner of the organization.
- `404`: Not Found
- `422`: Role is not a resendable invite (already attached to a member).

---

[API](https://skmtc.dev/purplegrain/apis/purple-grain-api.md) · [All operations](https://skmtc.dev/purplegrain/apis/purple-grain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/purplegrain/apis/purple-grain-api/revisions/06540345bbbc?raw)