---
title: "Trigger AI analysis"
method: POST
path: "/v1/communities/{communityId}/projects/{projectId}/analysis"
tags: ["Analysis"]
---

# Trigger AI analysis

`POST /v1/communities/{communityId}/projects/{projectId}/analysis`

## Request

- Base URL: `https://api.subo.ai`
- URL: `https://api.subo.ai/v1/communities/{communityId}/projects/{projectId}/analysis`
- Auth: API key in header `X-API-Key`

Trigger AI summarization for open_text blocks. Consumes bot credits. Returns immediately; poll GET /analysis for results. Returns 409 if no open_text block may be summarized (text analysis off for the community, project or blocks), 402 if credit balance is zero.

## Path parameters

- `communityId` string, required
- `projectId` string, required

## Request body

- object
  - `force` boolean: Regenerate all summaries even if they already exist

## Response `200`

Processing started

- object
  - `data` object
    - `project_id` string
    - `status` 'processing' | 'no_eligible_blocks': `processing`: AI jobs queued; `no_eligible_blocks`: no open_text blocks found

## Other responses

- `401`: Invalid or missing API key
- `402`: Bot credit balance is zero
- `403`: Forbidden
- `404`: Resource not found
- `409`: Text analysis is off for every open_text block of this project; no answers are sent to a model
- `429`: Rate limit exceeded — wait `retry_after` seconds before retrying. The same value appears in the `Retry-After` header.

---

[API](https://skmtc.dev/subo/apis/subo-api.md) · [All operations](https://skmtc.dev/subo/apis/subo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/subo/apis/subo-api/revisions/12eab2ae4505?raw)