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çãoChamada
Listar os membrosGET /workspace/membersGrátis
Listar os convitesGET /workspace/invitationsGrátis
Convidar um membroPOST /workspace/invitationsGrátis
Cancelar um conviteDELETE /workspace/invitations/{invitationId}Grátis
Atualizar um membroPATCH /workspace/members/{userId}Grátis
Remover um membroDELETE /workspace/members/{userId}Grátis

Listar os membros

GET/workspace/membersGrátis

Os membros do espaço de trabalho e a função de cada um.

Ferramenta MCP list_members

Requisição
curl https://app.semchat.io/api/v1/workspace/members \
  -H "Authorization: Bearer sk_live_…"
Resposta · 200
{
  "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

GET/workspace/invitationsGrátis

Os 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

Requisição
curl https://app.semchat.io/api/v1/workspace/invitations \
  -H "Authorization: Bearer sk_live_…"

Responde 200 com { "data": … }.

Convidar um membro

POST/workspace/invitationsGrátis

Convida 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

ArgumentoTipoDescrição
emailobrigatóriostring
roleobrigatóriostringadmin ou member (padrão).admin | member
Requisição
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

DELETE/workspace/invitations/{invitationId}Grátis

Cancela 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

ArgumentoTipoDescrição
invitationIdno caminhostringO id dele.
Requisição
curl -X DELETE https://app.semchat.io/api/v1/workspace/invitations/{invitationId} \
  -H "Authorization: Bearer sk_live_…"

Responde 200 com { "data": … }.

Atualizar um membro

PATCH/workspace/members/{userId}Grátis

Muda 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

ArgumentoTipoDescrição
userIdno caminhostringO id dele.
roleobrigatóriostringadmin | member
Requisição
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

DELETE/workspace/members/{userId}Grátis

Remove 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

ArgumentoTipoDescrição
userIdno caminhostringO id dele.
Requisição
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.

Pronto para fazer seu site decolar?

Faça sua primeira pergunta - o semchat responde com um plano de ação claro em segundos.

Grátis · sem cadastro · em 5 segundos