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

Move a sewer branch to where a branch observation places it

Prev Next
Post
/tv-observation-branch-correction/

Operation is used to correct a sewer branch drawn in the wrong place from a TV (CCTV) branch observation. The branch moves to the observation's point - its own coordinates, else its station along the inspection's linked duct - at its own height, since a TV observation records none. The ends of the ducts connected to the branch move with it.

The branch also takes the observation's distance from the node and clock position, and x_y_origin is set to the DataOrigin the import made for the inspection, found by the inspection's contractor and date. When none or several match, the correction is refused rather than recorded with a guessed source. The observation is recorded as updated.

Only the branch the comparison matches is moved: the nearest the user may open within 0.5 m. A disabled observation is refused.

Security
API Key: Token
Header parameter nameAuthorization

Token issued for API consumer.

Body parameters
object
snsewerbranch_id
integer Required

Id of the branch the comparison matched

tv_observation_id
integer Required

Id of the branch observation

Responses
200

Correction result

object
snsewerbranch_id
integer
snsewerduct_ids
Array of integer

The ducts whose end moved with the branch.

integer
tv_observation_id
integer
updated_fields
Array of string

The branch's fields that were written.

string
x_y_origin_id
integer

The DataOrigin recorded as the source of the branch's position.

400

The observation records no branch, is disabled, cannot be placed, the branch is not the nearest one, or the inspection's data origin does not resolve to exactly one row.

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 view this TV inspection or modify the branch and its ducts.

404

Object was not found

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

Standard error response payload

details
string

Detailed description of error