---
title: "Delete a flow definition"
method: DELETE
path: "/v1/multipass/flows/{flowId}"
tags: ["Multipass API"]
---

# Delete a flow definition

`DELETE /v1/multipass/flows/{flowId}`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/multipass/flows/{flowId}`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

Deletes the Multipass flow definition for the specified flow ID.
This operation cannot be undone.

## Path parameters

- `flowId` string, required

## Headers

- `X-Request-Id` string

## Response `200`

Flow definition deleted successfully

- FlowDefinitionApiResponseWriteFlowResult: Response object containing the operation, status, and flow ID after a save/update/delete operation
  - `operation` string, required
  - `status` string, required
  - `flowId` string, required

## Other responses

- `400`: Invalid request - check flow definition format or input data
- `401`: Unauthorized: Invalid or missing authentication token
- `403`: Forbidden: Insufficient permissions to access this flow
- `429`: Rate limit exceeded - too many requests
- `500`: Internal server error occurred

---

[API](https://skmtc.dev/precisely/apis/multipass-flow-management-api.md) · [All operations](https://skmtc.dev/precisely/apis/multipass-flow-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/multipass-flow-management-api/revisions/40c73192cfac?raw)