Listar workspaces

api-referenceGET

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

Lista los workspaces en los que esta credencial puede actuar. Envía un id devuelto en la cabecera X-Workspace-Id para ejecutar cualquier otra solicitud en ese workspace.

Token Bearer (token API de workspace o inicio de sesión OAuth)

Quién ve qué workspaces

Un inicio de sesión OAuth, como el conector de Claude o ChatGPT, llega a todos los workspaces a los que pertenece su miembro, en todas sus organizaciones. Un token API de workspace <code>flow_ws_</code> solo llega a su propio workspace, así que la lista tiene una entrada. <code>current</code> marca el workspace en el que cayó esta llamada. Solo se listan los workspaces donde tienes <code>flowsery.write</code>, es decir, los roles Admin y Editor.

Las claves de sitio web reciben 400

Una clave API de sitio web <code>flow_</code> está limitada a un sitio y no tiene un miembro detrás, así que este endpoint responde <code>400 Bad Request</code>. Usa un token API de workspace o un inicio de sesión OAuth.

Campos de respuesta

Parametro	Tipo	Descripcion
`id`	`string`	ID del workspace. Envíalo en la cabecera X-Workspace-Id para actuar en este workspace.
`name`	`string`	Nombre del workspace.
`organization.id`	`string`	ID de la organización propietaria del workspace.
`organization.name`	`string`	Nombre de la organización propietaria del workspace.
`role.key`	`string`	Tu rol en este workspace: admin o editor, los roles que pueden usar Flowsery.
`role.name`	`string`	Nombre visible del rol.
`permissions`	`string[]`	Claves de permiso que tienes en este workspace, como flowsery.write.
`isDefault`	`boolean`	True para el workspace en el que cae una llamada cuando no envías la cabecera X-Workspace-Id.
`current`	`boolean`	True para el workspace en el que cayó esta llamada.

Solicitud de ejemplo (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
    }
  ]
}