---
title: "Enviar convites"
method: POST
path: "/api/management/invites"
tags: ["invites"]
---

# Enviar convites

`POST /api/management/invites`

## Request body

- object — Payload para criar um ou mais convites (um por e-mail), com papéis e permissões de acesso a funis.
  - `emails` string[] — Lista de e-mails que receberão convite. Cada e-mail gera um convite dentro da mesma requisição.
  - `role_ids` integer[] — Lista de IDs de papéis (roles) que serão atribuídos ao convidado ao aceitar o convite.
  - `funnel_access` object[] — Lista de permissões por funil que o convidado terá ao aceitar o convite.
    - `project_funnel_id` integer — ID do funil ao qual as permissões se aplicam.
    - `index_all` boolean — Permite listar/visualizar todos os projetos do funil, independentemente de atribuição ou autoria.
    - `index_assigned` boolean — Permite listar/visualizar apenas os projetos do funil atribuídos ao usuário.
    - `index_created` boolean — Permite listar/visualizar apenas os projetos do funil criados pelo usuário.
    - `step_change` boolean — Permite mover projetos de etapa dentro do funil.

## Response `201`

Sucesso

- object
  - `response` boolean
  - `invites` object[]
    - `id` integer
    - `frame_id` string
    - `email` string, email
    - `role_ids` integer[]
    - `funnel_access` object[]
      - `project_funnel_id` integer
      - `index_all` boolean
      - `index_assigned` boolean
      - `index_created` boolean
      - `step_change` boolean
    - `token` string
    - `updated_at` string, date-time
    - `created_at` string, date-time

## Other responses

- `401` — Não autorizado
- `422` — Convite já enviado para este e-mail

---

[API](https://skmtc.net/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.net/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/063de6e2e93c/schema)