---
title: "Trigger compounding job"
method: POST
path: "/v1/compounding/trigger"
tags: ["Compounding"]
---

# Trigger compounding job

`POST /v1/compounding/trigger`

## Request

- Base URL: `https://app.nex.ai/api/developers`
- URL: `https://app.nex.ai/api/developers/v1/compounding/trigger`
- Auth: API key in header `Authorization`

Triggers an on-demand compounding intelligence job for the workspace. Use after onboarding, file scanning, or bulk context ingestion to run intelligence pipelines immediately instead of waiting for the next scheduled cron cycle. Supported job types: consolidation (merge near-duplicate insights), pattern_detection (discover recurring patterns), playbook_synthesis (generate playbook rules from patterns), decay_sweep (reduce confidence on stale insights), and metrics (snapshot pipeline metrics). This endpoint is asynchronous and returns a job_run_id you can poll for status.

## Request body

- CompoundingTriggerJobRequest
  - `job_type` 'consolidation' | 'pattern_detection' | 'playbook_synthesis' | 'decay_sweep' | 'metrics', required: The type of compounding job to run
  - `dry_run` boolean: If true, preview impact without persisting changes

## Response `202`

Job accepted

- CompoundingTriggerJobResponse
  - `job_run_id` string, uuid: Unique identifier for this job execution
  - `job_type` 'consolidation' | 'pattern_detection' | 'playbook_synthesis' | 'decay_sweep' | 'metrics': The type of job that was executed
  - `workspace_id` integer: Workspace ID the job ran against
  - `dry_run` boolean: Whether the job ran in dry-run mode
  - `status` 'accepted': Current job status
  - `success` boolean: Whether the job was accepted successfully

## Other responses

- `400`: Bad request - Invalid job type or request body
- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal server error

## Changes

- **2026-03-26** `51003af13108`: 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `202`
- **2026-03-19** `d3d06f62488a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nex/apis/nex-developer-api/changes/v1/compounding/trigger/post.md)

---

[API](https://skmtc.dev/nex/apis/nex-developer-api.md) - [All operations](https://skmtc.dev/nex/apis/nex-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nex/apis/nex-developer-api/revisions/51003af13108?raw)