Lister les workspaces

api-referenceGET

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

Liste les workspaces dans lesquels ces identifiants peuvent agir. Envoyez un id renvoyé dans l’en-tête X-Workspace-Id pour exécuter toute autre requête dans ce workspace.

Jeton Bearer (jeton API workspace ou connexion OAuth)

Qui voit quels workspaces

Une connexion OAuth, comme le connecteur Claude ou ChatGPT, atteint chaque workspace dont son membre fait partie, dans toutes ses organisations. Un jeton API workspace <code>flow_ws_</code> n’atteint que son propre workspace, la liste contient donc une seule entrée. <code>current</code> indique le workspace dans lequel cet appel a abouti. Seuls les workspaces où vous détenez <code>flowsery.write</code>, soit les rôles Admin et Editor, sont listés.

Les clés de site reçoivent 400

Une clé API de site <code>flow_</code> est limitée à un site et n’a aucun membre derrière elle, donc cet endpoint répond <code>400 Bad Request</code>. Utilisez un jeton API workspace ou une connexion OAuth.

Champs de réponse

Parametre	Taper	Description
`id`	`string`	ID du workspace. Envoyez-le dans l’en-tête X-Workspace-Id pour agir dans ce workspace.
`name`	`string`	Nom du workspace.
`organization.id`	`string`	ID de l’organisation propriétaire du workspace.
`organization.name`	`string`	Nom de l’organisation propriétaire du workspace.
`role.key`	`string`	Votre rôle dans ce workspace : admin ou editor, les rôles qui peuvent utiliser Flowsery.
`role.name`	`string`	Nom affiché du rôle.
`permissions`	`string[]`	Clés de permission que vous détenez dans ce workspace, par exemple flowsery.write.
`isDefault`	`boolean`	True pour le workspace dans lequel un appel aboutit quand vous n’envoyez pas d’en-tête X-Workspace-Id.
`current`	`boolean`	True pour le workspace dans lequel cet appel a abouti.

Exemple de requête (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
    }
  ]
}