Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tenbyte.io/llms.txt

Use this file to discover all available pages before exploring further.

Day-2 operations for distributions: editing config, pausing traffic, deleting, and bulk-managing through the API.

Console actions

From the CDN workspace, every distribution row has an Action menu:
ActionEffectReversible?
ManageOpens the detail dashboard for the distribution.n/a
DisablePauses the distribution; hostname returns 503 until re-enabled.Yes — re-enable from the same menu.
DeletePermanently removes the distribution and frees its hostname.No — config and analytics are gone.
Delete is final. Disable first, watch traffic for 24 h, then delete. Edit DNS to remove any CNAME pointing at the distribution before deletion to avoid 503s for live users.

Edit configuration

Open Manage, then use the left sidebar:
TabWhat you change
OverviewName, description, see status.
OriginsSwap origins, rotate S3 keys.
SSLIssue / upload certs, toggle HTTP/2 and HTTP/3.
HeadersHost header, CORS, request / response header rules.
Cache RulesPer-path TTLs and cache-key behavior.
Access RulesCountry / IP / referrer / token gates.
Image OptimizerEnable on-the-fly transforms.
All edits propagate within ~1 minute. The Status flips to Updating while config rolls out.

Manage via API

List distributions:
curl -sS "https://api.tenbyte.io/cdn/distributions" \
  -H "Authorization: Bearer $TENBYTE_API_TOKEN" | jq '.data[] | {id, name, domain, status}'
Update config:
curl -X PATCH "https://api.tenbyte.io/cdn/distributions/$DISTRIBUTION_ID" \
  -H "Authorization: Bearer $TENBYTE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"description": "Owned by web-platform team. Runbook: wiki/cdn-prod"}'
Disable / enable:
curl -X POST "https://api.tenbyte.io/cdn/distributions/$DISTRIBUTION_ID/disable" \
  -H "Authorization: Bearer $TENBYTE_API_TOKEN"

curl -X POST "https://api.tenbyte.io/cdn/distributions/$DISTRIBUTION_ID/enable" \
  -H "Authorization: Bearer $TENBYTE_API_TOKEN"
Delete (only after disable + DNS cleanup):
curl -X DELETE "https://api.tenbyte.io/cdn/distributions/$DISTRIBUTION_ID" \
  -H "Authorization: Bearer $TENBYTE_API_TOKEN"
See the CDN API reference for exact field shapes.

Operational tips

  • Tag in description — owner, runbook URL, on-call rotation. The console exposes Description in lists; helps incident response.
  • One distribution per environment — separate prod, staging, dev. Lets you change config in staging without risking prod.
  • Version your config — keep the API JSON payload in your IaC repo. PR-review changes before applying.
  • Audit before delete — confirm zero traffic via Analytics for at least 24 h.
  • DNS first, then disable — flipping the order causes a brief outage for live users.