Deactivate Custom Error Template
Stop serving a custom error page without deleting it. The template's is_active flag is cleared; while no template of its type is active, the edge serves the built-in default error page for that condition again. Turn it back on with Activate Template.
Deactivating a template that is already inactive succeeds and changes nothing. The call takes no body.
Requires the endpoints:update permission on the active account. Not plan-gated, so an account that lost custom_error_pages can still switch its pages off.
Path parameters
uuid string (uuid) Req
The template's
uuid, from List Templates.Deprecated: the legacy integer id is still accepted in the path until the sunset, answered with Deprecation and Sunset headers. Use the uuid.
Response (200 OK)
Empty body.
Errors
400 Bad Request
An integer id after the sunset (
integer_id_unsupported).401 Unauthorized
Missing or invalid auth.
403 Forbidden
The caller lacks
endpoints:update, or the account is suspended (code account_suspended).404 Not Found
Template not found — unknown uuid, or a template of another account.409 Conflict
The template is paused over the plan's custom error page limit (code
quota_paused, with quota_paused_key: "custom_error_pages"). Delete it, or another page, instead.415 Unsupported Media Type
The request has no
Content-Type: application/json header.500 Internal Server Error
Failed to deactivate template.503 Service Unavailable
The template's plan status could not be read (
Could not verify this custom error page's plan status — try again in a moment).Request
curl -X POST "https://api.ngris.com/v1/templates/019b7e40-d9ff-71da-89df-426166ab61bd/deactivate" \
-H "X-API-KEY: <your_api_key>" \
-H "Content-Type: application/json"
Response — 200 OK
(empty body)