Skip to content
memberfy
US

Entrar no programa ("Quero ser mentor", "Participar")

POST/api/networking/participants/me

Auth
Requires a token
Who can call it:
owner
admin
API key:
networking:write
X-CommunityId
X-CommunityId Send the X-CommunityId of the community the operation happens in.
Endpoint descriptions come straight from the API specification and are in Portuguese for now. The interface around them is translated.

Quem chama entra no espaço de Networking. No modelo simétrico o lado é sempre `BOTH` ("Participar": oferece e marca); no de mentoria, `side` é `HOST` ou `PARTICIPANT`. A regra do lado decide: `OPEN` entra direto (`ACTIVE`, aparece no Explorar), `APPROVAL` fica `PENDING` e owner e admin recebem e-mail (categoria "Networking") e veem o contador; `INVITE` só a equipe adiciona (403). Owner e admin entram sempre direto. Ser anfitrião exige papel permitido por `offerers` (403) e, se o espaço tiver regra de anfitrião (`PUT /api/networking/host-rule`), casar com um dos grupos, tags ou badges (403 `hostNotEligible`). Já participando: 409; removido pela equipe: 403. Quem foi recusado pode pedir de novo. No modelo de mentoria, desde 2026-10-29, ninguém precisa entrar como `PARTICIPANT` para marcar: quem abre o espaço já é mentorado. `side: PARTICIPANT` continua aceito (para guardar `seeks` e categorias), mas é opcional; quem tem participação `PARTICIPANT` viva pode pedir `side: HOST` (a participação passa para o lado anfitrião, sem 409).

Headers

NameTypeDescription
X-CommunityIdoptionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Request body application/json

NameTypeDescription
spaceIdrequiredstring (uuid)
sideoptionalHOST | PARTICIPANTObrigatório no modelo de mentoria; ignorado no simétrico.
offersoptionalstringmax 1000
seeksoptionalstringmax 1000
categoryKeysoptionalstring[]

Responses

StatusDescription
201Entrou (`ACTIVE`) ou pediu (`PENDING`).
400Requisição inválida — falha de validação.
401Token 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`).
403Autenticado, mas sem permissão para esta operação.
409Conflito com o estado atual do recurso.
500Erro interno do servidor.

curl example

curl -X POST "https://api.memberfy.net/api/networking/participants/me" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{"spaceId":"00000000-0000-0000-0000-000000000000"}'