---
title: "Delete a workflow"
method: DELETE
path: "/v1/workflows/{id}"
---

# Delete a workflow

`DELETE /v1/workflows/{id}`

## Request

- Base URL: `https://postonce.to/api/public`
- URL: `https://postonce.to/api/public/v1/workflows/{id}`
- Auth: HTTP bearer

Deletes a workflow and any queued workflow items linked to it.

## Path parameters

- `id` string, required

## Response `200`

Workflow deleted successfully.

- DeleteResponse
  - `data` object
    - `deleted` boolean
    - `id` string
    - `provider_revocation_required` boolean, nullable: True when local PostOnce access is removed but the provider requires the user to revoke the remote signer separately.
    - `provider_revocation_url` string, nullable
    - `message` string, nullable

## Other responses

- `401`: Missing, invalid, revoked, or expired API key.

---

[API](https://skmtc.dev/postonce/apis/postonce-public-api.md) · [All operations](https://skmtc.dev/postonce/apis/postonce-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postonce/apis/postonce-public-api/revisions/ca9dca40a543?raw)