Bulk Update Certificate Templates

Bulk-updates one or more certificate templates in a single request

Bulk-updates one or more certificate templates in a single request.

POSThttps://example.thoughtindustries.com/incoming/v2/content/certificate-templates/bulk/update

Example request

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

Parameters

Name	Type	Required	Location	Description
`templates`	`UpdateCertificateTemplateInput[]`	Yes	body	Array of certificate template objects to update, each containing the template ID and fields to modify.

Example response

{
  "data": {
    "APIBulkUpdateCertificateTemplates": {
      "createdCount": 0,
      "updatedCount": 0,
      "createdIds": [
        "00000000-0000-0000-0000-000000000000"
      ],
      "errors": [
        {
          "resourceId": "00000000-0000-0000-0000-000000000000",
          "title": "string",
          "error": "string",
          "record": "string"
        }
      ],
      "warnings": [
        "string"
      ],
      "backgroundJob": {
        "id": "00000000-0000-0000-0000-000000000000",
        "type": "string",
        "description": "string",
        "errorMessage": "string",
        "createdAt": "2024-01-01T00:00:00.000Z",
        "repeatable": true,
        "status": "complete"
      }
    }
  }
}

Response fields

Field	Type	Description
`createdCount`	`integer`	Number of certificate templates created during the bulk operation.
`updatedCount`	`integer`	Number of certificate templates successfully updated during the bulk operation.
`createdIds`	`uuid[]`	UUIDs of any certificate templates created during the bulk operation.
`errors`	`BulkCertificateTemplateError[]`	List of errors encountered for individual templates during the bulk operation.
`errors.resourceId`	`uuid`	UUID of the certificate template that caused the error.
`errors.title`	`string`	Human-readable title identifying the failed certificate template.
`errors.error`	`string`	Description of the error that occurred for this template.
`errors.record`	`string`	Serialized representation of the record that failed to process.
`warnings`	`string[]`	Non-fatal warning messages generated during the bulk operation.
`backgroundJob`	`BackgroundJob`	Background job created to process the bulk update asynchronously, if applicable.
`backgroundJob.id`	`uuid`	Unique identifier of the background job.
`backgroundJob.type`	`string`	Classification of the background job task.
`backgroundJob.description`	`string`	Human-readable description of what the background job is processing.
`backgroundJob.errorMessage`	`string`	Error message recorded if the background job failed.
`backgroundJob.createdAt`	`ISO 8601 timestamp`	Date and time when the background job was created, in ISO 8601 format.
`backgroundJob.repeatable`	`boolean`	Indicates whether the background job is scheduled to repeat.
`backgroundJob.status`	`BackgroundJobStatus`	Current status of the background job (e.g., `complete`).