Delete an import
/imports/{import_id}Moves the import to the trash. Only imports that have not been processed can be deleted.
Deleting an import does not undo its effects: rows already queued for processing continue, and enrollments already granted remain in place.
Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.
In: header
Path Parameters
Header Parameters
Client-generated key that makes the request safe to retry. Must be 1 to 128 characters from [A-Za-z0-9._:-]. Optional on this operation; when sent, a malformed key returns idempotency_key_invalid, and repeating the request with the same key and the same body returns the stored result with Idempotent-Replayed: true.
Optional client-generated identifier of the request, up to 64 characters from [A-Za-z0-9._-]. Echoed back in the response and recorded in the request log; it never replaces the server-generated X-Request-Id.
length <= 64Response Body
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/imports/string"Update an import PATCH
Updates the duplicate policy of an import or restores it from the trash by setting `deleted` to `false`. To delete an import, use the delete operation. The duplicate policy can only be changed before the import is processed. Send the `ETag` returned by the retrieve operation in the `If-Match` header to avoid overwriting a newer version.
Analyze an import POST
Starts an asynchronous analysis of the import spreadsheet and returns the operation that tracks it. The `Location` header points to that operation. Requires the `imports.analyze` permission. An import can be analyzed again before it is processed; the new analysis replaces the previous one.