> ## Documentation Index > Fetch the complete documentation index at: https://docs.cyberdesk.io/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /openapi.json get /v1/trajectories openapi: 3.1.0 info: title: Cyberdesk Cloud description: >- The Cyberdesk API provides programmatic access to all platform features, enabling you to automate desktop tasks at scale. version: 1.0.0 servers: - url: https://api.cyberdesk.io description: Production server - url: https://cyberdesk-api-dev.fly.dev description: Development server security: [] paths: /v1/trajectories: get: tags: - trajectories summary: List Trajectories description: >- 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. operationId: list_trajectories_v1_trajectories_get parameters: - name: search in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Search trajectories by id, name, or description (case-insensitive substring match) title: Search description: >- Search trajectories by id, name, or description (case-insensitive substring match) - name: workflow_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' description: Filter by workflow ID title: Workflow Id description: Filter by workflow ID - name: run_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' description: Filter by run ID title: Run Id description: Filter by run ID - name: is_approved in: query required: false schema: anyOf: - type: boolean - type: 'null' description: Filter by approval status (true=approved, false=not approved) title: Is Approved description: Filter by approval status (true=approved, false=not approved) - name: is_generated in: query required: false schema: anyOf: - type: boolean - type: 'null' description: >- Filter by generated status (true=generated, false=pending generation). Defaults to true. default: true title: Is Generated description: >- Filter by generated status (true=generated, false=pending generation). Defaults to true. - name: created_at_from in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' description: Filter trajectories created at or after this ISO timestamp (UTC) title: Created At From description: Filter trajectories created at or after this ISO timestamp (UTC) - name: created_at_to in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' description: Filter trajectories created at or before this ISO timestamp (UTC) title: Created At To description: Filter trajectories created at or before this ISO timestamp (UTC) - name: updated_at_from in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' description: Filter trajectories updated at or after this ISO timestamp (UTC) title: Updated At From description: Filter trajectories updated at or after this ISO timestamp (UTC) - name: updated_at_to in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' description: Filter trajectories updated at or before this ISO timestamp (UTC) title: Updated At To description: Filter trajectories updated at or before this ISO timestamp (UTC) - name: include in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Comma-separated list of related resources to include. Allowed values: workflow. Example: include=workflow title: Include description: >- Comma-separated list of related resources to include. Allowed values: workflow. Example: include=workflow - name: skip in: query required: false schema: type: integer minimum: 0 default: 0 title: Skip - name: limit in: query required: false schema: type: integer maximum: 1000 minimum: 1 default: 100 title: Limit responses: '200': description: Successful Response content: application/json: schema: $ref: >- #/components/schemas/PaginatedResponseWithIncludes_TrajectoryResponse_ '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: PaginatedResponseWithIncludes_TrajectoryResponse_: properties: items: items: $ref: '#/components/schemas/TrajectoryResponse' type: array title: Items total: type: integer title: Total skip: type: integer title: Skip limit: type: integer title: Limit included: anyOf: - items: $ref: '#/components/schemas/IncludedResource' type: array - type: 'null' title: Included description: Related resources requested via the `include` query parameter type: object required: - items - total - skip - limit title: PaginatedResponseWithIncludes[TrajectoryResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError TrajectoryResponse: properties: name: anyOf: - type: string maxLength: 255 - type: 'null' title: Name description: anyOf: - type: string - type: 'null' title: Description workflow_id: type: string format: uuid title: Workflow Id run_id: anyOf: - type: string format: uuid - type: 'null' title: Run Id description: Optional run that created this trajectory trajectory_data: items: additionalProperties: true type: object type: array minItems: 1 title: Trajectory Data dimensions: additionalProperties: type: integer type: object title: Dimensions description: Display dimensions when trajectory was recorded original_input_values: anyOf: - additionalProperties: true type: object - type: 'null' title: Original Input Values description: Original input values used when trajectory was created is_approved: type: boolean title: Is Approved has_been_approved: type: boolean title: Has Been Approved is_generated: type: boolean title: Is Generated is_main: type: boolean title: Is Main id: type: string format: uuid title: Id user_id: anyOf: - type: string format: uuid - type: 'null' title: User Id organization_id: anyOf: - type: string - type: 'null' title: Organization Id created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At type: object required: - workflow_id - trajectory_data - dimensions - is_approved - has_been_approved - is_generated - is_main - id - created_at - updated_at title: TrajectoryResponse description: Trajectory response schema IncludedResource: properties: type: type: string title: Type description: Resource type (e.g., 'workflow', 'machine', 'pool') id: type: string format: uuid title: Id description: Resource UUID additionalProperties: true type: object required: - type - id title: IncludedResource description: >- A resource in the JSON:API-style included array. Each included resource has a `type` field indicating what kind of resource it is (e.g., "workflow", "machine", "pool") and an `id` field with the resource's UUID. All other fields from the resource's response model are included. Example: { "type": "workflow", "id": "550e8400-e29b-41d4-a716-446655440000", "name": "My Workflow", "main_prompt": "Do something...", "created_at": "2024-01-15T10:30:00Z" } ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object additionalProperties: true title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: HTTPBearer: type: http scheme: bearer ````