2026-10-23 12.00 UTC - There are currently no active events. All systems operational.

Record or clear a Skip or Disable on a TV observation

Prev Next
Post
/tv-observation-review/

Operation is used to record that a user judged one TV observation without writing anything to the network: reviewed is Skip ("Not update"), disabled_from_update keeps the observation out of every update. A null review_state clears either.

updated is not accepted here. That state is set by /tv-inspection/apply-duct-diff/ (and its batch) on the observation the duct values were read from, so it cannot be claimed without a write. An observation already marked updated cannot be changed or cleared: the duct keeps the correction, so rewriting the state would erase the only record of it.

Security
API Key: Token
Header parameter nameAuthorization

Token issued for API consumer.

Body parameters
object
review_state
string | null Required

The outcome recorded for this observation, or null to clear it.

Valid values[ "reviewed", "disabled_from_update" ]
tv_observation_id
integer Required

Id of the TV observation that was judged

Responses
200

The review was recorded or cleared

object
review_state
string | null

The recorded outcome. Null once cleared.

Valid values[ "reviewed", "disabled_from_update" ]
reviewed_by
string | null

Username of the user who judged the observation. Null once cleared.

reviewed_ts
string (date-time) | null

When the observation was judged. Null once cleared.

tv_observation_id
integer

Id of the observation that was judged

400

There was an error in request. Field validation failed, a state only the apply endpoint may set was requested, or the observation is already updated.

object

Fields which failed validation

property*
Array additionalProperties

List of validation errors for this fieldname

401

Authentication credentials are missing or invalid

{
  "details": "Authentication credentials were not provided"
}
object

Standard error response payload

details
string

Detailed description of error

403

The user may not modify this TV inspection.

404

Object was not found

{
  "details": "Not found."
}
object

Standard error response payload

details
string

Detailed description of error