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 flow_ws_ solo llega a su propio workspace, así que la lista tiene una entrada. current marca el workspace en el que cayó esta llamada. Solo se listan los workspaces donde tienes flowsery.write, es decir, los roles Admin y Editor.

Las claves de sitio web reciben 400

Una clave API de sitio web flow_ está limitada a un sitio y no tiene un miembro detrás, así que este endpoint responde 400 Bad Request. 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
    }
  ]
}