Skip to main content

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

Terminal window
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

Terminal window
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

Terminal window
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

Terminal window
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

Terminal window
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.