36360learning
External IDs

Replace an ID mapping

🔑

Required OAuth scope: externalIds:write.

Replaces an existing external ID mapping with the provided data.

put/api/v2/external-ids/{mappingId}

Request

  • Base URL
    https://app.360learning.com
  • URL
    https://app.360learning.com/api/v2/external-ids/{mappingId}
  • Auth
    OAuth 2
    Client credentials
    Token URL: /api/v2/oauth2/token

Path parameters

mappingIdstring ObjectId required
Example:507f1f77bcf86cd799439011

The unique ID that identifies the resources mapping.

Headers

360-api-version'v2.0' required

The version of the API.

Request body

platformstring required

The name of the platform where the external ID comes from.

targetIdstring ObjectId required

The resource ID to which the external ID is linked.

targetType'attempt' | 'classroom' | 'classroomAttendance' | 'classroomAttendanceSheet' | 'classroomSlot' | 'classroomSlotRegistration' | 'course' | 'group' | 'learningNeed' | 'path' | 'pathEnrollment' | 'pathSession' | 'pathTracking' | 'registrationRequest' | 'user' required

The resource type to which the external ID is linked.

valuestring required

The value of the external ID.

Example request

{
  "platform": "external catalog",
  "targetId": "507f1f77bcf86cd799439011",
  "targetType": "course",
  "value": "945628-01"
}

Response

Returns the updated external ID mapping.

platformstring required

The name of the platform where the external ID comes from.

targetIdstring ObjectId required

The resource ID to which the external ID is linked.

targetType'attempt' | 'classroom' | 'classroomAttendance' | 'classroomAttendanceSheet' | 'classroomSlot' | 'classroomSlotRegistration' | 'course' | 'group' | 'learningNeed' | 'path' | 'pathEnrollment' | 'pathSession' | 'pathTracking' | 'registrationRequest' | 'user' required

The resource type to which the external ID is linked.

valuestring required

The value of the external ID.

_idstring ObjectId required

The unique ID that identifies the resources mapping.

Example response

{
  "platform": "external catalog",
  "targetId": "507f1f77bcf86cd799439011",
  "targetType": "course",
  "value": "945628-01",
  "_id": "507f1f77bcf86cd799439011"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.