---
title: "Changes to Mark task as completed or failed (runner endpoint)"
method: POST
path: "/api/tasks/{id}/finish"
---

# Changes to Mark task as completed or failed (runner endpoint)

`POST /api/tasks/{id}/finish`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 104 revisions.

- **2026-09-03** `0f5503f5cd28` — 4 warning
- **2026-09-02** `09d5eb030093` — 4 info
- **2026-08-31** `6f2d2fbe2599` — 2 warning
- **2026-08-07** `06cac6a7c5bc` — 5 info
- **2026-08-03** `92a1dcbd2fc7` — 2 info

## Changes

- **2026-09-03** `0f5503f5cd28` — 4 warning
  - added the new `acp` enum value to the `task/provider` response property for the response status `200`
  - added the new `acp` enum value to the `task/provider` response property for the response status `409`
  - added the new `acp` enum value to the `task/routingAffinity/harnessProvider` response property for the response status `200`
  - added the new `acp` enum value to the `task/routingAffinity/harnessProvider` response property for the response status `409`
- **2026-09-02** `09d5eb030093` — 4 info
  - added the optional property `task/routingAffinity/leadOnly` to the response with the `200` status
  - added the optional property `task/routingAffinity/leadOnly` to the response with the `409` status
  - added the optional property `task/routingAffinityInvalid` to the response with the `200` status
  - added the optional property `task/routingAffinityInvalid` to the response with the `409` status
- **2026-08-31** `6f2d2fbe2599` — 2 warning
  - added the new `draft` enum value to the `task/status` response property for the response status `200`
  - added the new `draft` enum value to the `task/status` response property for the response status `409`
- **2026-08-07** `06cac6a7c5bc` — 5 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `403`
  - added the media type `application/json` for the response with the status `404`
  - added the media type `application/json` for the response with the status `409`
- **2026-08-03** `92a1dcbd2fc7` — 2 info
  - added the new optional request property `force`
  - added the non-success response with the status `409`

---

[Operation](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/docs/api/tasks/:id/finish/post.md) · [API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [Page](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/tasks/:id/finish/post)