Registra uma 1:1
POST/api/one-on-ones/meetings
- Auth
- Exige token
- Quem pode:
- owner
- admin
- Chave de API:
- Não aceita chave de API
- X-CommunityId
X-CommunityIdEnvie o X-CommunityId da comunidade em que a operação acontece.
Registra uma 1:1 que aconteceu (ou que vai acontecer) com o líder direto ou com um liderado direto (`withMemberId`). Qualquer papel, inclusive owner e admin, registra só as próprias 1:1s: quem pede é sempre um dos dois. Fora do par direto do organograma: 403 `notDirectPair`; pessoa inexistente: 422 `pairInvalid`; os dois precisam abrir o espaço (422 `personNoAccess`).
`date` é um dia (`AAAA-MM-DD`, com `time` opcional, padrão 09:00 no fuso da comunidade) ou uma data-hora ISO. Hoje ou antes: a reunião entra **feita** e os assuntos entram como conversados. Depois de hoje: entra **marcada**, sem convite e sem lembrete, e vira feita quando um dos dois conclui (`/meetings/{meetingId}/done`). Passado livre; até um ano à frente.
A reunião vai para a série interna de registros do par (`kind: LOG`, criada no primeiro registro); a série recorrente do par, se houver, não muda. Dois registros do mesmo par no mesmo dia são aceitos. Nenhum e-mail ou `.ics`: o outro participante recebe só o aviso no sino (`oneOnOnes.logged`, com `data.meetingId` e `data.date`, sem pauta nem nota). A nota só minha (`privateNote`) só o autor lê, por qualquer caminho.
Headers
| Nome | Tipo | Descrição |
|---|---|---|
X-CommunityIdopcional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Corpo da requisição application/json
| Nome | Tipo | Descrição |
|---|---|---|
spaceIdopcional | string (uuid) | Obrigatório só quando a comunidade tem mais de um espaço 1:1. |
withMemberIdobrigatório | string (uuid) | O líder direto ou um liderado direto de quem pede. |
dateobrigatório | string | Dia (AAAA-MM-DD) ou data-hora ISO. |
timeopcional | string | HH:mm no fuso da comunidade (padrão 09:00). |
durationMinutesopcional | integer | ≥ 10, ≤ 240 |
topicsopcional | string[] | Assuntos tratados. |
sharedNoteopcional | string | Nota compartilhada (HTML, sanitizado). |
privateNoteopcional | string | Nota só minha (HTML, sanitizado): só o autor lê. |
actionsopcional | object[] | |
actions[].titleobrigatório | string | max 200 |
actions[].ownerIdopcional | string (uuid) | Um dos dois (padrão: quem registra). |
actions[].dueOnopcional | string (date) |
Respostas
| Código | Descrição |
|---|---|
201 | A reunião. |
400 | Requisição inválida — falha de validação. |
401 | Token ausente, inválido ou expirado; token de outra comunidade (o `X-CommunityId` ou o `communityId` do corpo não é o do token); token antigo ou de uma sessão encerrada (troca de senha, convite aceito). Nesses casos a mensagem pede para entrar de novo (`auth.signInAgain`). |
403 | Autenticado, mas sem permissão para esta operação. |
404 | Recurso não encontrado. |
422 | Par, data, hora, duração, assuntos, nota ou combinados inválidos; pessoa sem acesso ao espaço. |
500 | Erro interno do servidor. |
Exemplo com curl
curl -X POST "https://api.memberfy.net/api/one-on-ones/meetings" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{"withMemberId":"00000000-0000-0000-0000-000000000000","date":"2026-10-22"}'