DocumentaçãoReferência da API
Membros
Os membros do espaço de trabalho, as funções deles e os convites.
Cada operação abaixo também é uma ferramenta MCP, com o mesmo nome. As operações marcadas Grátis não custam nada; as marcadas Cobrado usam os créditos do espaço de trabalho, como no aplicativo (Quanto custa).
| Operação | Chamada | |
|---|---|---|
| Listar os membros | GET /workspace/members | Grátis |
| Listar os convites | GET /workspace/invitations | Grátis |
| Convidar um membro | POST /workspace/invitations | Grátis |
| Cancelar um convite | DELETE /workspace/invitations/{invitationId} | Grátis |
| Atualizar um membro | PATCH /workspace/members/{userId} | Grátis |
| Remover um membro | DELETE /workspace/members/{userId} | Grátis |
Listar os membros
/workspace/membersGrátisOs membros do espaço de trabalho e a função de cada um.
Ferramenta MCP list_members
curl https://app.semchat.io/api/v1/workspace/members \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"user_id": "01995d03-8ea0-7e30-9bc8-4a6a79a79b4f",
"name": "Olivia Owner",
"email": "owner@example.com",
"role": "owner",
"joined_at": "2025-09-18T13:28:58.000Z"
},
{
"user_id": "01995d05-6360-74e9-8aa2-63377289227a",
"name": "Adam Admin",
"email": "admin@example.com",
"role": "admin",
"joined_at": "2026-07-15T13:26:58.000Z"
}
]
}Listar os convites
/workspace/invitationsGrátisOs convites pendentes do espaço de trabalho.
- Só o proprietário ou um administrador (a função de quem criou a chave): caso contrário, 403 FORBIDDEN.
Ferramenta MCP list_invitations
curl https://app.semchat.io/api/v1/workspace/invitations \
-H "Authorization: Bearer sk_live_…"Responde 200 com { "data": … }.
Convidar um membro
/workspace/invitationsGrátisConvida alguém para o espaço de trabalho por e-mail: a pessoa recebe o e-mail de convite, válido por 7 dias.
- Só o proprietário ou um administrador (a função de quem criou a chave): caso contrário, 403 FORBIDDEN.
- 409 CONFLICT quando o e-mail já é de um membro ou já foi convidado.
Ferramenta MCP invite_member
| Argumento | Tipo | Descrição |
|---|---|---|
emailobrigatório | string | |
roleobrigatório | string | admin ou member (padrão).admin | member |
curl -X POST https://app.semchat.io/api/v1/workspace/invitations \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"email": "name@example.com", "role": "admin"}'Responde 201 com { "data": … }.
Cancelar um convite
/workspace/invitations/{invitationId}GrátisCancela um convite: o link dele para de funcionar.
- Só o proprietário ou um administrador (a função de quem criou a chave): caso contrário, 403 FORBIDDEN.
Ferramenta MCP cancel_invitation
| Argumento | Tipo | Descrição |
|---|---|---|
invitationIdno caminho | string | O id dele. |
curl -X DELETE https://app.semchat.io/api/v1/workspace/invitations/{invitationId} \
-H "Authorization: Bearer sk_live_…"Responde 200 com { "data": … }.
Atualizar um membro
/workspace/members/{userId}GrátisMuda a função de um membro (admin ou member).
- Só o proprietário ou um administrador (a função de quem criou a chave): caso contrário, 403 FORBIDDEN.
- userId como list_members mostra. A função do proprietário não pode ser alterada.
Ferramenta MCP update_member
| Argumento | Tipo | Descrição |
|---|---|---|
userIdno caminho | string | O id dele. |
roleobrigatório | string | admin | member |
curl -X PATCH https://app.semchat.io/api/v1/workspace/members/{userId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"role": "admin"}'Responde 200 com { "data": … }.
Remover um membro
/workspace/members/{userId}GrátisRemove um membro do espaço de trabalho.
- Proprietário ou administrador, exceto para remover a si mesmo (quem criou a chave sai do espaço de trabalho). O proprietário não pode ser removido.
Ferramenta MCP remove_member
| Argumento | Tipo | Descrição |
|---|---|---|
userIdno caminho | string | O id dele. |
curl -X DELETE https://app.semchat.io/api/v1/workspace/members/{userId} \
-H "Authorization: Bearer sk_live_…"Responde 200 com { "data": … }.
Não encontrou a resposta? Fale com a gente.

