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 <code>flow_ws_</code> workspace API token reaches only its own workspace, so the list has one entry. <code>current</code> marks the workspace this call landed in. Only workspaces where you hold <code>flowsery.write</code>, the Admin and Editor roles, are listed.

Website keys answer 400

A <code>flow_</code> website API key is scoped to one website and has no member behind it, so this endpoint answers <code>400 Bad Request</code>. 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
    }
  ]
}