---
title: "Finish a playbook"
method: PUT
path: "/plugins/playbooks/api/v0/runs/{id}/finish"
tags: ["PlaybookRuns"]
---

# Finish a playbook

`PUT /plugins/playbooks/api/v0/runs/{id}/finish`

## Request

- Base URL: `http://localhost:8065/plugins/playbooks/api/v0`
- URL: `http://localhost:8065/plugins/playbooks/api/v0/plugins/playbooks/api/v0/runs/{id}/finish`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/mattermost/apis/playbooks-api/docs/plugins/playbooks/api/v0/runs/:id/finish/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required

## Response `200`

Playbook run finished.

## Other responses

- `500`: There was an internal error in the server.

## Changes

- **2023-06-19** `148981c0ea86`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mattermost/apis/playbooks-api/changes/plugins/playbooks/api/v0/runs/:id/finish/put.md)

---

[API](https://skmtc.dev/mattermost/apis/playbooks-api.md) - [All operations](https://skmtc.dev/mattermost/apis/playbooks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mattermost/apis/playbooks-api/revisions/2acd884508c4?raw)