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

Create sewer branches from CCTV connection observations

Prev Next
Post
/tv-inspection/{inspection_id}/create-branches/

Creates a sewer branch node, a two-segment sewer duct, and a valve for every GR, OP, PB, PH, or PÅ observation on the linked CCTV inspection, or for the one named by tv_observation_id. The inspection must already be linked to a sewer duct. The request body is optional.

The branch starts at the observation station on the linked duct. Its first segment is 5 metres at 45 degrees to the main duct flow direction, and its second segment is 10 metres perpendicular to the main duct. The observation clock reference selects the side of the main duct. The created objects are linked through keycore_object_link.

Security
API Key: Token
Header parameter nameAuthorization

Token issued for API consumer.

Path parameters
inspection_id
integerRequired

Primary key of the linked CCTV inspection.

Body parameters
object
tv_observation_id
integer | null

The one branch observation to create a branch from. Omitted or null: a branch observation of this inspection is refused.

Responses
200

Branch network objects were created for the supported connection observations. An inspection without supported observations returns an empty created array.

Expand All
object
created
Array of object
object
observation_id
integer

Primary key of the connection observation.

snsewerbranch_id
integer

Primary key of the created sewer branch node.

snsewerduct_id
integer

Primary key of the created two-segment sewer duct.

snsewervalve_id
integer

Primary key of the created sewer valve node.

400

The inspection is not linked, or a connection observation, defaults, geometry, or duct type is invalid.

403

The user lacks permission to modify the inspection or create network objects.

404

The inspection or its linked sewer duct does not exist.