Workspaces auflisten

api-referenceGET

GEThttps://analytics.flowsery.com/analytics/api/v1/workspaces

Listet die Workspaces auf, in denen diese Zugangsdaten handeln können. Senden Sie eine zurückgegebene id im Header X-Workspace-Id, um jede andere Anfrage in diesem Workspace auszuführen.

Bearer-Token (Workspace-API-Token oder OAuth-Anmeldung)

Wer welche Workspaces sieht

Eine OAuth-Anmeldung, etwa über den Claude- oder ChatGPT-Connector, erreicht jeden Workspace, dem das Mitglied angehört, über Organisationen hinweg. Ein <code>flow_ws_</code>-Workspace-API-Token erreicht nur seinen eigenen Workspace, die Liste hat also einen Eintrag. <code>current</code> markiert den Workspace, in dem dieser Aufruf gelandet ist. Aufgeführt werden nur Workspaces, in denen Sie <code>flowsery.write</code> haben, also die Rollen Admin und Editor.

Website-Schlüssel erhalten 400

Ein <code>flow_</code>-Website-API-Schlüssel gilt für eine Website und hat kein Mitglied hinter sich, daher antwortet dieser Endpunkt mit <code>400 Bad Request</code>. Verwenden Sie ein Workspace-API-Token oder eine OAuth-Anmeldung.

Antwortfelder

Parameter	Typ	Beschreibung
`id`	`string`	Workspace-ID. Senden Sie sie im Header X-Workspace-Id, um in diesem Workspace zu handeln.
`name`	`string`	Name des Workspace.
`organization.id`	`string`	ID der Organisation, der der Workspace gehört.
`organization.name`	`string`	Name der Organisation, der der Workspace gehört.
`role.key`	`string`	Ihre Rolle in diesem Workspace: admin oder editor, die Rollen, die Flowsery nutzen können.
`role.name`	`string`	Anzeigename der Rolle.
`permissions`	`string[]`	Berechtigungsschlüssel, die Sie in diesem Workspace haben, zum Beispiel flowsery.write.
`isDefault`	`boolean`	True für den Workspace, in dem ein Aufruf ohne Header X-Workspace-Id landet.
`current`	`boolean`	True für den Workspace, in dem dieser Aufruf gelandet ist.

Beispielanfrage (curl)

curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/workspaces \
  --header 'Authorization: Bearer <workspace-api-token>'

200

{
  "status": "success",
  "data": [
    {
      "id": "cm8ws1a2b3",
      "name": "Acme marketing",
      "organization": { "id": "org_01J8ZK4M2Q", "name": "Acme" },
      "role": { "key": "editor", "name": "Editor" },
      "permissions": [
        "workspace.read",
        "posts.read",
        "accounts.read",
        "posts.draft",
        "media.upload",
        "analytics.read",
        "ai.generate",
        "members.read",
        "tokens.own",
        "posts.others",
        "posts.schedule",
        "posts.publish",
        "posts.delete",
        "analytics.sync",
        "webhooks.read",
        "webhooks.manage",
        "signature.manage",
        "flowsery.write",
        "redreplier.write",
        "claw.use"
      ],
      "isDefault": true,
      "current": true
    },
    {
      "id": "cm8ws4c5d6",
      "name": "Northwind",
      "organization": { "id": "org_01J9P7T3XB", "name": "Northwind Studio" },
      "role": { "key": "admin", "name": "Admin" },
      "permissions": [
        "workspace.read",
        "workspace.manage",
        "posts.read",
        "posts.draft",
        "posts.others",
        "posts.schedule",
        "posts.publish",
        "posts.delete",
        "media.upload",
        "accounts.read",
        "accounts.manage",
        "analytics.read",
        "analytics.sync",
        "ai.generate",
        "members.read",
        "members.manage",
        "tokens.own",
        "tokens.manage",
        "webhooks.read",
        "webhooks.manage",
        "signature.manage",
        "flowsery.write",
        "redreplier.write",
        "claw.use"
      ],
      "isDefault": false,
      "current": false
    }
  ]
}