Resend Invite

Email a pending invite again and extend how long it stays valid.

POST /api/v1/invites/{invite_id}/resend

cURL

curl -X POST "https://api.wordsmith.ai/api/v1/invites/df242ffe-393a-4615-9164-019b295c9641/resend" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "id": "df242ffe-393a-4615-9164-019b295c9641",
  "email": "[e-mail]",
  "predefined_roles": ["full_user"],
  "custom_role_ids": [],
  "status": "pending",
  "invited_by": "4c98ef69-d5ef-4471-a2b8-89ded5b7b121",
  "created_at": "2026-10-13T09:30:00Z",
  "expires_at": "2026-11-12T15:05:12Z"
}

Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.

Emails a pending or expired invite to the invitee again. An accepted invite cannot be resent. The invite keeps its id and its join link, so an earlier email still works. expires_at moves to 30 days from now.

Wordsmith checks the invite’s roles again before sending. If a role was turned off or deleted since the invite went out, the resend fails, because the invitee could not accept it. Revoke the invite and create a new one with current roles.

Authentication

Requires an API key, or an OAuth token with directory:admin. The caller must also be an organisation admin, or hold a role with the matching permission. directory:admin is never granted by default. It only narrows what the person who approved it can already do, so a team admin’s token can edit their own teams and nothing else. Admin changes are not available through the MCP server.

Resending needs both the permission to see invites and the permission to invite. An invite that carries a custom role also needs the permission to assign roles.

Path parameters

invite_id · string · required

The invite id, from List Invites.

Response

Returns 200 with the invite and its new expires_at.

cURL

curl -X POST "https://api.wordsmith.ai/api/v1/invites/df242ffe-393a-4615-9164-019b295c9641/resend" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "id": "df242ffe-393a-4615-9164-019b295c9641",
  "email": "[e-mail]",
  "predefined_roles": ["full_user"],
  "custom_role_ids": [],
  "status": "pending",
  "invited_by": "4c98ef69-d5ef-4471-a2b8-89ded5b7b121",
  "created_at": "2026-10-13T09:30:00Z",
  "expires_at": "2026-11-12T15:05:12Z"
}

Errors

Status	error_code	When
400	bad_request	A role on the invite was turned off or deleted since it was sent: revoke it and invite again. Also returned when the invite was accepted, and for an invite too old to resend because it predates how Wordsmith now stores join links.
403	insufficient_scope	The OAuth token does not hold directory:admin.
403	forbidden	The caller cannot invite members. Also returned when the invite carries a custom role and the caller cannot assign roles.
404	resource_not_found	No invite in your organisation has this id.