---
title: "Invite Active Organization Member"
method: POST
path: "/v1/organizations/me/member-invitations"
tags: ["organizations"]
---

# Invite Active Organization Member

`POST /v1/organizations/me/member-invitations`

Invite an address to the caller's active organization by email.

Organization owners and admins only. Unlike ``POST /me/members``, the
membership lands ``invited`` rather than ``active``: it becomes active
once the recipient accepts (``POST /v1/invitations/accept``). The response
always carries the accept link, whether or not it was actually emailed
(``mail_sent``), so an operator can share it themselves when mail is not
configured or the send fails.

## Request body

- InviteOrganizationMemberRequest — Invite an address to the caller's organization, optionally into workspaces at once. Field-for-field ``ActiveOrganizationMemberCreateRequest``'s twin: the two requests ask for the same thing and differ only in what creating one produces (this lands ``invited`` and emails a link; that lands ``active`` immediately).
  - `email` string, email, required
  - `role` 'owner' | 'admin' | 'member' | 'viewer'
  - `workspace_assignments` WorkspaceAssignmentRequest[], nullable
    - `role` 'owner' | 'admin' | 'member' | 'viewer'
    - `workspace_id` string, uuid, required

## Response `201`

Successful Response

- InviteOrganizationMemberResultPublic — What issuing an invitation produces, and whether the email actually went out.
  - `accept_link` string, required
  - `created_at` string, date-time, required
  - `email` string, required
  - `expires_at` string, date-time, required
  - `invitation_id` string, uuid, required
  - `mail_sent` boolean, required — Whether the invitation email was actually dispatched. False when mail is not configured, or the send itself failed; accept_link is set either way, so the operator can share it themselves rather than the invitation being a dead end.
  - `organization_member_id` string, uuid, required
  - `role` string, required
  - `status` 'invited'

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.net/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mozilla-ai/otari/revisions/2d6e4912e230/schema)