---
title: "Get Agent Labels"
method: GET
path: "/workflows/{workflow_id_or_name}/labels"
tags: ["workflow", "release-labels"]
---

# Get Agent Labels

`GET /workflows/{workflow_id_or_name}/labels`

## Path parameters

- `workflow_id_or_name` string, required

## Response `200`

Labels retrieved successfully

- object
  - `success` boolean, required
  - `release_labels` object[], required
    - `release_label` string, required — Label name (e.g. 'prod', 'staging')
    - `release_label_id` integer, required — Unique identifier for the label
    - `workflow_version_id` integer, required — Version ID this label points to
    - `workflow_version_number` integer, required — Version number this label points to

## Other responses

- `401` — Unauthorized - missing or invalid API key.
- `404` — Agent not found
- `422` — Validation error - request parameters or body are invalid.

---

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