Report a job
report_jobReport a claimed attempt with its exact attempt_id: running; needs_input with one question for your user; shipped with the live published_url, or planned_url once merged (we check it); ready_for_review with prepared_content, or asset_url when your user must post it or when it is the pull request you opened; failed with fail_reason. Ready_for_review can be reported again, improved, until your user uses it. If you cannot read the whole thread, say so and ask your user for a screenshot. Free; requires the 'act' scope.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | Yes | ||
| job_id | Yes | Job id (uuid), from list_queue. | |
| question | No | Required with 'needs_input'. | |
| asset_url | No | URL of the prepared asset. This does not claim publication. | |
| attempt_id | Yes | Exact attempt id; null only when list_queue identified a legacy job. | |
| fail_reason | No | Required with 'failed': what stopped you. | |
| planned_url | No | With 'shipped': a merged own-site change's page; we check it, it ships within two days. | |
| receipt_url | No | A permalink to the proof. | |
| session_url | No | Optional. The launch already gave your user the link to this session; pass it only when you opened this session yourself and can see its address. | |
| published_url | No | With 'shipped': the live https address. | |
| site_repository | No | Optional, for a routine working a site move: the repository it can write to, as owner/name, or null if it has none. Omit it to say nothing. | |
| prepared_content | No | Prepared result body for ready_for_review. |