Skip to main content
POST
Create a case (manual)

Authorizations

X-API-KEY
string
header
required

Authorization method required to allow user to access the api endpoints.

Body

application/json
source_type
enum<string>
required
Available options:
risk_screen,
sanctions_screen,
alert_event,
manual,
regulatory_filing
subject
object
required
source_id
string

Required for risk_screen and alert_event (screen_id / event_id).

Maximum string length: 256
title
string
Maximum string length: 200
Example:

"High-risk address detected: 0x742d...bD28"

severity
enum<string>

Required when source_type is manual; inherited from the source otherwise.

Available options:
severe,
high,
medium,
low
assignee
string<email>
Example:

"compliance@example.com"

Response

201 - application/json
id
string
required
workspace_id
string
required
title
string
required
status
enum<string>
required
Available options:
open,
in_review,
resolved
severity
enum<string>
required
Available options:
severe,
high,
medium,
low
source_type
enum<string>
required
Available options:
risk_screen,
sanctions_screen,
alert_event,
manual,
regulatory_filing,
tie_out_break,
corridor_discrepancy,
redemption,
transaction_screening,
counterparty_screening
subject
object
required
created_at
string
required
updated_at
string
required
viewed
boolean
required

In list responses, whether this case is read for the caller.

autopilot_status
enum<string> | null
required

Status of the latest Autopilot run on this case, or null when Autopilot has not touched it.

Available options:
queued,
running,
completed,
failed,
skipped
autopilot_recommendation
enum<string> | null
required

Recommendation of the latest Autopilot run, or null when it has none yet.

Available options:
escalate,
dismiss,
review
available_actions
object[]
required

Actions supported by this source and status. Existing write permissions still apply. Resolving via set_status requires resolution=dismissed.

comments
object[]
required
autopilot
object | null
required

The latest Autopilot run on this case, or null. Its report is model output: render it as text, never as HTML.

resolution
enum<string> | null
Available options:
dismissed,
escalated,
paid
source_id
string | null
client_entity_id
string | null

The client entity the case concerns (screening cases).

Example:

"550e8400-e29b-41d4-a716-446655440000"

assignee
string | null
created_by
string | null
resolved_at
string | null
counterparty_deleted
boolean

Counterparty screening cases on one counterparty address or wallet: true when that counterparty entity or wallet account has since been deleted from the register. The case stays open. Absent on other cases.

evidence_summary
object | null

What the case was opened on. A redemption case carries redemption_id, burn_time and deadline, linking it to GET /v2/redemptions/{id}.