---
title: "Run intent classification on conversations"
method: POST
path: "/dashboard/api/run-intent-classification"
tags: ["Classification"]
---

# Run intent classification on conversations

`POST /dashboard/api/run-intent-classification`

## Request

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

## Request body

- ClassificationRequest
  - `time_range` '1min' | '1h' | '1d' | '1w' | '1m' | 'all'
  - `limit` integer: Maximum conversations to classify in this request
  - `offset` integer
  - `force` boolean: Reclassify conversations already marked as analyzed
  - `run_id` string: Client-generated identifier used to cancel a multi-batch run

## Response `200`

Classification results

## Changes

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

[Operation history](https://skmtc.dev/agnost/apis/agnost-ai-api/changes/dashboard/api/run-intent-classification/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)