CYcyberdesk-hq
trajectories

List Trajectories

List all trajectories for the authenticated organization.

Supports pagination and filtering by workflow, run, approval, and generated status. Only approved trajectories are used during workflow execution. Returns trajectories with their associated workflow data.

Use the include parameter to fetch related resources in the response. Related resources are returned in the included array following the JSON:API pattern.

get/v1/trajectories

Request

  • Base URL
    https://api.cyberdesk.io
  • URL
    https://api.cyberdesk.io/v1/trajectories
  • Auth
    HTTP bearer

Query parameters

searchstring nullable

Search trajectories by id, name, or description (case-insensitive substring match)

workflow_idstring uuid nullable

Filter by workflow ID

run_idstring uuid nullable

Filter by run ID

is_approvedboolean nullable

Filter by approval status (true=approved, false=not approved)

is_generatedboolean nullable

Filter by generated status (true=generated, false=pending generation). Defaults to true.

created_at_fromstring date-time nullable

Filter trajectories created at or after this ISO timestamp (UTC)

created_at_tostring date-time nullable

Filter trajectories created at or before this ISO timestamp (UTC)

updated_at_fromstring date-time nullable

Filter trajectories updated at or after this ISO timestamp (UTC)

updated_at_tostring date-time nullable

Filter trajectories updated at or before this ISO timestamp (UTC)

includestring nullable

Comma-separated list of related resources to include. Allowed values: workflow. Example: include=workflow

skipinteger
limitinteger

Response

Successful Response

totalinteger required
skipinteger required
limitinteger required

Changes

No recorded changes to this operation across all 2 revisions of this API.