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

Gruppen

Use Cases

Einzelne Gruppe abrufen

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

Liste abrufen

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

Gruppe erstellen

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

Gruppe aktualisieren

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

Notes

Verwenden Sie ref oder id zur Auswahl von Gruppen – beides funktioniert in Abfragen und Mutationen.
paginatedGroups wird für Filterung und Paginierung empfohlen.
Das Löschen einer Gruppe ist endgültig.