---
title: "List run tag suggestions"
method: GET
path: "/v1/run-tag-suggestions"
tags: ["Tags"]
---

# List run tag suggestions

`GET /v1/run-tag-suggestions`

## Request

- Base URL: `https://api.skyvern.com`
- URL: `https://api.skyvern.com/v1/run-tag-suggestions`
- Auth: API key in header `x-api-key`

List distinct (key, value) pairs ever set on a run for the organization, sourced from the run-tag event log rather than the tag-key/tag-value registry. Surfaces reserved 'skyvern.*' system keys (which are never registered) so pickers can offer them alongside user-defined tags.

## Response `200`

Successfully retrieved run tag suggestions

- RunTagSuggestionsResponse: Response for ``GET /v1/run-tag-suggestions``: distinct (key, value) pairs ever set on a run for the org, sourced from the event log rather than the tag-key/tag-value registry so reserved ``skyvern.*`` system keys (never registered) reach the pickers too.
  - `keys` string[]: Distinct grouped tag keys seen on runs.
  - `values_by_key` object: Values seen for each grouped key.
  - `labels` string[]: Distinct standalone (keyless) labels seen on runs.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `539f04093540`: 1 warning, 1 info
  - deleted the `header` request parameter `x-api-key`
  - the endpoint scheme security `ApiKeyAuth` was added to the API
- **2026-07-14** `4aae03aca7da`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/changes/v1/run-tag-suggestions/get.md)

---

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