Skip to main content
POST
Create Trajectory

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json

Schema for creating a trajectory.

Note: is_generated is intentionally omitted here. New trajectories always start as non-generated and must be promoted via POST /runs/{run_id}/generate-trajectory.

Note: is_main is intentionally omitted here. Main-trajectory designation is managed after creation via trajectory updates.

workflow_id
string<uuid>
required
trajectory_data
Trajectory Data · object[]
required
Minimum array length: 1
dimensions
Dimensions · object
required

Display dimensions when trajectory was recorded

name
string | null
Maximum string length: 255
description
string | null
run_id
string<uuid> | null

Optional run that created this trajectory

original_input_values
Original Input Values · object | null

Original input values used when trajectory was created

is_approved
boolean
default:false

Whether this trajectory is approved for use

Response

Successful Response

Trajectory response schema

workflow_id
string<uuid>
required
trajectory_data
Trajectory Data · object[]
required
Minimum array length: 1
dimensions
Dimensions · object
required

Display dimensions when trajectory was recorded

is_approved
boolean
required
has_been_approved
boolean
required
is_generated
boolean
required
is_main
boolean
required
id
string<uuid>
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
name
string | null
Maximum string length: 255
description
string | null
run_id
string<uuid> | null

Optional run that created this trajectory

original_input_values
Original Input Values · object | null

Original input values used when trajectory was created

user_id
string<uuid> | null
organization_id
string | null