---
title: "Enrich one intent description"
method: POST
path: "/dashboard/api/enrich-intent"
tags: ["Sentiments"]
---

# Enrich one intent description

`POST /dashboard/api/enrich-intent`

## Request

- Base URL: `https://api.agnost.ai`
- URL: `https://api.agnost.ai/dashboard/api/enrich-intent`
- Auth: one of:
  - HTTP bearer and API key in header `x-org-id`
  - API key in header `x-api-key`

Improves an existing User Intent description while preserving its name.
The returned description contains explicit Includes and Excludes clauses.

## Request body

- object
  - `name` string, required
  - `description` string, required

## Response `200`

Enriched intent description

- object
  - `description` string, required

## Other responses

- `400`: Invalid request body or missing organization scope
- `422`: Invalid intent name or description
- `500`: Intent enrichment failed or returned invalid output
- `503`: AI service is not configured

## Changes

- **2026-11-03** `a61431b48f36`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agnost/apis/agnost-ai-api/changes/dashboard/api/enrich-intent/post.md)

---

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