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

# Remove a destination and stop its syncs

> Removes a destination. Ziplined clears its connection settings and stops every sync that sends to it. It also cancels anything still queued for it. What it already delivered stays in the history. The first call removes nothing. It returns a summary that names the syncs that would stop, and a confirm_id. It removes the destination when you call again with the same arguments plus confirm_id.

Use when: The user no longer wants anything sent to this webhook, email list or Slack channel.

Do not use for: Pausing one sync while the destination stays (use save_sync with enabled false instead).

Example: {"destination":"#leads"}



## OpenAPI

````yaml /openapi.json delete /v1/integrations/{id}
openapi: 3.1.0
info:
  title: Ziplined API
  version: 1.0.0
  description: >-
    LinkedIn engagement data about people, companies and posts. The workspace
    comes from the credential; lists page with `limit` and `cursor`.
servers:
  - url: https://api.ziplined.io
    description: Production
security: []
tags:
  - name: People
    description: The people in your workspace, and what you sent them.
  - name: Companies
    description: The companies those people work at.
  - name: Posts
    description: Your own posts and their numbers.
  - name: Engagements
    description: One act by one person on one post.
  - name: Insights
    description: Period against period, and the series behind it.
  - name: Views
    description: The saved views of the app, and who is in a hand-picked one.
  - name: Audiences
    description: The scored target groups, and their membership.
  - name: ICP
    description: 'Who you sell to: the rules every person is scored against.'
  - name: Sources
    description: What your radar collects from.
  - name: Account
    description: Who is asking, what is set up, and what is next.
  - name: Credits
    description: What is left to spend on sources, and when it resets.
  - name: Integrations
    description: 'Where syncs send people: webhook, email, Slack and app destinations.'
paths:
  /v1/integrations/{id}:
    delete:
      tags:
        - Integrations
      summary: Remove a destination and stop its syncs
      description: >-
        Removes a destination. Ziplined clears its connection settings and stops
        every sync that sends to it. It also cancels anything still queued for
        it. What it already delivered stays in the history. The first call
        removes nothing. It returns a summary that names the syncs that would
        stop, and a confirm_id. It removes the destination when you call again
        with the same arguments plus confirm_id.


        Use when: The user no longer wants anything sent to this webhook, email
        list or Slack channel.


        Do not use for: Pausing one sync while the destination stays (use
        save_sync with enabled false instead).


        Example: {"destination":"#leads"}
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: The destination, by name or id from list_destinations.
          required: true
          description: The destination, by name or id from list_destinations.
          name: id
          in: path
        - schema:
            type: string
            description: >-
              The confirm_id of a needs_confirmation answer: commits what that
              answer summarised.
          required: false
          description: >-
            The confirm_id of a needs_confirmation answer: commits what that
            answer summarised.
          name: confirm_id
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 255
            description: >-
              Any client-chosen key, a uuid for example. Sending the same
              request twice with the same key has one effect and returns the
              same response twice; the same key with a different body returns
              409.
            example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d
          required: false
          description: >-
            Any client-chosen key, a uuid for example. Sending the same request
            twice with the same key has one effect and returns the same response
            twice; the same key with a different body returns 409.
          name: idempotency-key
          in: header
      responses:
        '200':
          description: >-
            The result, or without confirm_id first a needs_confirmation answer:
            nothing happened yet.
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      deleted:
                        type: boolean
                        description: 'True: Ziplined removed the destination.'
                      already_deleted:
                        type: boolean
                        description: True when somebody removed it before this call.
                      destination_id:
                        type: string
                      syncs_stopped:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            view_id:
                              type: string
                              nullable: true
                              description: Null for the sync of all leads.
                            view_name:
                              type: string
                              nullable: true
                          required:
                            - id
                            - view_id
                            - view_name
                        description: >-
                          The syncs that sent to this destination and stop with
                          it.
                      app_url:
                        type: string
                    required:
                      - deleted
                      - already_deleted
                      - destination_id
                      - syncs_stopped
                      - app_url
                  - $ref: '#/components/schemas/Confirmation'
        '400':
          description: A filter value is invalid, or this resource has no such filter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid bearer token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Not included in this plan, or a usage cap was exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Wrong workspace, or the credential lacks the required scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No such record, or it does not belong to this workspace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: >-
            The same `Idempotency-Key` was used for a different request, or that
            request is still in flight.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    Confirmation:
      type: object
      properties:
        needs_confirmation:
          type: boolean
          enum:
            - true
        message:
          type: string
          description: >-
            Nothing changed yet. Ask the user, then send the same request with
            confirm_id.
        confirm_id:
          type: string
          description: Send it back with the same request to commit. Valid for 10 minutes.
        summary:
          nullable: true
          description: What the commit will do, to show the user before confirming.
        cost:
          type: object
          properties:
            estimate:
              type: number
            ceiling:
              type: number
          required:
            - estimate
            - ceiling
          description: >-
            Credits: estimate is what the commit is expected to spend. ceiling
            is 0: no ceiling is stored, and later spend stops when the balance
            reaches 0.
        expires_at:
          type: string
          description: ISO instant. After it, confirm_id is refused as confirm_stale.
      required:
        - needs_confirmation
        - message
        - confirm_id
        - cost
        - expires_at
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.