List workspaces | Flowsery

api-referenceGET

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

List the workspaces this credential can act in. Send a returned id in the X-Workspace-Id header to run any other request in that workspace.

Bearer token (workspace API token or OAuth sign-in)

Who sees which workspaces

An OAuth sign-in, such as the Claude or ChatGPT connector, reaches every workspace its member belongs to, across organizations. A flow_ws_ workspace API token reaches only its own workspace, so the list has one entry. current marks the workspace this call landed in. Only workspaces where you hold flowsery.write, the Admin and Editor roles, are listed.

Website keys answer 400

A flow_ website API key is scoped to one website and has no member behind it, so this endpoint answers 400 Bad Request. Use a workspace API token or an OAuth sign-in.

Response fields

Parameter	Type	Description
`id`	`string`	Workspace ID. Send it in the X-Workspace-Id header to act in this workspace.
`name`	`string`	Workspace name.
`organization.id`	`string`	ID of the organization that owns the workspace.
`organization.name`	`string`	Name of the organization that owns the workspace.
`role.key`	`string`	Your role in this workspace: admin or editor, the roles that can use Flowsery.
`role.name`	`string`	Display name of the role.
`permissions`	`string[]`	Permission keys you hold in this workspace, such as flowsery.write.
`isDefault`	`boolean`	True for the workspace a call lands in when you send no X-Workspace-Id header.
`current`	`boolean`	True for the workspace this call landed in.

Example request (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
    }
  ]
}