Delete domain time frame

DELETE

/domains/{domain}/timeframes/{id}

Last modified:2026-09-28 00:10:02

OperationId:DeleteTimeframeDomain

Deletes a time frame and every entry in it, or one entry when you send child_id. Requires Site Manager, Office Manager, Reseller, or Super User. A Basic User can read shared time frames but gets 403 on a write.

The delete is published over the service bus (SBUS) and applied a moment later, so the call answers 202.

Whole time frame. Send no body. Answer rules that use the time frame are not changed or deleted, and they keep naming a time frame that no longer exists. Move those rules to another time frame first, with the answer rule endpoints.

One entry. Send child_id, the timeframe-id of the date range, days of week entry, or holiday. The time frame stays. A child_id that is not in the time frame returns 404 with Timeframe entry not found.

An ID that does not exist, or that belongs to another owner than the path, returns 404 with Timeframe not found.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

The delete was published and is being applied.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠404Record not found

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

Delete time frameDelete one entry

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/domains/example.com/timeframes/94d4b86a0e8bedd0bb61feaa0aa0a4db?child_id=66f6c1a2b3d4f' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'

Response Example

202 - Delete time frame

The delete was published and is being applied.

{
    "code": 202,
    "message": "Accepted"
}

Modified at 2026-09-28 00:10:02

Add entries to domain time frame

Create domain time frame