Create Trajectory
Create a new trajectory for a design. You can create either a planned trajectory (a designed well path) or an actual trajectory (from real survey data).
For planned trajectories, supply trajectoryPoints with at least MD, inclination, and azimuth for each station. For actual trajectories, you can either provide trajectoryPoints directly or supply surveyPrograms that reference existing survey runs.
Create a new planned or actual trajectory for the design
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
designid | string (UUID) | ✓ | The UUID of the design |
Headers
| Name | Value | Description |
|---|---|---|
apikey | YOUR_API_KEY | Your API authentication key |
Content-Type | application/json | Must be application/json |
Request Body
Trajectory definition with name, type, and survey points
Request body fields
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Display name for the trajectory |
type | "planned" or "actual" | Yes | Trajectory type — must match the design category |
trajectoryPoints | object | Conditional | Survey points table (see format below) |
surveyPrograms | array | Conditional | References to survey runs with depth intervals |
depthReference | "RKB" or "MSL" | No | Depth reference datum (defaults to RKB) |
airGap | string | No | Air gap measurement, e.g. "25|m" |
Which fields to use
| Trajectory type | Required data |
|---|---|
| Planned | trajectoryPoints is required. surveyPrograms is not allowed. |
| Actual (from points) | Provide trajectoryPoints only. |
| Actual (from survey runs) | Provide surveyPrograms only. Survey runs must already exist. |
You cannot provide both trajectoryPoints and surveyPrograms in the same request.
Trajectory points format
Provide points as a compact table with headers and values. The minimum required headers are:
| Header key | Quantity | Unit | Description |
|---|---|---|---|
depthMD | depth | m | Measured depth |
inclination | angles | deg | Wellbore inclination |
azimuth | angles | deg | Wellbore azimuth |
The server calculates TVD, dogleg, positions, and other derived values automatically.
Notes
- The trajectory type must match the design category — you cannot create a planned trajectory on an actual design
- Only one trajectory is allowed per planned design
- Station values should be in ascending measured depth order