🗃️Endpoints - Courses

Get courses

get

Get Courses

Paramètres de requête

pageinteger | nullableOptionnel

The page number in a paginated set of results

limitinteger | nullableOptionnel

The limit of results to be returned per page

status[eq]string · enumOptionnel

Search Course with a specific status

Valeurs possibles:

privacy[eq]string · enumOptionnel

Search Course with a specific privacy

Valeurs possibles:

Réponses

200

Courses returned successfully

application/json

400

Malformed payload

get

/v1/courses

HTTPcURLJavaScriptPython

GET /v1/courses HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

{
  "items": [
    {
      "id": "text",
      "title": "text",
      "description": "text",
      "privacy": "Secret",
      "status": "Draft",
      "navigationMode": "Flexible"
    }
  ],
  "total": 1
}

Link groups to a course

post

Link groups to a course

Paramètres de chemin

courseIdstringRequis

The id of the course

Corps

application/json

groupIdsstring[]Requis

The ids of the groups to link

withEmailNotificationbooleanOptionnel

Set to true to send notification mail to each invited members

Réponses

204

Groups linked successfully

400

Malformed payload

post

/v1/courses/{courseId}/groups~bulkAdd

HTTPcURLJavaScriptPython

POST /v1/courses/{courseId}/groups~bulkAdd HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "groupIds": [
    "text"
  ],
  "withEmailNotification": true
}

Aucun contenu

Unlink groups from a course

post

Unlink groups from a course

Paramètres de chemin

courseIdstringRequis

The id of the course

Corps

application/json

groupIdsstring[]Requis

The ids of the groups to link

Réponses

204

Groups unlinked successfully

400

Malformed payload

post

/v1/courses/{courseId}/groups~bulkRemove

HTTPcURLJavaScriptPython

POST /v1/courses/{courseId}/groups~bulkRemove HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "groupIds": [
    "text"
  ]
}

Aucun contenu

Get courses participants

get

Get Courses participants

Paramètres de chemin

courseIdstringRequis

The id of the course

Paramètres de requête

pageinteger | nullableOptionnel

The page number in a paginated set of results

limitinteger | nullableOptionnel

The limit of results to be returned per page

firstname[in]string[]Optionnel

The firstnames of spot member to include in the result

lastname[in]string[]Optionnel

The lastnames of spot member to include in the result

email[in]string[]Optionnel

The emails of spot member to include in the result

status[eq]string · enumOptionnel

Search participants with a specific status

Valeurs possibles:

Réponses

200

Courses participants returned successfully

application/json

400

Malformed payload

404

Course not found

get

/v1/courses/{courseId}/participants

HTTPcURLJavaScriptPython

GET /v1/courses/{courseId}/participants HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

{
  "items": [
    {
      "id": "text",
      "courseId": "text",
      "spotMemberId": "text",
      "spotMemberEmail": "text",
      "spotMemberFirstname": {},
      "spotMemberLastname": {},
      "status": "Invited",
      "invitedAt": "2025-12-12T19:55:28.489Z",
      "startedAt": "2025-12-12T19:55:28.489Z",
      "completedAt": "2025-12-12T19:55:28.489Z",
      "unenrolledAt": "2025-12-12T19:55:28.489Z",
      "lastActivityAt": "2025-12-12T19:55:28.489Z",
      "completionRate": 1
    }
  ],
  "total": 1
}

Invite a member as course participant

post

Invite a member as Course participant

Paramètres de chemin

courseIdstringRequis

The id of the course

Corps

application/json

spotMemberIdstringRequis

An uuid representing the unique identifier of the spot member to add to course

invitedBySpotMemberIdstringOptionnel

The Spot member ID on the initiative of the invitation

withEmailNotificationbooleanOptionnel

Set to true to send notification mail to each invited members

Réponses

200

Member already invited

Aucun contenu

201

Member has been successfully invited

application/json

400

Malformed payload

post

/v1/courses/{courseId}/participants

HTTPcURLJavaScriptPython

POST /v1/courses/{courseId}/participants HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 83

{
  "spotMemberId": "text",
  "invitedBySpotMemberId": "text",
  "withEmailNotification": true
}

Aucun contenu

Invite multiple members as course participants

post

Invite a members as Course participants

Paramètres de chemin

courseIdstringRequis

The id of the course

Corps

application/json

spotMemberIdsstring[]Requis

An array of uuid representing the unique identifier of the spot members to add to course

invitedBySpotMemberIdstringOptionnel

The Spot member ID on the initiative of the invitation

withEmailNotificationbooleanOptionnel

Set to true to send notification mail to each invited members

Réponses

200

Members already invited

Aucun contenu

201

Members has been successfully invited

application/json

400

Malformed payload

post

/v1/courses/{courseId}/participants~bulkInvite

HTTPcURLJavaScriptPython

POST /v1/courses/{courseId}/participants~bulkInvite HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "spotMemberIds": [
    "text"
  ],
  "invitedBySpotMemberId": "text",
  "withEmailNotification": true
}

Aucun contenu