---
title: "Create Lead Analysis Task"
method: POST
path: "/v2.0/ai/lead-analysis"
tags: ["Intelligent Features"]
---

# Create Lead Analysis Task

`POST /v2.0/ai/lead-analysis`

Triggers an AI analysis task for the specified lead list, executed asynchronously.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- CreateLeadAnalysisRequest — Create LeadAnalysis task request
  - `leadIds` integer[], required — Lead IDs to analyze (required, cannot be empty)

## Response `200`

Task created successfully

- ApiCommonResponse — Common API response wrapper
  - `code` integer — Response code, 0 means success
  - `message` string — Response message
  - `data` object — Response data payload

## Other responses

- `400` — Invalid parameters (leadIds is empty)
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/versions/23e640467118/schema)