Skip to main content
POST
Redact a detection

Path Parameters

workspaceId
string<uuid>
required

Workspace identifier.

detectionId
string
required

Opaque identifier of the detection.

Pattern: ^detection_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Body

application/json

Request payload to redact a detection.

The reviewer's edits layer over the detection's analysis before redaction: suppress a false positive, retag a detection, or add one the analysis missed. Omit edits to redact with the policy decisions exactly as detected. Each redact request produces a new redaction.

Request payload to redact a detection.

The reviewer's edits layer over the detection's analysis before redaction: suppress a false positive, retag a detection, or add one the analysis missed. Omit edits to redact with the policy decisions exactly as detected. Each redact request produces a new redaction.

edits
object

Reviewer edits to apply before redaction, grouped by modality. Omit to redact with the policy decisions exactly as detected.

Response

Response type for a redaction.

A redaction is one redact pass over a detection, produced with a specific set of reviewer edits. It owns the redacted output document (downloadable through the normal file endpoints) and a review audit recording what was redacted and why (fetched from the redaction's review endpoint).

Named WorkspaceRedactionResult rather than Redaction because the engine's audit schema already carries a Redaction (an audit event), and the two must not collide in the generated OpenAPI.

Response type for a redaction.

A redaction is one redact pass over a detection, produced with a specific set of reviewer edits. It owns the redacted output document (downloadable through the normal file endpoints) and a review audit recording what was redacted and why (fetched from the redaction's review endpoint).

Named WorkspaceRedactionResult rather than Redaction because the engine's audit schema already carries a Redaction (an audit event), and the two must not collide in the generated OpenAPI.

createdAt
string<date-time>
required

When the redaction was created.

detectionId
string
required

The detection this redaction was produced from.

Pattern: ^detection_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
id
string
required

Opaque identifier of the redaction.

Pattern: ^redaction_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
requestedBy
object
required

Account that requested the redaction.

workspaceHandle
string
required

URL-safe workspace handle. Display-only.

Required string length: 3 - 32
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
workspaceId
string<uuid>
required

Unique identifier of the workspace.

outputDocumentId
string<uuid>

Redacted output document this redaction produced. None only if the file was removed (e.g. by retention).