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

# Desvincular Página do Lead Ads

> Desvincula a Página. ⚠️ **Irreversível para os dados: todo lead captado por este vínculo é apagado** (os dados pessoais são excluídos; o lead deixa de ser listado e contado) **e as configurações de formulário do vínculo são excluídas.** `deletedLeads` diz quantos leads foram apagados. A Página pode ser vinculada de novo depois, mas os leads apagados não voltam — nem por ressincronização.

A Pilot Status também cancela a inscrição nos leads da Página na Meta, como melhor esforço: se a Meta falhar, o desvínculo acontece mesmo assim e nenhum lead novo é guardado. Tokens OAuth/MCP precisam de `integrations:manage` (ADMIN ou OWNER do workspace) em todos os verbos, leituras incluídas. Escopo: uma chave com escopo de número, ou uma credencial da conta inteira com `x-whatsapp-number-id`, atua só nos vínculos daquele número; uma credencial da conta inteira sem o header vê o workspace todo.



## OpenAPI

````yaml openapi.pt.json DELETE /v1/lead-pages/{pageLinkId}
openapi: 3.1.0
info:
  title: API Pilot Status
  version: 1.0.0
  license:
    name: Pilot Status Terms of Service
    url: https://pilotstatus.com.br/terms
  description: >-
    API REST pública do Pilot Status. Autentique com o header `x-api-key:
    ps_...` (ou `x-api-key-id`). Base URL: https://pilotstatus.com.br
servers:
  - url: https://pilotstatus.com.br
security:
  - apiKey: []
  - apiKeyId: []
paths:
  /v1/lead-pages/{pageLinkId}:
    delete:
      tags:
        - Ads
      summary: Desvincular Página do Lead Ads
      description: >-
        Desvincula a Página. ⚠️ **Irreversível para os dados: todo lead captado
        por este vínculo é apagado** (os dados pessoais são excluídos; o lead
        deixa de ser listado e contado) **e as configurações de formulário do
        vínculo são excluídas.** `deletedLeads` diz quantos leads foram
        apagados. A Página pode ser vinculada de novo depois, mas os leads
        apagados não voltam — nem por ressincronização.


        A Pilot Status também cancela a inscrição nos leads da Página na Meta,
        como melhor esforço: se a Meta falhar, o desvínculo acontece mesmo assim
        e nenhum lead novo é guardado. Tokens OAuth/MCP precisam de
        `integrations:manage` (ADMIN ou OWNER do workspace) em todos os verbos,
        leituras incluídas. Escopo: uma chave com escopo de número, ou uma
        credencial da conta inteira com `x-whatsapp-number-id`, atua só nos
        vínculos daquele número; uma credencial da conta inteira sem o header vê
        o workspace todo.
      operationId: delete_lead-page
      parameters:
        - name: pageLinkId
          in: path
          required: true
          description: >-
            O id do vínculo (`linked[].pageLinkId` de `GET /v1/lead-pages`), não
            o id da Página do Facebook.
          schema:
            type: string
          example: cmgpl0001ab12cd34ef56
        - name: x-whatsapp-number-id
          in: header
          required: false
          description: >-
            Restringe uma credencial da conta inteira a um número (o id dele ou
            o id da instância, de `GET /v1/numbers`). Sem ele, uma credencial da
            conta inteira vê o workspace todo; uma chave com escopo de número vê
            sempre só o próprio número.
          schema:
            type: string
          example: num_01HZX...
      responses:
        '200':
          description: Página desvinculada; os leads dela apagados
          content:
            application/json:
              example:
                unlinked: true
                pageLinkId: cmgpl0001ab12cd34ef56
                deletedLeads: 42
        '400':
          description: >-
            `NUMBER_REQUIRED` (concessão OAuth por número sem
            `x-whatsapp-number-id`) ou `NUMBER_NOT_FOUND` (chave com escopo de
            número cujo número foi apagado)
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
              example:
                error: >-
                  Provide x-whatsapp-number-id for a per-number connection |
                  Envie o header x-whatsapp-number-id para uma conexão por
                  número
                code: NUMBER_REQUIRED
        '401':
          description: Header `x-api-key` / `x-api-key-id` ausente ou inválido
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
              example:
                error: Unauthorized
        '403':
          description: >-
            O número está fora do escopo da credencial (`NUMBER_NOT_IN_GRANT`),
            ou token OAuth cujo papel no workspace não tem `integrations:manage`
            (`PERMISSION_DENIED`)
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
              example:
                error: >-
                  This credential is not granted access to that WhatsApp number
                  | Esta credencial não tem acesso a esse número de WhatsApp
                code: NUMBER_NOT_IN_GRANT
        '404':
          description: >-
            Vínculo de página não encontrado: nunca vinculado, já desvinculado
            ou de outro workspace
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
              example:
                error: Page link not found | Vínculo de página não encontrado
                code: NOT_FOUND
        '500':
          description: Erro interno
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
              example:
                error: Internal server error | Erro interno do servidor
                code: INTERNAL_ERROR
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Sua chave de API ps_
    apiKeyId:
      type: apiKey
      in: header
      name: x-api-key-id
      description: Id da chave de API (alternativa ao x-api-key)

````

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