Create Skill Ratings in Bulk

Creates up to the batch limit (currently 100) skill ratings in one request and returns one result per record in meta.results, in request order (row-index). Each record follows the rules of POST /api/v2/skill-ratings. Records are validated and written independently: the response is 200 even when some or all records fail. A record that matches the user's current rating returns skipped and writes nothing, so resending a request is safe. If the user does not have the skill yet it is added to their profile. Bulk-created ratings do not notify the rated users. Rate limit: 10 requests per minute per OAuth client (all of its tokens together), shared with the other bulk-operations endpoints. The body is a JSON:API document whose data is an array of items with type set to skill-ratings and these attributes: user-id (required), the rated user, of the kind given by identifier-type: id (default), email or employee-id. skill-id or skill-name (up to 255 characters); if both are given they must be the same skill. rating-type (required): Self, Manager or Peer, which use rating (an integer from 1 to the organization's rating scale); any other value is an external provider code, which uses rating-label (up to 50 characters) instead. manager-id (Manager ratings) or rater-id (required for Peer, or instead of manager-id for Manager; not allowed for Self): encoded Degreed user ids, never both. comment: up to 2,000 characters. skill-scale: required for Self, Manager and Peer when the organization uses the skills platform, and must equal its primary scale.

Required Scope

skill_ratings:write

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Responses

500

An unexpected server error occurred. Resend the same request; applied records come back as skipped.

503

Bulk operations are not enabled for the organization, or the flag could not be evaluated (FEATURE_DISABLED); or the database call timed out
(database-error).

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/vnd.api+json