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.

Training Participants

Overview

While the standard way to give users access to training is through OfferEvents with enrollments, there are cases where users need to be directly added as participants to a Training.

Add participants

mutation {
  addTrainingParticipants(
    trainingId: "uuid"
    userIds: ["user-1", "user-2"]
    sendMail: false
  ) {
    ok
  }
}

Remove participants

mutation {
  removeTrainingParticipants(
    trainingId: "uuid"
    userIds: ["user-1"]
  ) {
    ok
  }
}

Query participants

query {
  paginatedTrainingParticipants(
    trainingId: "uuid"
    first: 50
  ) {
    edges { node { id user { name email } role progress score } }
    count
  }
}

Notes

  • Direct participant management is typically used for self-paced e-learning without events.
  • For event-based training, use enrollments instead.