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

# List run tag suggestions

`GET /v1/run-tag-suggestions`

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.

## Headers

- `x-api-key` string, nullable — Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

## 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

---

[API](https://skmtc.net/skyvern-ai/apis/skyvern-api-2.md) · [All operations](https://skmtc.net/skyvern-ai/apis/skyvern-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyvern-ai/skyvern-api-2/versions/29562c6e0364/schema)