---
title: "Revise a completed API"
method: POST
path: "/dispatch/tasks/{task_id}/revise"
tags: ["Dispatch"]
---

# Revise a completed API

`POST /dispatch/tasks/{task_id}/revise`

Submit a revision request for a completed API. Describe what to change — the system will classify and queue the revision.

## Path parameters

- `task_id` string, required

## Request body

- RevisionRequest
  - `revision` string, required — Natural language description of what to change (e.g. 'add a search by category endpoint')
  - `contributes_to_marketplace` boolean — Whether this revision contributes back to the shared marketplace canonical. TRUE (default) = the revision propagates upstream and is free. FALSE = the revision desyncs this API from the canonical and is charged. The opt-out is permanent.

## Response `200`

Revision queued

- RevisionResponse
  - `task_id` string — ID of the revision task (may be the original if no agent run was needed)
  - `revision_type` string — Always 'revision' — a single agent handles all revision types

---

[API](https://skmtc.dev/parse/apis/parse-api.md) · [All operations](https://skmtc.dev/parse/apis/parse-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/parse/parse-api/revisions/ebc08aeee348/schema)