Create a processing attempt
/imports/{import_id}/processing-attemptsQueues the rows that are ready for processing. Requires the imports.process permission.
A successful response confirms that the rows were queued, not that enrollments were granted. Rows are processed asynchronously; use the list import rows operation to follow the result of each row.
The import must have a completed analysis with no errors. Use mode=initial (default) for the first attempt, and mode=retry to requeue only the rows whose processing failed.
Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/imports/string/processing-attempts" \ -H "Content-Type: application/json" \ -d '{}'{ "data": { "created_at": "2019-08-24T14:15:22Z", "effects": { "communication_sent": true, "stage_confirmed": true }, "error": {}, "event_id": "string", "id": "string", "import_id": "string", "membership_id": "string", "object": "processing_attempt", "operation_id": "string", "requested_by": { "id": "string", "kind": "credential" }, "selection": { "mode": "initial", "rows": 0 }, "status": "queued" }}List processing attempts GET
Returns the processing attempts requested through the API for the specified import. Processing started outside the API does not appear in this list.
Retrieve a processing attempt GET
Retrieves a processing attempt of the specified import. An attempt that belongs to a different import returns `404 Not Found`. If the attempt failed, `error` explains why the rows could not be queued. Errors for individual rows are reported by the list import rows operation.