Developer docs

De Pluvo API geeft je programmatische toegang tot je leeromgeving. Beheer gebruikers, groepen, trainingen, inschrijvingen en certificaten vanuit je eigen systemen.

De API is gebaseerd op GraphQL. Je bepaalt zelf welke data je opvraagt of muteert, zonder overbodige velden. Authenticatie verloopt via OAuth 2.0 met client credentials. Webhooks houden je systemen real-time op de hoogte van wijzigingen.

Docs

Groups

Use Cases

Get single group

query {
  group(id: "uuid-here") {
    id name ref maxUsers userCount
  }
}

Get list

query {
  paginatedGroups(q: "sales", first: 50) {
    edges { node { id name ref userCount } }
    pageInfo { hasNextPage endCursor }
    count
  }
}

Create group

mutation {
  createGroup(group: { name: "Sales Team", maxUsers: 50, ref: "group-sales" }) {
    group { id name ref }
  }
}

Update group

mutation {
  updateGroup(ref: "group-sales", group: { name: "Sales & Marketing" }) {
    group { id name }
  }
}

Notes

Use ref or id to select groups — both work in queries and mutations.
paginatedGroups recommended for filtering and pagination.
Deleting a group is permanent.