Convidar membro · API

POST/api/v1/orgs/{orgId}/invites

Exige Authorization: Bearer com um access token.

curl -X POST "https://api.onny.space/api/v1/orgs/<orgId>/invites" \
  -H "Authorization: Bearer $ONNY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"email":"ana@exemplo.com","role":"texto"}'

POSTapi.onny.space/api/v1/orgs/%7BorgId%7D/invites

Access tokenorgId caminho · uuid · obrigatórioCorpo application/json

{
  "email": "ana@exemplo.com",
  "role": "texto"
}

Envie a requisição para ver status, tempo e corpo da resposta.

Parâmetros de caminho

orgIduuidobrigatório

Corpo da requisição application/json

emailstringobrigatório
E-mail de quem vai entrar.
máx. 256
rolestringobrigatório
Papel: owner, admin, developer ou billing. Só o owner convida outro owner.

Respostas

200OK

{
  "invite": {
    "id": "01923f4e-7b1a-7c3d-9e2f-5a6b7c8d9e0f",
    "email": "ana@exemplo.com",
    "role": "texto",
    "invitedBy": "texto",
    "createdAt": "2026-10-11T12:00:00+00:00",
    "expiresAt": "2026-10-11T12:00:00+00:00"
  },
  "token": "texto"
}

2 campos descrição de cada um

inviteobject
O convite.
- iduuid
  Id do convite.
- emailstring
  E-mail convidado.
- rolestring
  Papel que a pessoa terá.
- invitedBystring | null
  Quem convidou.
- createdAtdatetime
  Criado em.
- expiresAtdatetime
  Expira em.
tokenstring
Token do link, mostrado só agora. O link é https://onny.space/convite/{token}.

400Bad Request

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "auth.invalid / validation",
  "status": 400,
  "detail": "Mensagem legível para pessoas.",
  "code": "auth.invalid / validation",
  "traceId": "00-4bf9…-01"
}

401Unauthorized

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Mensagem legível para pessoas.",
  "code": "Unauthorized",
  "traceId": "00-4bf9…-01"
}

403Forbidden

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "error",
  "status": 403,
  "detail": "Mensagem legível para pessoas.",
  "code": "error",
  "traceId": "00-4bf9…-01"
}

404Not Found

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "error",
  "status": 404,
  "detail": "Mensagem legível para pessoas.",
  "code": "error",
  "traceId": "00-4bf9…-01"
}

409Conflict

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "error",
  "status": 409,
  "detail": "Mensagem legível para pessoas.",
  "code": "error",
  "traceId": "00-4bf9…-01"
}

{ "invite": { "id": "01923f4e-7b1a-7c3d-9e2f-5a6b7c8d9e0f", "email": "ana@exemplo.com", "role": "texto", "invitedBy": "texto", "createdAt": "2026-10-11T12:00:00+00:00", "expiresAt": "2026-10-11T12:00:00+00:00" }, "token": "texto" }

{ "type": "https://tools.ietf.org/html/rfc9110", "title": "auth.invalid / validation", "status": 400, "detail": "Mensagem legível para pessoas.", "code": "auth.invalid / validation", "traceId": "00-4bf9…-01" }