Bulk Certify Users

Grants certifications to multiple users in a single request. Returns a count of successful grants and a list of any per-user errors

Grants certifications to multiple users in a single request. Returns a count of successful grants and a list of any per-user errors.

POSThttps://example.thoughtindustries.com/incoming/v2/users/certify/bulk

Example request

curl -X POST "https://example.thoughtindustries.com/incoming/v2/users/certify/bulk" \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "users": []
}'

Parameters

Name	Type	Required	Location	Description
`users`	`BulkCertifyUserInput[]`	Yes	body	Array of user-certification pairs specifying which certifications to grant to which users.

Example response

{
  "data": {
    "APIBulkCertifyUsers": {
      "grantedCount": 0,
      "errors": [
        {
          "userId": "00000000-0000-0000-0000-000000000000",
          "email": "string",
          "externalCustomerId": "string",
          "resourceId": "00000000-0000-0000-0000-000000000000",
          "error": "string",
          "record": "string"
        }
      ]
    }
  }
}

Response fields

Field	Type	Description
`grantedCount`	`integer`	Number of certifications successfully granted.
`errors`	`BulkCertifyUserError[]`	List of errors for individual users whose certifications could not be granted.
`errors.userId`	`uuid`	Unique identifier of the user whose certification grant failed.
`errors.email`	`string`	Email address of the user whose certification grant failed.
`errors.externalCustomerId`	`string`	External customer identifier associated with the user whose certification grant failed.
`errors.resourceId`	`uuid`	Unique identifier of the certification resource that could not be granted.
`errors.error`	`string`	Human-readable message describing why the certification grant failed.
`errors.record`	`string`	Raw record string associated with the failed entry, useful for debugging bulk input.