---
title: "Get Task Trajectory"
method: GET
path: "/tasks/{task_id}/trajectory"
tags: ["Tasks"]
---

# Get Task Trajectory

`GET /tasks/{task_id}/trajectory`

Get the trajectory of a task.

## Path parameters

- `task_id` string, uuid, required

## Response `200`

Successful Response

- TaskTrajectoryResponse
  - `trajectory` union[], required — The trajectory of the task
    - union
      - TrajectoryQueuedEvent
        - `event` 'QueuedEvent', required
        - `data` QueuedEvent, required — Emitted to SSE clients when the task is waiting in the device queue.
          - `id` string, required
          - `status` string
      - TrajectoryCreatedEvent
        - `event` 'CreatedEvent', required
        - `data` CreatedEvent, required
          - `id` string, required
          - `streamUrl` string, required
      - TrajectoryExceptionEvent
        - `event` 'ExceptionEvent', required
        - `data` ExceptionEvent, required
          - `exception` string, required
      - TrajectoryCancelEvent
        - `event` 'CancelEvent', required
        - `data` CancelEvent, required
          - `reason` string, required
      - TrajectoryScreenshotEvent
        - `event` 'ScreenshotEvent', required
        - `data` ScreenshotEvent, required
          - `url` string, required
          - `index` integer, required
      - TrajectoryStartEvent
        - `event` 'StartEvent', required
        - `data` StartEvent, required — Implicit entry event sent to kick off a `Workflow.run()`.
      - TrajectoryFinalizeEvent
        - `event` 'FinalizeEvent', required
        - `data` FinalizeEvent, required — Trigger finalization.
          - `success` boolean, required
          - `reason` string, required
      - TrajectoryStopEvent
        - `event` 'StopEvent', required
        - `data` unknown, required
      - TrajectoryResultEvent
        - `event` 'ResultEvent', required
        - `data` unknown, required
      - TrajectoryManagerInputEvent
        - `event` 'ManagerInputEvent', required
        - `data` unknown, required
      - TrajectoryManagerPlanEvent
        - `event` 'ManagerPlanEvent', required
        - `data` unknown, required
      - TrajectoryExecutorInputEvent
        - `event` 'ExecutorInputEvent', required
        - `data` unknown, required
      - TrajectoryExecutorResultEvent
        - `event` 'ExecutorResultEvent', required
        - `data` unknown, required
      - TrajectoryFastAgentInputEvent
        - `event` 'FastAgentInputEvent', required
        - `data` unknown, required
      - TrajectoryFastAgentResponseEvent
        - `event` 'FastAgentResponseEvent', required
        - `data` unknown, required
      - TrajectoryFastAgentToolCallEvent
        - `event` 'FastAgentToolCallEvent', required
        - `data` unknown, required
      - TrajectoryFastAgentOutputEvent
        - `event` 'FastAgentOutputEvent', required
        - `data` unknown, required
      - TrajectoryFastAgentEndEvent
        - `event` 'FastAgentEndEvent', required
        - `data` unknown, required
      - TrajectoryFastAgentExecuteEvent
        - `event` 'FastAgentExecuteEvent', required
        - `data` unknown, required
      - TrajectoryFastAgentResultEvent
        - `event` 'FastAgentResultEvent', required
        - `data` unknown, required
      - TrajectoryToolExecutionEvent
        - `event` 'ToolExecutionEvent', required
        - `data` unknown, required
      - TrajectoryRecordUIStateEvent
        - `event` 'RecordUIStateEvent', required
        - `data` unknown, required
      - TrajectoryManagerContextEvent
        - `event` 'ManagerContextEvent', required
        - `data` unknown, required
      - TrajectoryManagerResponseEvent
        - `event` 'ManagerResponseEvent', required
        - `data` unknown, required
      - TrajectoryManagerPlanDetailsEvent
        - `event` 'ManagerPlanDetailsEvent', required
        - `data` unknown, required
      - TrajectoryExecutorContextEvent
        - `event` 'ExecutorContextEvent', required
        - `data` unknown, required
      - TrajectoryExecutorResponseEvent
        - `event` 'ExecutorResponseEvent', required
        - `data` unknown, required
      - TrajectoryExecutorActionEvent
        - `event` 'ExecutorActionEvent', required
        - `data` unknown, required
      - TrajectoryExecutorActionResultEvent
        - `event` 'ExecutorActionResultEvent', required
        - `data` unknown, required
      - TrajectoryUserMessageEvent
        - `event` 'UserMessageEvent', required
        - `data` unknown, required
      - TrajectoryUnknownEvent
        - `event` string, required
        - `data` object

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/mobilerun/apis/workflows.md) · [All operations](https://skmtc.net/mobilerun/apis/workflows/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobilerun/workflows/revisions/1bc499aa8f99/schema)