---
title: "List Trajectories"
method: GET
path: "/v1/trajectories"
tags: ["trajectories"]
---

# List Trajectories

`GET /v1/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.

## Query parameters

- `search` string, nullable — Search trajectories by id, name, or description (case-insensitive substring match)
- `workflow_id` string, uuid, nullable — Filter by workflow ID
- `run_id` string, uuid, nullable — Filter by run ID
- `is_approved` boolean, nullable — Filter by approval status (true=approved, false=not approved)
- `is_generated` boolean, nullable — Filter by generated status (true=generated, false=pending generation). Defaults to true.
- `created_at_from` string, date-time, nullable — Filter trajectories created at or after this ISO timestamp (UTC)
- `created_at_to` string, date-time, nullable — Filter trajectories created at or before this ISO timestamp (UTC)
- `updated_at_from` string, date-time, nullable — Filter trajectories updated at or after this ISO timestamp (UTC)
- `updated_at_to` string, date-time, nullable — Filter trajectories updated at or before this ISO timestamp (UTC)
- `include` string, nullable — Comma-separated list of related resources to include. Allowed values: workflow. Example: include=workflow
- `skip` integer
- `limit` integer

## Response `200`

Successful Response

- PaginatedResponseWithIncludesTrajectoryResponse
  - `items` TrajectoryResponse[], required
    - `name` string, nullable
    - `description` string, nullable
    - `workflow_id` string, uuid, required
    - `run_id` string, uuid, nullable — Optional run that created this trajectory
    - `trajectory_data` object[], required
    - `dimensions` object, required — Display dimensions when trajectory was recorded
    - `original_input_values` object, nullable — Original input values used when trajectory was created
    - `is_approved` boolean, required
    - `has_been_approved` boolean, required
    - `is_generated` boolean, required
    - `is_main` boolean, required
    - `id` string, uuid, required
    - `user_id` string, uuid, nullable
    - `organization_id` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total` integer, required
  - `skip` integer, required
  - `limit` integer, required
  - `included` IncludedResource[], nullable — Related resources requested via the `include` query parameter
    - `type` string, required — Resource type (e.g., 'workflow', 'machine', 'pool')
    - `id` string, uuid, required — Resource UUID

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/cyberdesk-hq/apis/cyberdesk-cloud.md) · [All operations](https://skmtc.net/cyberdesk-hq/apis/cyberdesk-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cyberdesk-hq/cyberdesk-cloud/versions/830d2f48963d/schema)