---
title: "Finish Task"
method: POST
path: "/v2.0/tasks/{taskId}/finish"
tags: ["Tasks & Appointments V2"]
---

# Finish Task

`POST /v2.0/tasks/{taskId}/finish`

Marks a task or appointment as completed. Caller must have manage permission on the entry's lead. Smart-plan tasks cannot be finished through this endpoint (TASK_IS_SMARTPLAN).

## Path parameters

- `taskId` integer, required

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Response `200`

Entry marked as completed.

- MessageResponse — Generic message response
  - `message` string — Result message

## Other responses

- `400` — Finish attempted on a smart-plan task (TASK_IS_SMARTPLAN).
- `401` — Missing or invalid authentication token.
- `404` — Task or appointment does not exist (TASK_NOT_EXIST) or caller has no access to the lead (20006 LEAD_NOT_EXIST).
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)