Zum Hauptinhalt springen

Workspace

Die Workspace-API stellt Lesezugriff auf die Metadaten Ihres Workspace, seine Members und seine Teams bereit. Das ist das Verzeichnis, das Sie greifen, wenn Sie die ID eines Members auflösen müssen (z. B. um eine Direktnachricht zu adressieren) oder Teams aufzählen wollen.

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"

Verfügbar in​

Public APICLIMCPCopera AI
✅ Voll✅ Voll✅ Voll—

Die CLI und der gehostete MCP-Server stellen Workspace-Info, Members und Teams bereit. Das Workspace-Verzeichnis ist dem In-App-Assistenten Copera AI nicht freigegeben.

Workspace-Info​

GET auf den info-Endpunkt liefert die Kern-Metadaten des Workspace: _id, name, slug, optionales picture und description, die Anzahl der seats und Zeitstempel.

Members​

GET auf den members-Endpunkt listet die Personen im Workspace. Jedes Member enthält:

  • _id, name, email, optionales picture und title.
  • type — user, guest, integration, ai oder external.
  • status — Presence: online, offline, idle oder invisible.
  • active — ob das Konto aktiv ist.

Unterstützte Query-Parameter:

  • q — groß-/kleinschreibungsunabhängige Suche über Name und E-Mail.
  • limit — 1–500 (Standard 100).
  • offset — Seiten-Offset (Standard 0).
tipp

So lösen Sie die userId eines Members auf, bevor Sie eine Direktnachricht senden — suchen Sie mit q nach Name oder E-Mail und nutzen Sie die zurückgegebene _id.

Teams​

GET auf den teams-Endpunkt listet die Teams des Workspace. Jedes Team enthält _id, name, optionales picture, ein Flag main (das Standard-Team des Workspace), die participants (Member-IDs), createdBy und Zeitstempel. Es unterstützt dieselben Parameter q, limit (1–200, Standard 100) und offset.

Authentifizierung & Scope​

Workspace-Endpunkte erfordern ein Personal Access Token (cp_pat_). Externe Benutzer können diesen Endpunkt nicht nutzen. Siehe Authentifizierung.

Referenz​