Skip to main content
POST
Review supplied loss evidence

Authorizations

Authorization
string
header
required

Effective API key. Send Authorization: Bearer sk-eai-...

Headers

Idempotency-Key
string

Client-chosen key for safe retries: 1-128 letters, digits, -, _, . or :. Use a new random UUID for each intended operation and the same key when retrying it. Do not put customer data or credentials in the key.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9\-_.:]+$

Body

application/json
losses
(string<uuid> | object)[]
required

Loss evidence. Bare file UUIDs receive loss-1, loss-2, etc. IDs.

Required array length: 1 - 20 elements

File UUID or an object with an ID and optional label/annotations. Bare UUIDs receive input- IDs in request order.

Example:

"01a150b0-b6a4-774f-a0e0-ad385dbc5028"

company
object
products
object[]

Optional two wording variants. Composes Forms Comparison; requires its entitlement.

knowledge
(string<uuid> | object)[]

Existing forms-knowledge/v1 files; validated together.

Maximum array length: 10

File UUID or an object with an ID and optional label/annotations. Bare UUIDs receive input- IDs in request order.

Example:

"01a150b0-b6a4-774f-a0e0-ad385dbc5028"

reviewMaterial
(string<uuid> | object)[]

Earlier reports and reviewer notes; not incident evidence.

Maximum array length: 10

File UUID or an object with an ID and optional label/annotations. Bare UUIDs receive input- IDs in request order.

Example:

"01a150b0-b6a4-774f-a0e0-ad385dbc5028"

purpose
string
Required string length: 1 - 4000
focus
string[]
Maximum array length: 10
Required string length: 1 - 1000
matters
object[]

Explicit independent matters. Omit for one account containing all evidence, with distinct events and claims reconstructed inside it.

Required array length: 1 - 50 elements

Response

Completed review returned by an idempotent retry.

id
string
required
createdAt
string<date-time>
required
startedAt
string<date-time> | null
required
finishedAt
string<date-time> | null
required
idempotencyExpiresAt
string<date-time> | null
required
request
object
required
progress
object
required
formComparisonId
string | null
required
inputsUsed
object
required
report
string
required

Markdown summary and source/version manifest; item reports are on listLossReviewItems.

usage
object
required
status
enum<string>
required
Available options:
queued