Skip to main content
GET
Theme-analysis pipeline status for the project

Headers

x-project-id
string
required

Project ID to specify the project context

Response

status
enum<string>
required

Coarse pipeline state. running = mentions are being extracted/clustered right now; pending = completed prompt runs are queued for the next poll (~1 min); failed = the last cluster pass failed or was killed (OOM/SIGKILL) and the project is not converging — see lastRun; idle = nothing outstanding, the project is up to date.

Available options:
idle,
pending,
running,
failed
Example:

"running"

enabled
boolean
required

Whether theme analysis is enabled for this project.

Example:

true

pendingJobs
number
required

Completed prompt runs not yet handed off to analysis (the poller will pick them up within ~1 min).

Example:

3

analyzedJobs
number
required

Completed prompt runs already handed off to analysis.

Example:

28

unclusteredMentions
number
required

Theme mentions extracted but not yet assigned a theme (clustering in flight).

Example:

14

themeMentions
number
required

Total theme mentions extracted for this project so far.

Example:

412

themes
number
required

Distinct themes the project mentions have resolved into.

Example:

23

lastActivityAt
string | null
required

ISO timestamp of the most recent extracted mention, or null if none yet.

Example:

"2026-06-25T10:12:04.000Z"

lastRun
object | null

The last stage-3 cluster pass, or null if the project has never been clustered.