Sign in
Runs

Poll the status of a run

Pass runId for a specific run, or only projectId to fetch the project's most recent run. Live count fields distinguish retrieved provider outputs from evidence-ready analyzed outputs. Returns status: "none" when no run exists yet.

get/prompts/status

Query parameters

projectIdstring uuid required

Project id. Required on all data endpoints.

runIdstring uuid

Response

Successful response

runIdstring uuid
status'running' | 'completed' | 'failed' | 'interrupted' | 'cancelled' | 'none'

cancelled is reported by /prompts/status when a failed run had cancelRequested = true. none only appears when no run exists for the project.

cancelRequestedboolean
totalTasksinteger
completedTasksinteger
retrievedTasksinteger
analyzedTasksinteger
settledTasksinteger
failedTasksinteger
pendingTasksinteger
remainingTasksinteger
cancelledTasksinteger
incompleteTasksinteger
extractionPendingTasksinteger
extractionFailedTasksinteger
extractionIncompleteTasksinteger
scraperAttemptedboolean
scraperSucceededboolean
startedAtstring date-time nullable
completedAtstring date-time nullable
resultsRevisioninteger

Changes

Changed in 2 of the 4 revisions of this API.9

  • f8f03e5551936See the full diff
    • ○

      added the optional property analyzedTasks to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property cancelRequested to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property remainingTasks to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property resultsRevision to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property retrievedTasks to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property settledTasks to the response with the 200 status

      response-optional-property-added

  • d307a7633c0a3See the full diff
    • ○

      added the optional property extractionFailedTasks to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property extractionIncompleteTasks to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property extractionPendingTasks to the response with the 200 status

      response-optional-property-added