---
title: "List Workflow Commits"
method: GET
path: "/workspaces/{workspace_id}/workflows/sync/commits"
tags: ["workflows"]
---

# List Workflow Commits

`GET /workspaces/{workspace_id}/workflows/sync/commits`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/workspaces/{workspace_id}/workflows/sync/commits`
- Auth: one of:
  - API key in cookie `fastapiusersauth`
  - HTTP bearer

Get commit list for the configured workspace repository.

Returns a list of commits from the repository configured in workspace settings,
suitable for use in workflow pull operations.

## Path parameters

- `workspace_id` string, uuid, required

## Query parameters

- `branch` string: Branch name to fetch commits from
- `limit` integer: Maximum number of commits to return

## Response `200`

Successful Response

- GitCommitInfo[]
  - `sha` string, required: The commit SHA hash
  - `message` string, required: The commit message
  - `author` string, required: The commit author name
  - `author_email` string, required: The commit author email
  - `date` string, required: The commit date in ISO format
  - `tags` string[]: List of tags associated with this commit

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tracecat/apis/tracecat-api.md) - [All operations](https://skmtc.dev/tracecat/apis/tracecat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tracecat/apis/tracecat-api/revisions/2efdda25045f?raw)