---
title: "Archive workflow"
method: DELETE
path: "/api/apps/{app_id}/workflows/{workflow_id}"
---

# Archive workflow

`DELETE /api/apps/{app_id}/workflows/{workflow_id}`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Archives a workflow so it stops running.

Archiving cancels its schedule, stops it responding to its trigger, and removes its file from the app's code. The workflow and its run history are kept, and [Restore workflow](/api-reference/restore-workflow) brings it back.

Archiving frees the workflow's name, so another workflow can take it while this one is archived. That is what makes a later restore fail with a 409.

This endpoint is limited to 20 requests per minute.

## Path parameters

- `app_id` string, required — ID of the app whose workflows you want to work with.
- `workflow_id` string, required — ID of the workflow, as returned in `id` by [List workflows](/api-reference/list-workflows).

## Response `200`

The workflow is archived.

- ArchiveResponse
  - `status` string, required — Always `archived`.
  - `workflow_id` string, required — ID of the workflow that was archived.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have access to this app, the app does not exist, the app still runs the older automations engine instead of workflows, or you used a workspace API key. A missing app and an app you cannot reach are deliberately the same answer.
- `404` — There is no workflow with this ID on this app.
- `422` — The workflow could not be archived. The body says why.

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idealspot/base44-app-management-api/revisions/31ef75eb64ab/schema)