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

Toon de werkruimtes waarin deze sleutel kan werken. Stuur een teruggegeven id mee in de X-Workspace-Id-header om elk ander verzoek in die werkruimte uit te voeren.

Bearer-token (werkruimte-API-token of OAuth-login)

Wie welke werkruimtes ziet

Een OAuth-login, zoals de connector voor Claude of ChatGPT, kan bij elke werkruimte waar het lid toe behoort, over organisaties heen. Een flow_ws_-werkruimte-API-token kan alleen bij de eigen werkruimte, dus de lijst bevat één item. current markeert de werkruimte waarin deze aanroep terechtkwam. Alleen werkruimtes waarin je flowsery.write hebt, dus met de rol Admin of Editor, worden getoond.

Websitesleutels krijgen 400

Een flow_-website-API-sleutel hoort bij één website en heeft geen lid erachter, dus dit endpoint antwoordt met 400 Bad Request. Gebruik een werkruimte-API-token of een OAuth-login.

Velden in het antwoord

ParameterTypeBeschrijving
idstringWerkruimte-ID. Stuur het mee in de X-Workspace-Id-header om in deze werkruimte te werken.
namestringNaam van de werkruimte.
organization.idstringID van de organisatie die eigenaar is van de werkruimte.
organization.namestringNaam van de organisatie die eigenaar is van de werkruimte.
role.keystringJe rol in deze werkruimte: admin of editor, de rollen die Flowsery kunnen gebruiken.
role.namestringWeergavenaam van de rol.
permissionsstring[]Permissiesleutels die je in deze werkruimte hebt, zoals flowsery.write.
isDefaultbooleanTrue voor de werkruimte waarin een aanroep terechtkomt als je geen X-Workspace-Id-header meestuurt.
currentbooleanTrue voor de werkruimte waarin deze aanroep terechtkwam.
Voorbeeldverzoek (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
    }
  ]
}