Skip to main content
POST
Revise a report

Authorizations

x-api-key
string
header
required

Your Sixtyfour API key.

Headers

Idempotency-Key
string
required

Identifies a revision so an unchanged retry returns the same report job for 24 hours. Reusing a key with a different body returns 409.

Required string length: 1 - 255

Path Parameters

investigation_id
string
required

Investigation id, as returned by list or by an xhigh enrichment.

Body

application/json
feedback
string
required

The corrections to use when rewriting the report. An empty string clears the custom brief.

Maximum string length: 400000
evidence
string[]

Uploaded file_ IDs or bare UUIDs to add as evidence. People may use their own uploads; API keys may use only files uploaded by that key. Default: no added files.

Maximum array length: 5
Maximum string length: 200

Response

Successful Response

job_id
string
required
status
enum<string>
required

completed means the PDF is downloadable; superseded means a revision replaced this job before it finished.

Available options:
pending,
running,
completed,
failed,
superseded
workspace_hash
string | null

The workspace snapshot this report covers. Research that is still running moves on from it; the next report covers what it added.

requested_at
string | null
completed_at
string | null
error
string | null
cached
boolean
default:false

True when an up-to-date report already existed.

byte_size
integer
default:0
follow_up
boolean
default:false

True when this build covers findings from before your request: one more build, from the newest findings, starts when it ends.