Import a tool holder
PATCH/v1/holders/:id
Queues import of an uploaded tool holder — deriving its collision envelope — and returns a job. Wait for the job with Stream job updates (GET /v1/jobs/{id}/events), then read the result with Get a tool holder (GET /v1/holders/{id}).
Request
Responses
- 202
- 400
- 401
- 403
- 404
- 409
- 500
- 503
The import job was accepted; wait for it on GET /v1/jobs/{id}/events, then read /v1/holders/{id}.
The request is invalid.
The API key is missing or invalid.
The API key may not perform this operation: it has no access to this part of the API, it may only read it, or its creator has not met the organization’s two-factor requirement.
The holder does not exist.
The holder source has not been uploaded, it changed after work began on the holder (holder_source_changed), an import is already in progress, or the Idempotency-Key was already used for a different operation.
The import job could not be created.
Authentication is temporarily unavailable, or the job could not be sent to the processing queue (job_dispatch_failed) and was not created. Retry the request; reusing its Idempotency-Key is safe.