--- title: "Add skill reviews" method: POST path: "/api/v2/bulk/skills/reviews" tags: ["Skills"] --- # Add skill reviews `POST /api/v2/bulk/skills/reviews` ## Request - Base URL: `https://app.360learning.com` - URL: `https://app.360learning.com/api/v2/bulk/skills/reviews` - Auth: OAuth 2 - Client credentials - Token URL: `/api/v2/oauth2/token` > 🔑 > > Required OAuth scope: `skillsPowers:bulk`. > 🚜 > > This endpoint processes up to 10,000 objects asynchronously. For more information, see the [Bulk operations guide](doc:bulk-operations-1). Adds multiple skill reviews. - Reviews are related to three kind of actions: 'skill added', 'skill assessed', 'skill deleted'. - In the 'skill assessed' case, the assessment is automatically validated if the assessor is a manager of the user. Upon submission, the request is queued. Use the provided URL in the response header to check the status of the bulk operation. ## Headers - `360-api-version` 'v2.0', required ## Request body - AddSkillReviewsBody - `input` union[], required: An array of skill review objects. - union - SkillAddedDTO - `externalId` string: The unique external ID of the review. - `userId` string, ObjectId, required: The unique ID of the user the review is about. - `assessorId` string, ObjectId, required: The unique ID of the user that made the review. - `skillId` string, required: The unique ID of the skill the review is about. - `actionType` 'skillAdded', required: The skill is added to the user profile. - `comment` string: A comment about the review. - `createdAt` string, date-time: The date and time of the review, in the `YYYY-MM-DDThh:mm:ss.sssZ` format (ISO 8601 in Coordinated Universal Time (UTC)). If not set, the current date is used. - SkillAssessedByIdDTO - `externalId` string: The unique external ID of the review. - `userId` string, ObjectId, required: The unique ID of the user the review is about. - `assessorId` string, ObjectId, required: The unique ID of the user that made the review. - `skillId` string, required: The unique ID of the skill the review is about. - `actionType` 'skillAssessed', required: The skill is assessed, with qualifier values given by ID. - `comment` string: A comment about the review. - `createdAt` string, date-time: The date and time of the review, in the `YYYY-MM-DDThh:mm:ss.sssZ` format (ISO 8601 in Coordinated Universal Time (UTC)). If not set, the current date is used. - `qualifiers` ValueByIdQualifierDTO[]: The qualifier values related to the assessment, specified by ID. Required when the target skill has a main qualifier configured. - `_id` string, required: The unique ID of the qualifier. - `valueId` string, required: The unique ID of the qualifier value. - SkillAssessedByIndexDTO - `externalId` string: The unique external ID of the review. - `userId` string, ObjectId, required: The unique ID of the user the review is about. - `assessorId` string, ObjectId, required: The unique ID of the user that made the review. - `skillId` string, required: The unique ID of the skill the review is about. - `actionType` 'skillAssessedByIndex', required: The skill is assessed, with qualifier values given by index. - `comment` string: A comment about the review. - `createdAt` string, date-time: The date and time of the review, in the `YYYY-MM-DDThh:mm:ss.sssZ` format (ISO 8601 in Coordinated Universal Time (UTC)). If not set, the current date is used. - `qualifiers` ValueByIndexQualifierDTO[]: The qualifier values related to the assessment, specified by index. Required when the target skill has a main qualifier configured. - `_id` string, required: The unique ID of the qualifier. - `valueIndex` integer, required: The index of the qualifier value, among the list of possible values. Takes values from 1 to the number of possible values for the qualifier. - SkillDeletedDTO - `externalId` string: The unique external ID of the review. - `userId` string, ObjectId, required: The unique ID of the user the review is about. - `assessorId` string, ObjectId, required: The unique ID of the user that made the review. - `skillId` string, required: The unique ID of the skill the review is about. - `actionType` 'skillDeleted', required: The skill is removed from the user profile. - `comment` string: A comment about the review. - `createdAt` string, date-time: The date and time of the review, in the `YYYY-MM-DDThh:mm:ss.sssZ` format (ISO 8601 in Coordinated Universal Time (UTC)). If not set, the current date is used. - SkillRemovedDTO - `externalId` string: The unique external ID of the review. - `userId` string, ObjectId, required: The unique ID of the user the review is about. - `assessorId` string, ObjectId, required: The unique ID of the user that made the review. - `skillId` string, required: The unique ID of the skill the review is about. - `actionType` 'skillRemoved', required: The skill is removed from the user profile. - `comment` string: A comment about the review. - `createdAt` string, date-time: The date and time of the review, in the `YYYY-MM-DDThh:mm:ss.sssZ` format (ISO 8601 in Coordinated Universal Time (UTC)). If not set, the current date is used. ## Response `202` The operation is successfully created. ## Other responses - `400`: The server cannot or will not process the request due to something that is perceived to be a client error. - `401`: The given access token is either missing, invalid, has expired, or has been revoked. - `403`: The given access token does not have the required OAuth scope to execute the request. - `429`: The maximum number of concurrent operations has been reached. - `503`: The bulk API is temporarily disabled. --- [API](https://skmtc.dev/360learning/apis/bulk-api.md) - [All operations](https://skmtc.dev/360learning/apis/bulk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/360learning/apis/bulk-api/revisions/375f9b05b456?raw)