Edit Trajectory

Update an existing trajectory. You can change its name, replace the survey points, or update the survey programs for actual trajectories.

All fields are optional — only include what you want to change.

PATCH/api/v1/designs/{designid}/trajectories/{trajectoryid}

Modify an existing trajectory's name, points, or survey programs

Path Parameters

Name	Type	Required	Description
designid	string (UUID)	✓	The UUID of the design
trajectoryid	string (UUID)	✓	The UUID of the trajectory to update

Headers

Name	Value	Description
apikey	YOUR_API_KEY	Your API authentication key
Content-Type	application/json	Must be application/json

Request Body

Fields to update on the trajectory

Request body fields

All fields are optional — include only what you want to change.

Field	Type	Description
name	string	New display name
trajectoryPoints	object	Replacement survey points (planned trajectories only)
surveyPrograms	array	Updated survey program references (actual trajectories only)

Important constraints

Rule	Details
Cannot mix points and programs	A single request must use either trajectoryPoints or surveyPrograms, never both
Actual trajectories	Cannot update trajectoryPoints directly — use surveyPrograms to change which survey runs are included
Planned trajectories	Cannot use surveyPrograms — use trajectoryPoints to update the well path

Notes

• When you update trajectoryPoints, the entire point set is replaced (not merged)
• When you update surveyPrograms, the trajectory is recalculated from the referenced survey runs
• Renaming a trajectory (changing name only) does not affect the survey data