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 flow_ws_-Workspace-API-Token erreicht nur seinen eigenen Workspace, die Liste hat also einen Eintrag. current markiert den Workspace, in dem dieser Aufruf gelandet ist. Aufgeführt werden nur Workspaces, in denen Sie flowsery.write haben, also die Rollen Admin und Editor.

Website-Schlüssel erhalten 400

Ein flow_-Website-API-Schlüssel gilt für eine Website und hat kein Mitglied hinter sich, daher antwortet dieser Endpunkt mit 400 Bad Request. 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
    }
  ]
}