---
title: "Trash Flow instance"
method: POST
path: "/experimental/flow/instances/{instance_id}/trash"
tags: ["Instances"]
---

# Trash Flow instance

`POST /experimental/flow/instances/{instance_id}/trash`

## Request

- Base URL: `https://scrive.com`
- URL: `https://scrive.com/experimental/flow/instances/{instance_id}/trash`
- Auth: one of:
  - HTTP oauth1
  - OAuth 2
    - Authorization code: `/oauth2/auth`
    - Token URL: `/oauth2/token` scopes: `full`
  - API key in cookie `sessionId` and API key in header `X-Scrive-XToken`
- TypeScript: <https://skmtc.dev/scrive/apis/scrive-flow-api/docs/experimental/flow/instances/:instance_id/trash/post.ts> (a function with typed inputs; its response is checked against the schema)

Trashes a Flow instance. Participants lose access to a trashed instance 30 days after it has finished. Only instances that are not in-progress can be trashed.

## Path parameters

- `instance_id` string, uuid, required: Unique identifier of the requested instance.

## Response `204`

## Other responses

- `404`: `instance_id` not found

---

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