---
title: "Decide a case (the one inbound decision path)"
method: POST
path: "/v1/cases/{caseId}/decisions"
---

# Decide a case (the one inbound decision path)

`POST /v1/cases/{caseId}/decisions`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/cases/{caseId}/decisions`
- Auth: HTTP bearer

Every channel resolves here, through DecisionActionResolver. Teams and Slack callbacks, the Business Central extension and the `decionis.cases.*` MCP tools all reach the same steps. The channel identity must belong to the workspace's tenant, resolve to a current Accounts member and hold the case's authority. When the authority requirement asks, Presence must have approved the person's passkey first (428 with `step_up_url`). The transition happens at the case's owner, with a revision check, and is applied once per case revision whichever inbox it came from. Organization API key with decision:write and a person (Business Central `x-decionis-actor` or an MCP OAuth token), or the named recipient's own Account session with the signed email `link`.

## Query parameters

- `view` 'card' | 'business-central' | 'assistant'

## Request body

- object
  - `verb` 'approve' | 'reject' | 'edit' | 'escalate', required
  - `revision` integer, required
  - `decision_id` string, uuid
  - `choices` string[]
  - `note` string
  - `link` string: Signed email fallback link

## Response `200`

`applied` is false when the same decision was already applied (from this or another inbox).

- object
  - `applied` boolean, required
  - `card` object, required

## Other responses

- `400`: Structured API error
- `403`: wrong_tenant, not_a_member, not_authorized, actor_required or link_not_yours.
- `404`: Structured API error
- `409`: stale_revision (with the current card), already_decided, decision_in_progress or step_up_unavailable.
- `410`: case_expired.
- `428`: step_up_required, with `step_up_url` (the Presence passkey hand-off).

---

[API](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/revisions/357f5e459d0c?raw)
