Organisation
List Invites
List the invites sent to join your organisation.
GET
Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive
403 mcp_not_enabled. See the preview overview.status to find the invites still waiting for an answer.
An invite is pending until the invitee accepts it, an admin revokes it, or it passes expires_at. Invites last 30 days. Resend Invite emails a pending invite again and extends it.
The response never includes the join link. The link works like a password for joining your organisation, so Wordsmith only sends it to the invitee’s inbox.
Authentication
Requires an API key, or an OAuth token withdirectory: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.
Inviting is an admin action, so reading the invite list needs the admin scope too.
Query parameters
enum
Return only invites in this state:
pending, accepted or expired. Leave it out for all of them.string
The
cursor from the previous page.integer
default:"50"
Invites per page, up to 200.
Response
Returns200 with a page of invites. invited_by is the id of the member who sent the invite.