---
title: "Invite users to organization"
method: POST
path: "/api/{org_id}/invites"
tags: ["Organizations"]
---

# Invite users to organization

`POST /api/{org_id}/invites`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/invites`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/invites/post.ts> (a function with typed inputs; its response is checked against the schema)

Sends invitations to one or more users to join the organization. Invited users will receive email invitations with links to accept and join the organization with the specified roles and permissions.

## Path parameters

- `org_id` string, required

## Request body

- object
  - `invites` string[]
  - `role` 'root' | 'admin' | 'editor' | 'viewer' | 'user' | 'service_account' | 'sre_agent', required

## Response `200`

Success

- object
  - `data` OrganizationInviteResponseData
    - `existing_members` string[], nullable
    - `invalid_email` string, nullable
    - `valid_members` string[], nullable
  - `message` string, required

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)