Sign in

v1

latestOpenAPI 3.1.02026-08-04164270844.7 KB
Integrations

Upsert external courses

🔑

Required OAuth scope: integrations:bulk.

🚜

This endpoint processes up to 10,000 objects asynchronously. For more information, see the Bulk operations guide.

Adds or replaces multiple external courses based on the given integrationId and the courses's externalId.

  • If a provided externalId matches an existing external course, the course is replaced with the new data.
  • If no match is found, a new course is created and added to the group catalog and library.

Upon submission, the request is queued. Use the provided URL in the response header to check the status of the bulk operation.

put/api/v2/bulk/integrations/{integrationId}/courses

Path parameters

integrationIdstring ObjectId required
Example:507f1f77bcf86cd799439011

The unique ID of the integration.

Headers

360-api-version'v2.0' required

The version of the API.

Request body

Example request

{
  "input": [
    {
      "externalId": "l3ssup3rh3r0s",
      "launchUrl": "https://player.mylearningplatform.com/launch/l3ssup3rh3r0s",
      "name": "Machine Learning Crash Course",
      "sources": [
        {
          "name": "Wikipedia",
          "logoUrl": "https://en.wikipedia.org/static/images/icons/wikipedia.png"
        }
      ],
      "subjects": [
        "Machine Learning",
        "IT"
      ],
      "description": "Learn the basics of machine learning.",
      "duration": 45,
      "imageUrl": "https://player.mylearningplatform.com/image/l3ssup3rh3r0s",
      "mobileLaunchUrl": "https://player.mylearningplatform.com/mobile/launch/l3ssup3rh3r0s",
      "authorId": "507f1f77bcf86cd799439011",
      "translations": [
        {
          "lang": "fr",
          "translatedFields": {
            "description": "Apprenez les bases de l'apprentissage automatique.",
            "launchUrl": "https://player.mylearningplatform.com/launch/l3ssup3rh3r0s/fr",
            "mobileLaunchUrl": "https://player.mylearningplatform.com/mobile/launch/l3ssup3rh3r0s/fr",
            "name": "Cours intensif sur l'apprentissage automatique",
            "subjects": [
              "Apprentissage automatique",
              "TI"
            ]
          }
        }
      ]
    }
  ]
}

Response

The operation is successfully created.