Vai al contenuto principale

Workspace

La Workspace API espone accesso in lettura ai metadati del workspace, ai suoi membri e ai suoi team. È la directory a cui ti rivolgi quando devi risolvere l'id di un membro (ad esempio, per indirizzare un messaggio diretto) o enumerare i team.

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"

Disponibile in​

Public APICLIMCPCopera AI
✅ Full✅ Full✅ Full—

La CLI e l'MCP server hostato espongono info del workspace, members e teams. La directory workspace non è esposta all'assistente Copera AI in-app.

Info del workspace​

GET sull'endpoint info per i metadati core del workspace: _id, name, slug, picture e description opzionali, il numero di seats e i timestamp.

Members​

GET sull'endpoint members per elencare le persone nel workspace. Ogni membro include:

  • _id, name, email, picture e title opzionali.
  • type — user, guest, integration, ai o external.
  • status — presence: online, offline, idle o invisible.
  • active — se l'account è attivo.

Query parameter supportati:

  • q — ricerca case-insensitive su nome e email.
  • limit — 1–500 (default 100).
  • offset — page offset (default 0).
suggerimento

Così risolvi lo userId di un membro prima di inviare un messaggio diretto — cerca per nome o email con q, poi usa l'_id restituito.

Teams​

GET sull'endpoint teams per elencare i team del workspace. Ogni team include il suo _id, name, picture opzionale, un flag main (il team default del workspace), i participants (member id), createdBy e i timestamp. Supporta gli stessi parametri q, limit (1–200, default 100) e offset.

Autenticazione e scope​

Gli endpoint Workspace richiedono un Personal Access Token (cp_pat_). Gli utenti external non possono accedere a questo endpoint. Vedi Autenticazione.

Riferimento​