---
title: "Test AI reply label prediction"
method: POST
path: "/api/v2/lead-labels/ai-reply-label"
tags: ["LeadLabel"]
---

# Test AI reply label prediction

`POST /api/v2/lead-labels/ai-reply-label`

Returns the AI-predicted lead label for a reply text. This simulates how AI auto-tagging would label an incoming reply for testing custom labels and descriptions. Rate limit: 500 requests per 30 days per workspace. This rate limit applies only to this testing endpoint; live reply processing does not use this limiter.


Requires one of the following scopes: `lead-labels:read`, `lead-labels:all`, `all:read`, `all:all`

## Request body

- object
  - `reply_text` string, required — The reply text to classify.

## Response `200`

Default Response

- object
  - `result` string — The predicted lead label.
  - `custom_labels_considered` string[] — AI-enabled custom labels considered during classification.

## Other responses

- `401` — This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402` — This request cannot be fulfilled because the workspace does not have an active paid plan
- `404` — The requested resource was not found
- `429` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/instantly/apis/api-explorer.md) · [All operations](https://skmtc.net/instantly/apis/api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantly/api-explorer/versions/378d1e253fe7/schema)