api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/workspacesToon 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. Eenflow_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
Eenflow_-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
| Parameter | Type | Beschrijving |
|---|---|---|
id | string | Werkruimte-ID. Stuur het mee in de X-Workspace-Id-header om in deze werkruimte te werken. |
name | string | Naam van de werkruimte. |
organization.id | string | ID van de organisatie die eigenaar is van de werkruimte. |
organization.name | string | Naam van de organisatie die eigenaar is van de werkruimte. |
role.key | string | Je rol in deze werkruimte: admin of editor, de rollen die Flowsery kunnen gebruiken. |
role.name | string | Weergavenaam van de rol. |
permissions | string[] | Permissiesleutels die je in deze werkruimte hebt, zoals flowsery.write. |
isDefault | boolean | True voor de werkruimte waarin een aanroep terechtkomt als je geen X-Workspace-Id-header meestuurt. |
current | boolean | True 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
}
]
}