Skip to main content
POST
/
api
/
deliveries
Api Deliveries Save
curl --request POST \
  --url http://localhost:8080/api/deliveries \
  --header 'Content-Type: application/json' \
  --data '
{
  "cadence": {
    "day": 1,
    "kind": "weekly",
    "time": "08:00",
    "weekday": 0
  },
  "channel": {
    "kind": "email",
    "recipients": []
  },
  "enabled": true,
  "environment": "prod",
  "id": "<string>",
  "metrics": [],
  "name": ""
}
'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Body

application/json

Create-or-update payload for a delivery (POST /api/deliveries). id present means update; absent means create. Structural validation only — cadence/channel/metrics business rules (caps, weekday range, Slack-not-configured) are enforced by deliveries_model.normalize_delivery so the 400 message stays in one place.

cadence
DeliveryCadenceRequest · object
channel
DeliveryChannelRequest · object
enabled
boolean
default:true
environment
string
default:prod
id
string | null
metrics
string[]
name
string
default:""

Response

Successful Response