Cases

A case is the abstraction Frayme uses to hold everything related to one decision. A case has a type, a subject, and a payload. It flows through a workflow, accumulates evidence, and resolves into a decision.

Canonical shape

Every case carries the same envelope:

Field	Type	Notes
`case_id`	string	Globally unique. Idempotency anchor.
`type`	enum	`transaction` · `kyc` · `kyb`
`subject`	object	The entity the case is about (see below by type).
`payload`	object	Type-specific body.
`opened_at`	datetime	When the case entered Frayme.

The subject shape varies with the case type:

transaction
kyc
kyb

"subject": {
  "main_account": "...",
  "subaccount": "...",
  "counterpart": { "key", "ispb", "document", "wallet_address", "tx_hash" },
  "currency": "BRL | USD | USDC",
  "amount": 12500
}

"subject": {
  "applicant_id": "...",
  "full_name": "...",
  "dob": "...",
  "declared_country": "BR",
  "declared_address": { ... },
  "email": "...",
  "phone": "..."
}

"subject": {
  "company_id": "...",
  "legal_name": "...",
  "tax_id": "...",
  "jurisdiction": "BR",
  "ubo_declared": [{ "name", "document", "ownership_pct" }],
  "corporate_docs": [...],
  "requested_limit": 50000
}

Lifecycle of a case

Open

Posted to the workflow endpoint or fanned-out from a stream. Validated against the workflow’s input schema.

Enrich

Data Source and Custom API nodes attach vendor responses to the case context.

Evaluate

Rule, Decision Table, AI and Scorecard nodes consume the enriched context and emit a verdict.

Route

Split nodes send the case down the appropriate branch — auto-approve, manual review, block, regulator report.

Decide

Terminal Output node writes the decision. Analyst may override from the queue within the audit retention window.

Idempotency

Frayme can receive an idempotencyKey as the idempotency key. A second post with the same key returns the previously committed decision rather than re-running the graph.

Get started

Core concepts

Decisions & Queue

Compliance

Canonical shape

Lifecycle of a case

Idempotency

​Canonical shape

​Lifecycle of a case

​Idempotency

Canonical shape

Lifecycle of a case

Idempotency