Pausing Delivery (Cost Control)
This page covers environment-level switches that can quickly reduce costs by stopping playback traffic.
- Pause delivery: blocks playback for the environment (playlists/segments/thumbnails/captions).
- Hide all: hides all videos in an environment (useful for “maintenance mode”).
Check current delivery settings
/delivery/settings
curl -X GET "https://api.antcdn.net/v1/delivery/settings" \ -H "X-Api-Key: ${APIKEY}"Example response:
{ "paused": false, "hideAll": false, "updatedAt": "2026-01-22T00:00:00Z"}Pause (or unpause) delivery
/delivery/pause
Pause delivery
curl -X POST "https://api.antcdn.net/v1/delivery/pause" \ -H "X-Api-Key: ${APIKEY}" \ -H "Content-Type: application/json" \ -d '{ "paused": true }'Unpause delivery
curl -X POST "https://api.antcdn.net/v1/delivery/pause" \ -H "X-Api-Key: ${APIKEY}" \ -H "Content-Type: application/json" \ -d '{ "paused": false }'When delivery is paused, playback requests will fail until unpaused.
Hide (or unhide) all videos
/visibility/hide-all
Hide everything
curl -X POST "https://api.antcdn.net/v1/visibility/hide-all" \ -H "X-Api-Key: ${APIKEY}" \ -H "Content-Type: application/json" \ -d '{ "hide": true }'Unhide everything
curl -X POST "https://api.antcdn.net/v1/visibility/hide-all" \ -H "X-Api-Key: ${APIKEY}" \ -H "Content-Type: application/json" \ -d '{ "hide": false }'Notes
- If your videos are private, pausing delivery is independent from JWT authentication. Even valid JWTs will not work while the environment is paused.
- If you’re looking for per-audience cost controls (e.g. cap free-tier users to 720p), use Edge Keys + quality defaults instead of pausing delivery.