---
title: "Hand a case to delivery (internal)"
method: POST
path: "/v1/deliveries"
---

# Hand a case to delivery (internal)

`POST /v1/deliveries`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/deliveries`
- Auth: HTTP bearer

Internal. A producer (Commerce) authenticates with its producer token (`DECIONIS_DELIVERY_PRODUCERS_JSON`) and may only deliver cases of the owners it holds. Core looks recipients up through Accounts, delivers in channel order (Business Central in-app, Teams, Slack, the assistant; email only notifies, or carries a signed link when the person has no other channel), deduplicates by content key and retries in the worker. 503 delivery_disabled while `DECIONIS_DELIVERY_ENABLED` is not 1.

## Request body

- object: A case (`card`, decionis.delivery.card/1) or a report artifact (`artifact`) in the producer's own namespace, delivered as an informational card with no verbs.
  - `version` 'decionis.delivery.item/1', required
  - `kind` 'case' | 'artifact', required
  - `org_id` string, uuid, required
  - `content_key` string, required
  - `card` object: decionis.delivery.card/1
  - `audience` object, required
    - `account_user_ids` string[]
    - `roles` string[]
    - `recipient_roles` string[]
  - `artifact` object
    - `type` string, required
    - `id` string, required
    - `title` string, required
    - `url` string, nullable, required
    - `period` string
    - `verification` 'signed' | 'unsigned'
    - `lines` string[]
    - `facts` object[]
      - `label` string, required
      - `value` string, required

## Response `202`

Accepted; `duplicate` is true for a content key already delivered.

- object

## Other responses

- `400`: Structured API error
- `401`: Structured API error
- `403`: Structured API error
- `503`: Structured API error

---

[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)