Skip to main content
POST
Update case status

Authorizations

X-API-Key
string
header
required

Public API key: cxp_<hex> (firm-scoped) or cxpp_<hex> (provider-scoped). Required on every request.

Path Parameters

id
string<uuid>
required

Resource UUID

Body

application/json
status
enum<string>
required

Target CaseStatus enum value

Available options:
draft,
sent,
received,
under_evaluation,
investigating,
signed,
in_litigation,
closing,
won,
lost,
closed,
rejected,
withdrawn,
pending_spin_off
notes
string
closingStatus
string

Required when transitioning to CLOSED

Response

Case after status transition

data
object
required

A referral as seen by either party (the public API calls a referral a "case" on this path). Base-case fields are flattened onto the referral. Client fields are masked for SENT-status cases viewed by the receiving firm until acknowledged.

meta
object
required