Manage batch job approvals
2 minute read
When you start a batch enrollment job, if the enrollment profile requires certificate approvals, a user with the right permissions must approve the batch job before DigiCert® IoT Trust Manager processes the enrollments in your request. This section describes how to use the DigiCert® IoT Trust Manager API to approve or reject a batch job.
Note
If your enrollment profile auto-approves certificate requests, skip this step. Batch jobs requested through enrollment profiles using auto-approvals are immediately queued for processing.Approve a batch job
To approve a batch job, submit a PUT request to the following API endpoint.
{{base_url}}/iot/api/v1/batch-enroll/{{job_id}}/approve
Tip
For detailed information about this endpoint, see the API reference: Approve batch enrollment job.In the request URL:
- Replace
{{base_url}}with the base URL of your DigiCert ONE instance (for example,https://one.digicert.com). - Replace
{{job_id}}with the batch job ID returned when you created the batch job.
A successful request to approve a batch job returns a response status code of 204 No Content. DigiCert® IoT Trust Manager queues the batch job for processing, and its status becomes APPROVED. When processing begins, the status of the batch job changes from APPROVED to IN_PROGRESS. When the batch job status is COMPLETE, you can download the certificates.
Reject a batch job
To reject a batch job, submit a PUT request to the following API endpoint:
{{base_url}}/iot/api/v1/batch-enroll/{{job_id}}/reject
Tip
For detailed information about this endpoint, see the API reference: Reject batch enrollment job.In the request URL:
- Replace
{{base_url}}with the base URL of your DigiCert ONE instance (for example,https://one.digicert.com). - Replace
{{job_id}}with the batch job ID returned when you created the batch job.
A successful request to reject a batch job returns a response status code of 204 No Content.