Pular para o conteúdo principal

Workspace

A Workspace API expõe acesso de leitura aos metadados do seu workspace, seus membros e seus times. É o diretório que você consulta quando precisa resolver o id de um membro (por exemplo, para enviar uma mensagem direta) ou para enumerar times.

Quick Start​

# Read workspace metadata
curl -X GET https://api.copera.ai/public/v1/workspace/info \
  -H "Authorization: Bearer cp_pat_YOUR_TOKEN"

# List members (search by name or email with q)
curl -X GET "https://api.copera.ai/public/v1/workspace/members?q=alice" \
  -H "Authorization: Bearer cp_pat_YOUR_TOKEN"

# List teams
curl -X GET https://api.copera.ai/public/v1/workspace/teams \
  -H "Authorization: Bearer cp_pat_YOUR_TOKEN"

Disponível em​

Public APICLIMCPCopera AI
✅ Completo✅ Completo✅ Completo—

A CLI e o servidor MCP hospedado expõem info do workspace, membros e times. O diretório do workspace não é exposto ao assistente Copera AI dentro do app.

Info do workspace​

Faça um GET no endpoint info para os metadados centrais do workspace: _id, name, slug, picture e description opcionais, o número de seats e timestamps.

Membros​

Faça um GET no endpoint members para listar as pessoas do workspace. Cada membro inclui:

  • _id, name, email, picture e title opcionais.
  • type — user, guest, integration, ai ou external.
  • status — presença: online, offline, idle ou invisible.
  • active — se a conta está ativa.

Parâmetros de query suportados:

  • q — busca case-insensitive por nome e email.
  • limit — 1–500 (padrão 100).
  • offset — offset de página (padrão 0).
dica

É assim que você resolve o userId de um membro antes de enviar uma mensagem direta — busque por nome ou email com q, depois use o _id retornado.

Times​

Faça um GET no endpoint teams para listar os times do workspace. Cada time inclui seu _id, name, picture opcional, uma flag main (o time padrão do workspace), os participants (ids de membros), createdBy e timestamps. Ele suporta os mesmos parâmetros q, limit (1–200, padrão 100) e offset.

Autenticação e escopo​

Os endpoints de Workspace requerem um Personal Access Token (cp_pat_). Usuários externos não podem acessar este endpoint. Veja Autenticação.

Referência​