---
title: "Launch the agent pipeline"
method: POST
path: "/projects/{project_id}/agents/launch/"
tags: ["Agents"]
---

# Launch the agent pipeline

`POST /projects/{project_id}/agents/launch/`

## Request

- Base URL: `https://api.parsewise.ai/api/v1`
- URL: `https://api.parsewise.ai/api/v1/projects/{project_id}/agents/launch/`
- Auth: API key in header `X-API-Key`

Start the agent extraction pipeline for the project. Only agents
with outstanding work are processed; agents that are already up to
date are skipped. Returns `202 Accepted` immediately; track progress
with `GET /projects/{project_id}/agents/status/`.

## Path parameters

- `project_id` string, uuid, required

## Response `202`

Extraction has been started. The response body is an empty JSON object; poll `GET /projects/{project_id}/agents/status/` for progress.

## Other responses

- `400`: The launch was rejected because a document failed processing. Remove the failed file or upload a corrected replacement, then try again.

---

[API](https://skmtc.dev/parsewise/apis/parsewise-api.md) - [All operations](https://skmtc.dev/parsewise/apis/parsewise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/parsewise/apis/parsewise-api/revisions/5db46512debf?raw)