Aller au contenu principal

Workspace

L'API Workspace expose un accès en lecture aux métadonnées de votre workspace, à ses membres et à ses équipes. C'est l'annuaire vers lequel vous vous tournez lorsque vous devez résoudre l'id d'un membre (par exemple pour adresser un message direct) ou énumérer les équipes.

Démarrage rapide​

# 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"

Disponible dans​

Public APICLIMCPCopera AI
✅ Complet✅ Complet✅ Complet—

La CLI et le serveur MCP hébergé exposent les infos workspace, membres et équipes. L'annuaire du workspace n'est pas exposé à l'assistant Copera AI intégré à l'app.

Infos du workspace​

GET l'endpoint info pour les métadonnées de base du workspace : _id, name, slug, picture et description optionnels, le nombre de seats, et des horodatages.

Membres​

GET l'endpoint members pour lister les personnes du workspace. Chaque membre inclut :

  • _id, name, email, picture et title optionnels.
  • type — user, guest, integration, ai ou external.
  • status — présence : online, offline, idle ou invisible.
  • active — si le compte est actif.

Paramètres de requête pris en charge :

  • q — recherche insensible à la casse sur nom et e-mail.
  • limit — 1–500 (défaut 100).
  • offset — offset de page (défaut 0).
astuce

C'est ainsi que vous résolvez le userId d'un membre avant d'envoyer un message direct — recherchez par nom ou e-mail avec q, puis utilisez le _id renvoyé.

Équipes​

GET l'endpoint teams pour lister les équipes du workspace. Chaque équipe inclut son _id, name, picture optionnel, un flag main (l'équipe par défaut du workspace), les participants (ids de membres), createdBy, et des horodatages. Il prend en charge les mêmes paramètres q, limit (1–200, défaut 100) et offset.

Authentification et scope​

Les endpoints workspace exigent un Personal Access Token (cp_pat_). Les utilisateurs externes ne peuvent pas accéder à cet endpoint. Voir Authentification.

Référence​