Zur Dokumentation springen
API

Ihre Workspaces auflisten

Jeder Workspace, den die Person öffnen kann, die eigenen zuerst, so wie der Workspace-Umschalter der App sie auflistet.

GET/workspaces

Führt den echten Aufruf in Ihrem Workspace aus.

GET /workspaces

Jeder Workspace, den die Person öffnen kann, die eigenen zuerst, so wie der Workspace-Umschalter der App sie auflistet.

Beispiel

Erfordert account:read. activeWorkspaceId ist der Workspace, den die App für die Person öffnet, primaryWorkspaceId der erste, den sie angelegt hat und der sich nie löschen lässt, und personalWorkspaceId ihr persönlicher Workspace, der ihre kostenlose Adresse enthält und nicht in data steht.

curl
curl "$OE/workspaces" -H "$AUTH"
Antwort
{  "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"}

Diese Aufrufe wirken auf eine Person, nicht auf einen Workspace. Ein API-Schlüssel handelt für den Inhaber des Workspace, zu dem er gehört, eine App für die Person, die sie verbunden hat. Lesen erfordert account:read und jede Änderung account:write, und keine Rolle schränkt eines davon ein.

Der Schlüssel oder die App selbst handelt in jedem anderen Aufruf weiterhin für genau einen Workspace. Nichts hier erweitert das.

Referenz