Lijst projecten

Data Studio is een projectgebaseerde werkruimte voor het bouwen en werken met datasets. Elk project behoort tot één organisatie, dus de API is organisatie-gebonden en geauthenticeerd met een Bearer token, niet met een API-sleutel.

Endpoint

GET /v1/organization/:organizationId/data-studio/projects

De :organizationId is de UUID van een organisatie waarvan je lid bent. Projecten zijn geïsoleerd per organisatie — je ziet alleen de projecten van de organisatie in het pad.

Authenticatie

Data Studio endpoints zijn account/portaal endpoints, dus ze gebruiken een Bearer JWT, niet X-API-Key. Zie Authenticatie voor hoe je een token kunt verkrijgen. Om dit endpoint aan te roepen moet je:

• lid zijn van de organisatie (requireMember),
• de DATA_STUDIO_ACCESS organisatie permissie hebben, en
• de data-studio add-on ingeschakeld hebben op de organisatie.

curl -H "Authorization: Bearer eyJhbGci..." \
  "https://api.topolab.nl/v1/organization/8f0c2e1a-4b6d-4c2a-9e3f-1a2b3c4d5e6f/data-studio/projects"

Respons

De respons is een JSON-array van de projecten van de organisatie.

[
  {
    "id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
    "name": "Hotels nabij Restaurants",
    "description": "Gastvrijheidsclusters in de Randstad",
    "status": "concept",
    "visibility": "privé",
    "isLocked": false,
    "createdById": "9a8b7c6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d",
    "createdAt": "2026-05-20T09:14:00.000Z"
  },
  {
    "id": "a0b1c2d3-e4f5-4061-8273-849506172839",
    "name": "Retail catchment analyse",
    "description": null,
    "status": "klaar",
    "visibility": "organisatie",
    "isLocked": false,
    "createdById": "9a8b7c6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d",
    "createdAt": "2026-05-18T16:02:30.000Z"
  }
]

Veld	Beschrijving
id	Project UUID. Gebruikt in elke per-project endpoint.
name	Menselijk leesbare projectnaam.
description	Optionele vrije tekst, of null.
status	Levenscyclusstatus, bijvoorbeeld concept of klaar.
visibility	privé (alleen maker) of organisatie (alle org leden).
isLocked	Of het project vergrendeld is tegen bewerkingen.
createdById	UUID van de gebruiker die het project heeft aangemaakt.
createdAt	Aanmaak tijdstempel, ISO 8601.

Fouten

Status	Betekenis
401	Ontbrekende of ongeldige Bearer token.
403	Geen lid van de organisatie, ontbrekende DATA_STUDIO_ACCESS, of de data-studio add-on is niet ingeschakeld.
404	Onbekende organizationId.
429	Rate limited — zie Rate limits & credits.

Volgende

• Maak een project aan — start een nieuwe werkruimte.
• Heb je Data Studio nodig voor jouw organisatie? Neem contact met ons op voor de data-studio add-on.