Aller à la documentation
API

Lister vos espaces de travail

Chaque espace de travail que la personne peut ouvrir, ceux dont elle est propriétaire d'abord, comme le sélecteur d'espace de travail de l'application les liste.

GET/workspaces

Exécute le véritable appel sur votre espace de travail.

GET /workspaces

Chaque espace de travail que la personne peut ouvrir, ceux dont elle est propriétaire d'abord, comme le sélecteur d'espace de travail de l'application les liste.

Exemple

Nécessite account:read. activeWorkspaceId est l'espace de travail que l'application ouvre pour la personne, primaryWorkspaceId le premier qu'elle a créé, qui ne peut jamais être supprimé, et personalWorkspaceId son espace personnel, qui contient son adresse gratuite et n'est pas listé dans data.

curl
curl "$OE/workspaces" -H "$AUTH"
Réponse
{  "object": "list",  "data": [    {      "object": "workspace",      "id": "10417196-e324-4283-af98-66ec62167c47",      "name": "Acme",      "slug": "acme",      "email": "[email protected]",      "isOwner": true,      "ownerId": "q7Vd3kX9mT2pLw8RzN4bYc6HfJ1sGa5E",      "plan": "business",      "markUrl": null,      "wordmarkUrl": null,      "createdAt": "2026-08-01T10:00:00.000Z"    }  ],  "activeWorkspaceId": "10417196-e324-4283-af98-66ec62167c47",  "primaryWorkspaceId": "10417196-e324-4283-af98-66ec62167c47",  "personalWorkspaceId": "5b1e7c40-2d9a-4f63-b8e1-0c4d7a2f9e15"}

Ces appels agissent sur une personne, pas sur un espace de travail. Une clé API agit pour le propriétaire de l'espace de travail auquel elle appartient, et une application pour la personne qui l'a connectée. La lecture nécessite account:read et chaque modification account:write, et aucun rôle ne limite l'un ou l'autre.

La clé ou l'application elle-même agit toujours pour un seul espace de travail dans tous les autres appels. Rien ici ne l'élargit.

Référence