Delete user time frame

DELETE

/domains/{domain}/users/{user}/timeframes/{id}

Last modified:2026-09-28 00:11:17

OperationId:DeleteTimeframeUser

Deletes a time frame and every entry in it, or one entry when you send child_id. Requires Basic User for your own time frames, or Site Manager, Office Manager, Reseller, or Super User for the users you administer. An Office Manager can delete for any user in its domain, and a Site Manager for any user in its own site. A user outside your reach returns 403 with Issue with timeframe access.

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/users/1001/timeframes/7ae64ba3e46676fc728618a616e92424?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:11:17

Add entries to user time frame

Create user time frame