> ## 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. # Mover Página do Lead Ads > Move um vínculo de Página para outro número de WhatsApp do workspace. Corpo: `{ "whatsappNumberId": "" }` e nada mais. Só os leads **novos** acompanham; os já captados ficam no número em que chegaram. Quando o número novo envia outro tipo de mensagem (template oficial vs. texto livre não oficial) ou fica em outra WABA, todo envio automático dos formulários do vínculo é **desligado** e a resposta traz `autoSendDisabled: true` — revise os formulários com `PUT /v1/lead-pages/{pageLinkId}/forms/{formId}` antes de religar. O número atual e o de destino precisam estar no escopo da credencial (`403 NUMBER_NOT_IN_GRANT`). 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 PATCH /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}: patch: tags: - Ads summary: Mover Página do Lead Ads para outro número description: >- Move um vínculo de Página para outro número de WhatsApp do workspace. Corpo: `{ "whatsappNumberId": "" }` e nada mais. Só os leads **novos** acompanham; os já captados ficam no número em que chegaram. Quando o número novo envia outro tipo de mensagem (template oficial vs. texto livre não oficial) ou fica em outra WABA, todo envio automático dos formulários do vínculo é **desligado** e a resposta traz `autoSendDisabled: true` — revise os formulários com `PUT /v1/lead-pages/{pageLinkId}/forms/{formId}` antes de religar. O número atual e o de destino precisam estar no escopo da credencial (`403 NUMBER_NOT_IN_GRANT`). 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: patch_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... requestBody: required: true content: application/json: schema: type: object properties: whatsappNumberId: type: string description: Número que passa a receber os leads novos da Página. example: num_01HZY... required: - whatsappNumberId additionalProperties: false responses: '200': description: Vínculo de página movido content: application/json: example: link: pageLinkId: cmgpl0001ab12cd34ef56 pageId: '102345678901234' pageName: MM Design whatsappNumberId: num_01HZY... subscribedAt: '2026-10-06T10:15:00.000Z' subscriptionError: null linkedAt: '2026-10-06T10:14:58.000Z' leadsCount: 42 autoSendDisabled: true '400': description: >- `INVALID_BODY`, `UNKNOWN_FIELDS` (com `unknownFields`), `VALIDATION_FAILED`, ou `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: >- Unknown field(s): token. This endpoint accepts only: whatsappNumberId. | Campo(s) desconhecido(s): token. Este endpoint aceita apenas: whatsappNumberId. code: UNKNOWN_FIELDS unknownFields: - token '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 (`NOT_FOUND`), ou o número de destino não é deste workspace (`NUMBER_NOT_FOUND`) 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.