---
title: "Suggest Labels"
method: POST
path: "/core/labels/suggest"
tags: ["Labels"]
---

# Suggest Labels

`POST /core/labels/suggest`

## Request

- Base URL: `https://api.anyreach.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.anyreach.ai/core/labels/suggest`
- Auth: HTTP bearer

Propose a value of a curated label for each agent or workflow.

Never writes. Context per entity is its name, description, company name
and URL, and for agents the start of the published instructions.

## Headers

- `x-anyreach-org` string, nullable: Organization ID for user PATs (pat_ prefix tokens)

## Request body

- LabelSuggestRequest
  - `entity_type` 'agent' | 'workflow', required
  - `key_id` string, uuid, required
  - `ids` string[], required

## Response `200`

Successful Response

- LabelSuggestResponse
  - `suggestions` LabelSuggestion[]
    - `id` string, required
    - `value` string, required
  - `skipped` string[]

## Other responses

- `422`: Validation Error

---

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