---
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: none declared

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

## Changes

- **2026-10-08** `04df18172f4d`: 1 info
  - endpoint added

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

---

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