> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Archive workflow

> <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.



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json delete /api/apps/{app_id}/workflows/{workflow_id}
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - ApiKeyAuth: []
paths:
  /api/apps/{app_id}/workflows/{workflow_id}:
    delete:
      summary: Archive workflow
      description: >-
        <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.
      operationId: archive_workflow_api_apps__app_id__workflows__workflow_id__delete
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app whose workflows you want to work with.
            title: App Id
          description: ID of the app whose workflows you want to work with.
          example: 6820f3a4e7b91d003c45a1f2
        - name: workflow_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the workflow, as returned in `id` by [List
              workflows](/api-reference/list-workflows).
            title: Workflow Id
          description: >-
            ID of the workflow, as returned in `id` by [List
            workflows](/api-reference/list-workflows).
          example: 68b1c0d4e7b91d003c45a1f2
      responses:
        '200':
          description: The workflow is archived.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArchiveResponse'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            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':
          description: There is no workflow with this ID on this app.
        '422':
          description: The workflow could not be archived. The body says why.
components:
  schemas:
    ArchiveResponse:
      properties:
        status:
          type: string
          title: Status
          description: Always `archived`.
          example: archived
        workflow_id:
          type: string
          title: Workflow Id
          description: ID of the workflow that was archived.
          example: 68b1c0d4e7b91d003c45a1f2
      type: object
      required:
        - status
        - workflow_id
      title: ArchiveResponse
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: Personal API key.

````