Checklists

Cancel a Checklist Evaluation Job

Cancel a job. Results that finished before the job is cancelled can still be retrieved.

post/checklists/{checklistId}/evaluation-jobs/{jobId}/cancel

Request

  • Base URL: https://api.xcures.com/v3
  • URL: https://api.xcures.com/v3/checklists/{checklistId}/evaluation-jobs/{jobId}/cancel
  • Auth: HTTP bearer

Path parameters

checklistIdstring uuid required

The checklist's id.

jobIdstring uuid required

The job's id, as starting the job answered it.

Headers

ProjectIdstring required

The project the request acts in; one of the projects your credential spans.

Response

The job, as the cancel leaves it: cancelling; unchanged if it had already ended; or running, unchanged, if it had finished evaluating and is compiling its results.

jobIdstring uuid required

The job's id; read its status and results with it.

checklistIdstring uuid required

The checklist the job evaluates.

jobNamestring required

The job's name.

status'queued' | 'running' | 'cancelling' | 'completed' | 'partially_completed' | 'failed' | 'cancelled' required

Where the job is; completed, partially_completed, failed and cancelled are terminal.

patientCountinteger required

The number of patients the job evaluates.

succeededCountinteger required

The number of patients whose evaluation succeeded so far.

failedCountinteger required

The number of patients whose evaluation failed so far.

submittedAtstring date-time required

When the job was started.

startedAtstring date-time

When evaluation began; absent before it has.

completedAtstring date-time

When the job reached a terminal status; absent before it has.

resultsExpiresAtstring date-time

Until when the job's results can be read; absent before the job completes.

Changes

No recorded changes to this operation across all 1 revision of this API.