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

# Archive a pipeline

> Archives the pipeline. If the pipeline is deployed, it is stopped and torn down first.



## OpenAPI

````yaml /cdc-openapi.yaml delete /pipelines/{id}
openapi: 3.0.3
info:
  title: Integrate.io ELT & CDC REST API
  description: >
    The Integrate.io ELT & CDC REST API lets you list, create, update, start,
    stop, and archive

    ELT & CDC pipelines from outside the dashboard. Pipelines are described by a
    declarative

    definition document (YAML or JSON), so the same configuration can be
    version-controlled,

    reviewed, and reapplied across environments.


    ## Authentication

    Requests are authenticated with a bearer API key:

    ```

    Authorization: Bearer fdk_<your-key>

    ```

    Every Integrate.io API key is prefixed with `fdk_`. The full key value is
    shown only once at

    creation time. Store it in a secret manager. If a key is lost or leaked,
    revoke it and mint a

    new one. Keys are minted from the dashboard under **Settings > API Keys** by
    account admins.


    ## Pipeline definition document

    Create, replace, and validate requests take a declarative definition
    document. For the full

    schema, supported transformation types, and examples, see the

    [REST API overview](/cdc/api#pipeline-definition-document).
  version: '1.0'
  contact:
    name: Integrate.io Support
    url: https://www.integrate.io
servers:
  - url: https://{host}/api/public/v1
    variables:
      host:
        default: console.flydata.app
        description: >-
          API host. Confirm with the Integrate.io team; the API may instead be
          served from a dedicated host such as api.flydata.app. The public API
          lives under the /api/public/v1 base path.
security:
  - bearerAuth: []
tags:
  - name: Pipelines
    description: Manage ELT & CDC pipelines and their definitions.
paths:
  /pipelines/{id}:
    parameters:
      - $ref: '#/components/parameters/PipelineId'
    delete:
      tags:
        - Pipelines
      summary: Archive a pipeline
      description: >-
        Archives the pipeline. If the pipeline is deployed, it is stopped and
        torn down first.
      operationId: archivePipeline
      responses:
        '200':
          description: The pipeline was archived.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    PipelineId:
      name: id
      in: path
      required: true
      schema:
        type: integer
  responses:
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: >-
        The pipeline does not exist, or it belongs to another account. Unknown
        IDs and other-account IDs both return 404 to prevent enumeration.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
      additionalProperties: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer API key, prefixed with fdk_.

````