Overrides

Temporarily force resources on or off — overrides take precedence over schedules until they expire or are deleted.

Overrides provide a way to temporarily force resources on or off, taking precedence over any active schedules.

Overview

Overrides are useful for situations like production incidents, maintenance windows, or demo environments where you need to keep resources running regardless of their schedule.

Override Actions

Action	Behavior
`force_on`	Keeps the resource running. Scheduler skip-stop actions are ignored.
`force_off`	Keeps the resource stopped. Scheduler skip-start actions are ignored.

Create Override

POST/overrides

Create an override for a specific resource.

Request · bash

curl -X POST https://zopnight.com/api/overrides \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
  "resourceUID": "i-0abc123def456",
  "action": "force_on",
  "reason": "Production incident - keep running for investigation",
  "expiresAt": "2025-01-20T18:00:00Z"
}'

Response · json

{
"data": {
  "id": "ovr_abc123",
  "resourceUID": "i-0abc123def456",
  "action": "force_on",
  "reason": "Production incident - keep running for investigation",
  "createdBy": "user@company.com",
  "expiresAt": "2025-01-20T18:00:00Z",
  "createdAt": "2025-01-20T10:00:00Z"
}
}

Create Group Override

POST/resource-groups/{groupID}/overrides

Create an override for all resources in a group.

Request · bash

curl -X POST https://zopnight.com/api/resource-groups/grp_abc123/overrides \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
  "action": "force_on",
  "reason": "Demo environment for client presentation",
  "expiresAt": "2025-01-22T20:00:00Z"
}'

List Overrides

GET/overrides

List all active overrides for your organization.

List Group Overrides

GET/resource-groups/{groupID}/overrides

List overrides for a specific resource group.

Get Override

GET/overrides/{overrideID}

Get details of a specific override.

Delete Override

DELETE/overrides/{overrideID}

Cancel an override. The resource will resume following its schedule.

Example · bash

curl -X DELETE https://zopnight.com/api/overrides/ovr_abc123 \
-H "Authorization: Bearer <token>"

Override Object

Field	Type	Description
`id`	string	Unique override ID
`resourceUID`	string	Cloud resource UID (for resource overrides)
`groupID`	string?	Resource group ID (for group overrides)
`action`	string	`force_on` or `force_off`
`reason`	string	Human-readable reason for the override
`createdBy`	string	Email of the creator
`expiresAt`	string	ISO 8601 expiry timestamp
`createdAt`	string	ISO 8601 creation timestamp