---
title: "List Deployments for an agent"
method: GET
path: "/deployment-history"
tags: ["Deployment History"]
---

# List Deployments for an agent

`GET /deployment-history`

List deployment history for an agent.

## Query parameters

- `agent_id` string, nullable
- `agent_name` string, nullable
- `limit` integer
- `page_number` integer
- `order_by` string, nullable
- `order_direction` string

## Response `200`

Successful Response

- DeploymentHistory[]
  - `id` string, required — The unique identifier of the deployment record
  - `agent_id` string, required — The ID of the agent this deployment belongs to
  - `author_name` string, required — Name of the commit author
  - `author_email` string, required — Email of the commit author
  - `branch_name` string, required — Name of the branch
  - `build_timestamp` string, date-time, required — When the build was created
  - `deployment_timestamp` string, date-time, required — When this deployment was first seen in the system
  - `commit_hash` string, required — Git commit hash for this deployment

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/scaleapi/apis/agentex-api.md) · [All operations](https://skmtc.dev/scaleapi/apis/agentex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scaleapi/agentex-api/revisions/1e0aaafd5780/schema)