---
title: "Get Project Active Steps"
method: GET
path: "/api/v1/projects/{project_id}/active-steps"
---

# Get Project Active Steps

`GET /api/v1/projects/{project_id}/active-steps`

## Request

- Base URL: `https://api.clipmaster.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.clipmaster.app/api/v1/projects/{project_id}/active-steps`
- Auth: HTTP bearer

Get all active/completed steps for a project's task.

Returns detailed information about each step in the pipeline:
- Steps currently running in parallel
- Completed steps
- Steps that errored

Use this endpoint to display real-time progress of parallel tasks in the UI.

## Path parameters

- `project_id` integer, required

## Response `200`

Successful Response

- ActiveStepsResponse: Response containing all active/completed steps for a project's task
  - `project_id` integer, required
  - `task_id` string, nullable
  - `task_status` string, nullable
  - `overall_progress` number, nullable
  - `overall_progress_percent` integer, nullable
  - `steps` ActiveStepInfo[], required
    - `step_name` string, required
    - `display_name` string, required
    - `status` string, required
    - `started_at` string, nullable
    - `completed_at` string, nullable
    - `message` string, required
    - `level` string, required
  - `total_steps` integer, required
  - `running_steps_count` integer, required
  - `completed_steps_count` integer, required
  - `error_steps_count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent.md) · [All operations](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent/llms.txt) · [OpenAPI document](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent/revisions/c9b8333cd22b?raw)