Agency

Poll a client report

Status, tier, and report URL for one client report in the workspace. Does not return the report payload - use the export.

get/api/agent/agency/reports/{id}

Request

  • Base URL: https://preuve.ai
  • URL: https://preuve.ai/api/agent/agency/reports/{id}
  • Auth: API key in header x-preuve-key

Path parameters

idstring uuid required

Client report id, scoped to the caller's Agency workspace.

Response

Report status.

reportIdstring
status'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED'
scanType'starter' | 'deep'
analysisTierstring
readyForExportboolean
reportUrlstring uri
createdAtstring date-time
pollAfterSecondsinteger

Present only while the report is not terminal.

reusedboolean

Present when this clientRunId replayed an existing report.

dispatchPendingboolean

The dispatch outcome is unknown. Retry the same clientRunId and arguments after 60 seconds; recovery reuses the original report and credit. Past 23 hours the recovery text directs you to support instead of risking a duplicate job.

recoverystring

What to do next, present alongside dispatchPending.

Changes

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