Manage alert blackouts. A blackout suppresses alerts for a specific agent or server for a defined period.
get__blackout_
Code samples
# You can also use wget curl -X GET https://PEM-SERVER-IP/pem/api/v17/blackout/ \ -H 'Accept: application/json' \ -H 'X-Auth-Token: string'
import requests headers = { 'Accept': 'application/json', 'X-Auth-Token': 'string' } r = requests.get('https://PEM-SERVER-IP/pem/api/v17/blackout/', headers = headers) print(r.json())
const headers = { 'Accept':'application/json', 'X-Auth-Token':'string' }; fetch('https://PEM-SERVER-IP/pem/api/v17/blackout/', { method: 'GET', headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); });
GET /blackout/
List blackouts
Returns blackout records from pem.blackout (active + future scheduled). Optionally filter by object_type, object_id, or source. Pass include_history=true to also return archived records from pem.blackout_history.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | true | Token for authentication |
| object_type | query | integer | false | Filter by object type: 100 (agent) or 200 (server) |
| object_id | query | integer | false | Filter by specific object ID |
| source | query | string | false | Filter by source: manual, scheduled, or auto |
| include_history | query | boolean | false | If true, also include archived blackout records |
Enumerated Values
| Parameter | Value |
|---|---|
| object_type | 100 |
| object_type | 200 |
| source | manual |
| source | scheduled |
| source | auto |
Example responses
200 Response
{ "blackouts": [ { "id": 0, "start_time": "2019-08-24T14:15:22Z", "end_time": "2019-08-24T14:15:22Z", "object_type": 0, "object_id": 0, "source": "manual", "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20", "created_by": "string", "created_at": "2019-08-24T14:15:22Z" } ] }
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | List of blackout records | Inline |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » blackouts | [oneOf] | false | none | Active blackout records. When include_history=true, may also contain BlackoutHistory objects with additional actual_end_time and archived fields. |
oneOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| »» anonymous | Blackout | false | none | none |
| »»» id | integer | false | none | none |
| »»» start_time | string(date-time) | false | none | none |
| »»» end_time | string(date-time)¦null | false | none | none |
| »»» object_type | integer | false | none | 100=agent, 200=server |
| »»» object_id | integer | false | none | none |
| »»» source | string | false | none | none |
| »»» batch_id | string(uuid)¦null | false | none | none |
| »»» created_by | string | false | none | none |
| »»» created_at | string(date-time) | false | none | none |
xor
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| »» anonymous | BlackoutHistory | false | none | Archived blackout record. Returned by GET /blackout/?include_history=true (mixed with live rows) and by GET /blackout/{id} when the id is found only in pem.blackout_history. |
| »»» id | integer | false | none | none |
| »»» start_time | string(date-time) | false | none | none |
| »»» scheduled_end_time | string(date-time)¦null | false | none | Original end_time when the blackout was created |
| »»» actual_end_time | string(date-time) | false | none | When the blackout actually ended |
| »»» object_type | integer | false | none | 100=agent, 200=server |
| »»» object_id | integer | false | none | none |
| »»» source | string | false | none | none |
| »»» batch_id | string(uuid)¦null | false | none | none |
| »»» created_by | string | false | none | none |
| »»» created_at | string(date-time) | false | none | none |
| »»» archived | boolean | false | none | Always true for history records |
Enumerated Values
| Property | Value |
|---|---|
| source | manual |
| source | scheduled |
| source | auto |
| source | manual |
| source | scheduled |
| source | auto |
Info
This operation does not require authentication
post__blackout_
Code samples
# You can also use wget curl -X POST https://PEM-SERVER-IP/pem/api/v17/blackout/ \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'X-Auth-Token: string'
import requests headers = { 'Content-Type': 'application/json', 'Accept': 'application/json', 'X-Auth-Token': 'string' } r = requests.post('https://PEM-SERVER-IP/pem/api/v17/blackout/', headers = headers) print(r.json())
const inputBody = '{ "start_time": "2019-08-24T14:15:22Z", "duration": 1, "object_type": 100, "object_ids": [ 0 ] }'; const headers = { 'Content-Type':'application/json', 'Accept':'application/json', 'X-Auth-Token':'string' }; fetch('https://PEM-SERVER-IP/pem/api/v17/blackout/', { method: 'POST', body: inputBody, headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); });
POST /blackout/
Create one or more blackouts
Creates blackout records for specified objects. Multiple object_ids can be provided to create a batch.
Body parameter
{ "start_time": "2019-08-24T14:15:22Z", "duration": 1, "object_type": 100, "object_ids": [ 0 ] }
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | true | Token for authentication |
| body | body | object | true | none |
| » start_time | body | string(date-time) | true | When the blackout starts (ISO 8601) |
| » duration | body | integer | true | Length of the blackout in hours. Must be an integer from 1 to 24, matching the values offered by the Schedule Alert Blackout dialog so that REST-created blackouts render correctly in the UI. |
| » object_type | body | integer | true | 100 = agent, 200 = server |
| » object_ids | body | [integer] | true | Array of agent or server IDs |
Enumerated Values
| Parameter | Value |
|---|---|
| » duration | 1 |
| » duration | 2 |
| » duration | 3 |
| » duration | 4 |
| » duration | 5 |
| » duration | 6 |
| » duration | 7 |
| » duration | 8 |
| » duration | 9 |
| » duration | 10 |
| » duration | 11 |
| » duration | 12 |
| » duration | 13 |
| » duration | 14 |
| » duration | 15 |
| » duration | 16 |
| » duration | 17 |
| » duration | 18 |
| » duration | 19 |
| » duration | 20 |
| » duration | 21 |
| » duration | 22 |
| » duration | 23 |
| » duration | 24 |
| » object_type | 100 |
| » object_type | 200 |
Example responses
201 Response
{ "ids": [ 0 ], "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20" }
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Blackout(s) created successfully | Inline |
| 428 | Precondition Required | Validation error (invalid input, constraint violation) | None |
Response Schema
Status Code 201
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » ids | [integer] | false | none | none |
| » batch_id | string(uuid) | false | none | none |
Info
This operation does not require authentication
get__blackout_{blackout_id}
Code samples
# You can also use wget curl -X GET https://PEM-SERVER-IP/pem/api/v17/blackout/{blackout_id} \ -H 'Accept: application/json' \ -H 'X-Auth-Token: string'
import requests headers = { 'Accept': 'application/json', 'X-Auth-Token': 'string' } r = requests.get('https://PEM-SERVER-IP/pem/api/v17/blackout/{blackout_id}', headers = headers) print(r.json())
const headers = { 'Accept':'application/json', 'X-Auth-Token':'string' }; fetch('https://PEM-SERVER-IP/pem/api/v17/blackout/{blackout_id}', { method: 'GET', headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); });
GET /blackout/{blackout_id}
Get a specific blackout
Returns a blackout record. If the id is not present in pem.blackout, the handler falls back to pem.blackout_history and returns the archived record (distinguishable by "archived": true and the presence of actual_end_time / scheduled_end_time fields). Returns 404 if the id is not found in either table.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | true | Token for authentication |
| blackout_id | path | integer | true | none |
Example responses
200 Response
{ "id": 0, "start_time": "2019-08-24T14:15:22Z", "end_time": "2019-08-24T14:15:22Z", "object_type": 0, "object_id": 0, "source": "manual", "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20", "created_by": "string", "created_at": "2019-08-24T14:15:22Z" }
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Blackout record. May be a live row from pem.blackout (Blackout schema) or, when the id is found only in pem.blackout_history, an archived row (BlackoutHistory schema with archived=true). | Inline |
| 404 | Not Found | Blackout not found | None |
Response Schema
Enumerated Values
| Property | Value |
|---|---|
| source | manual |
| source | scheduled |
| source | auto |
| source | manual |
| source | scheduled |
| source | auto |
Info
This operation does not require authentication
delete__blackout_{blackout_id}
Code samples
# You can also use wget curl -X DELETE https://PEM-SERVER-IP/pem/api/v17/blackout/{blackout_id} \ -H 'Accept: application/json' \ -H 'X-Auth-Token: string'
import requests headers = { 'Accept': 'application/json', 'X-Auth-Token': 'string' } r = requests.delete('https://PEM-SERVER-IP/pem/api/v17/blackout/{blackout_id}', headers = headers) print(r.json())
const headers = { 'Accept':'application/json', 'X-Auth-Token':'string' }; fetch('https://PEM-SERVER-IP/pem/api/v17/blackout/{blackout_id}', { method: 'DELETE', headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); });
DELETE /blackout/{blackout_id}
End a blackout
Ends (archives) a blackout record, moving it to history.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | true | Token for authentication |
| blackout_id | path | integer | true | none |
Example responses
200 Response
{ "id": 0, "deleted": true, "warnings": [ { "code": "string", "message": "string" } ] }
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Blackout ended and archived | Inline |
| 404 | Not Found | Blackout not found | None |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » id | integer | false | none | ID of the ended blackout |
| » deleted | boolean | false | none | Always true on success |
| » warnings | [BlackoutWarning] | false | none | Optional non-fatal warnings — present only when the archive INSERT affected fewer rows than the DELETE returned (e.g. RLS or trigger drift on pem.blackout_history). Each warning carries the BlackoutId, ArchivedCount, and ExpectedArchived for diagnostics. |
| »» code | string | true | none | Stable warning identifier. Known codes: manual_post_state_unavailable (toggle response-shape SELECT failed after COMMIT), in_blackout_post_state_unavailable (likewise for the synced flag), flag_select_failed (status helper fell back to records-derived in_blackout), history_archive_incomplete (DELETE archived fewer rows than expected — investigate RLS / triggers on pem.blackout_history). |
| »» message | string | true | none | none |
Info
This operation does not require authentication
get__blackout_server_{sid}
Code samples
# You can also use wget curl -X GET https://PEM-SERVER-IP/pem/api/v17/blackout/server/{sid} \ -H 'Accept: application/json' \ -H 'X-Auth-Token: string'
import requests headers = { 'Accept': 'application/json', 'X-Auth-Token': 'string' } r = requests.get('https://PEM-SERVER-IP/pem/api/v17/blackout/server/{sid}', headers = headers) print(r.json())
const headers = { 'Accept':'application/json', 'X-Auth-Token':'string' }; fetch('https://PEM-SERVER-IP/pem/api/v17/blackout/server/{sid}', { method: 'GET', headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); });
GET /blackout/server/{sid}
Get blackout status for a server
Returns the synced alert_blackout flag and the breakdown of active records by source for the specified server.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | true | Token for authentication |
| sid | path | integer | true | Server id |
Example responses
200 Response
{ "object_type": 100, "object_id": 0, "in_blackout": true, "manual": { "id": 0, "start_time": "2019-08-24T14:15:22Z", "end_time": "2019-08-24T14:15:22Z", "object_type": 0, "object_id": 0, "source": "manual", "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20", "created_by": "string", "created_at": "2019-08-24T14:15:22Z" }, "scheduled": [ { "id": 0, "start_time": "2019-08-24T14:15:22Z", "end_time": "2019-08-24T14:15:22Z", "object_type": 0, "object_id": 0, "source": "manual", "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20", "created_by": "string", "created_at": "2019-08-24T14:15:22Z" } ], "auto": { "id": 0, "start_time": "2019-08-24T14:15:22Z", "end_time": "2019-08-24T14:15:22Z", "object_type": 0, "object_id": 0, "source": "manual", "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20", "created_by": "string", "created_at": "2019-08-24T14:15:22Z" }, "warnings": [ { "code": "string", "message": "string" } ] }
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Blackout status for the server. | ObjectBlackoutStatus |
| 404 | Not Found | No server with the given id exists. | None |
| 428 | Precondition Required | The server id was not provided in the path. | None |
Info
This operation does not require authentication
put__blackout_server_{sid}
Code samples
# You can also use wget curl -X PUT https://PEM-SERVER-IP/pem/api/v17/blackout/server/{sid} \ -H 'Accept: application/json' \ -H 'X-Auth-Token: string'
import requests headers = { 'Accept': 'application/json', 'X-Auth-Token': 'string' } r = requests.put('https://PEM-SERVER-IP/pem/api/v17/blackout/server/{sid}', headers = headers) print(r.json())
const headers = { 'Accept':'application/json', 'X-Auth-Token':'string' }; fetch('https://PEM-SERVER-IP/pem/api/v17/blackout/server/{sid}', { method: 'PUT', headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); });
PUT /blackout/server/{sid}
Enable manual blackout for a server
Idempotent. Inserts a manual indefinite record if none exists for this server; otherwise returns the existing record with changed=false. Only one active manual record per object is allowed (enforced by pem.idx_blackout_one_active_indefinite).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | true | Token for authentication |
| sid | path | integer | true | Server id |
Example responses
200 Response
{ "changed": true, "in_blackout": true, "manual": { "id": 0, "start_time": "2019-08-24T14:15:22Z", "end_time": "2019-08-24T14:15:22Z", "object_type": 0, "object_id": 0, "source": "manual", "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20", "created_by": "string", "created_at": "2019-08-24T14:15:22Z" }, "ended_records": [ { "id": 0, "source": "manual", "scheduled_end": "2019-08-24T14:15:22Z", "ended_early": true } ], "warnings": [ { "code": "string", "message": "string" } ] }
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Toggle result. changed=true on first enable; changed=false on idempotent no-op. | ObjectBlackoutToggleResult |
| 404 | Not Found | No object with the given id exists. | None |
Info
This operation does not require authentication
delete__blackout_server_{sid}
Code samples
# You can also use wget curl -X DELETE https://PEM-SERVER-IP/pem/api/v17/blackout/server/{sid} \ -H 'Accept: application/json' \ -H 'X-Auth-Token: string'
import requests headers = { 'Accept': 'application/json', 'X-Auth-Token': 'string' } r = requests.delete('https://PEM-SERVER-IP/pem/api/v17/blackout/server/{sid}', headers = headers) print(r.json())
const headers = { 'Accept':'application/json', 'X-Auth-Token':'string' }; fetch('https://PEM-SERVER-IP/pem/api/v17/blackout/server/{sid}', { method: 'DELETE', headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); });
DELETE /blackout/server/{sid}
End all blackouts on a server
Idempotent. Ends every active blackout record on this server regardless of source (manual + scheduled + auto). Matches the dashboard checkbox unchecking-an-already-active behaviour: the user intent is "alerts back on now". Records that had started are archived to pem.blackout_history; future-scheduled records are simply deleted.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | true | Token for authentication |
| sid | path | integer | true | Server id |
Example responses
200 Response
{ "changed": true, "in_blackout": true, "manual": { "id": 0, "start_time": "2019-08-24T14:15:22Z", "end_time": "2019-08-24T14:15:22Z", "object_type": 0, "object_id": 0, "source": "manual", "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20", "created_by": "string", "created_at": "2019-08-24T14:15:22Z" }, "ended_records": [ { "id": 0, "source": "manual", "scheduled_end": "2019-08-24T14:15:22Z", "ended_early": true } ], "warnings": [ { "code": "string", "message": "string" } ] }
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Toggle result. changed=true when at least one record was ended; changed=false on idempotent no-op. | ObjectBlackoutToggleResult |
| 404 | Not Found | No object with the given id exists. | None |
Info
This operation does not require authentication
get__blackout_agent_{aid}
Code samples
# You can also use wget curl -X GET https://PEM-SERVER-IP/pem/api/v17/blackout/agent/{aid} \ -H 'Accept: application/json' \ -H 'X-Auth-Token: string'
import requests headers = { 'Accept': 'application/json', 'X-Auth-Token': 'string' } r = requests.get('https://PEM-SERVER-IP/pem/api/v17/blackout/agent/{aid}', headers = headers) print(r.json())
const headers = { 'Accept':'application/json', 'X-Auth-Token':'string' }; fetch('https://PEM-SERVER-IP/pem/api/v17/blackout/agent/{aid}', { method: 'GET', headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); });
GET /blackout/agent/{aid}
Get blackout status for an agent
Returns the synced alert_blackout flag and the breakdown of active records by source for the specified agent.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | true | Token for authentication |
| aid | path | integer | true | Agent id |
Example responses
200 Response
{ "object_type": 100, "object_id": 0, "in_blackout": true, "manual": { "id": 0, "start_time": "2019-08-24T14:15:22Z", "end_time": "2019-08-24T14:15:22Z", "object_type": 0, "object_id": 0, "source": "manual", "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20", "created_by": "string", "created_at": "2019-08-24T14:15:22Z" }, "scheduled": [ { "id": 0, "start_time": "2019-08-24T14:15:22Z", "end_time": "2019-08-24T14:15:22Z", "object_type": 0, "object_id": 0, "source": "manual", "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20", "created_by": "string", "created_at": "2019-08-24T14:15:22Z" } ], "auto": { "id": 0, "start_time": "2019-08-24T14:15:22Z", "end_time": "2019-08-24T14:15:22Z", "object_type": 0, "object_id": 0, "source": "manual", "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20", "created_by": "string", "created_at": "2019-08-24T14:15:22Z" }, "warnings": [ { "code": "string", "message": "string" } ] }
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Blackout status for the agent. | ObjectBlackoutStatus |
| 404 | Not Found | No agent with the given id exists. | None |
| 428 | Precondition Required | The agent id was not provided in the path. | None |
Info
This operation does not require authentication
put__blackout_agent_{aid}
Code samples
# You can also use wget curl -X PUT https://PEM-SERVER-IP/pem/api/v17/blackout/agent/{aid} \ -H 'Accept: application/json' \ -H 'X-Auth-Token: string'
import requests headers = { 'Accept': 'application/json', 'X-Auth-Token': 'string' } r = requests.put('https://PEM-SERVER-IP/pem/api/v17/blackout/agent/{aid}', headers = headers) print(r.json())
const headers = { 'Accept':'application/json', 'X-Auth-Token':'string' }; fetch('https://PEM-SERVER-IP/pem/api/v17/blackout/agent/{aid}', { method: 'PUT', headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); });
PUT /blackout/agent/{aid}
Enable manual blackout for an agent
Idempotent. Inserts a manual indefinite record if none exists for this agent; otherwise returns the existing record with changed=false. Only one active manual record per object is allowed (enforced by pem.idx_blackout_one_active_indefinite).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | true | Token for authentication |
| aid | path | integer | true | Agent id |
Example responses
200 Response
{ "changed": true, "in_blackout": true, "manual": { "id": 0, "start_time": "2019-08-24T14:15:22Z", "end_time": "2019-08-24T14:15:22Z", "object_type": 0, "object_id": 0, "source": "manual", "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20", "created_by": "string", "created_at": "2019-08-24T14:15:22Z" }, "ended_records": [ { "id": 0, "source": "manual", "scheduled_end": "2019-08-24T14:15:22Z", "ended_early": true } ], "warnings": [ { "code": "string", "message": "string" } ] }
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Toggle result. changed=true on first enable; changed=false on idempotent no-op. | ObjectBlackoutToggleResult |
| 404 | Not Found | No object with the given id exists. | None |
Info
This operation does not require authentication
delete__blackout_agent_{aid}
Code samples
# You can also use wget curl -X DELETE https://PEM-SERVER-IP/pem/api/v17/blackout/agent/{aid} \ -H 'Accept: application/json' \ -H 'X-Auth-Token: string'
import requests headers = { 'Accept': 'application/json', 'X-Auth-Token': 'string' } r = requests.delete('https://PEM-SERVER-IP/pem/api/v17/blackout/agent/{aid}', headers = headers) print(r.json())
const headers = { 'Accept':'application/json', 'X-Auth-Token':'string' }; fetch('https://PEM-SERVER-IP/pem/api/v17/blackout/agent/{aid}', { method: 'DELETE', headers: headers }) .then(function(res) { return res.json(); }).then(function(body) { console.log(body); });
DELETE /blackout/agent/{aid}
End all blackouts on an agent
Idempotent. Ends every active blackout record on this agent regardless of source (manual + scheduled + auto). Matches the dashboard checkbox unchecking-an-already-active behaviour: the user intent is "alerts back on now". Records that had started are archived to pem.blackout_history; future-scheduled records are simply deleted.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | true | Token for authentication |
| aid | path | integer | true | Agent id |
Example responses
200 Response
{ "changed": true, "in_blackout": true, "manual": { "id": 0, "start_time": "2019-08-24T14:15:22Z", "end_time": "2019-08-24T14:15:22Z", "object_type": 0, "object_id": 0, "source": "manual", "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20", "created_by": "string", "created_at": "2019-08-24T14:15:22Z" }, "ended_records": [ { "id": 0, "source": "manual", "scheduled_end": "2019-08-24T14:15:22Z", "ended_early": true } ], "warnings": [ { "code": "string", "message": "string" } ] }
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Toggle result. changed=true when at least one record was ended; changed=false on idempotent no-op. | ObjectBlackoutToggleResult |
| 404 | Not Found | No object with the given id exists. | None |
Info
This operation does not require authentication