> ## 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. # Ressincronizar Página do Lead Ads > Busca de novo os leads dos últimos **90 dias** da Página (leads já guardados não se duplicam: a busca é idempotente pelo `leadgenId` da Meta) e, quando o vínculo não está inscrito (`subscribedAt: null`), tenta a inscrição de novo. Não recebe corpo. Responde `202`: a busca roda em segundo plano e pode levar minutos. **Uma ressincronização por vínculo a cada 10 minutos:** dentro dessa janela a resposta é `429 RESYNC_COOLDOWN` com `retryAfterSeconds`. Se a espera não puder ser conferida, a resposta é `503 RESYNC_UNAVAILABLE`, nunca uma ressincronização sem limite. A posse é conferida de novo: uma Página que deixou de ser elegível é marcada no vínculo (`subscriptionError`) e responde `409 PAGE_NOT_ELIGIBLE` com `reason`. `subscribedAt` e `subscriptionError` só aparecem na resposta quando esta chamada tentou a inscrição de novo. 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 POST /v1/lead-pages/{pageLinkId}/resync 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}/resync: post: tags: - Ads summary: Ressincronizar Página do Lead Ads description: >- Busca de novo os leads dos últimos **90 dias** da Página (leads já guardados não se duplicam: a busca é idempotente pelo `leadgenId` da Meta) e, quando o vínculo não está inscrito (`subscribedAt: null`), tenta a inscrição de novo. Não recebe corpo. Responde `202`: a busca roda em segundo plano e pode levar minutos. **Uma ressincronização por vínculo a cada 10 minutos:** dentro dessa janela a resposta é `429 RESYNC_COOLDOWN` com `retryAfterSeconds`. Se a espera não puder ser conferida, a resposta é `503 RESYNC_UNAVAILABLE`, nunca uma ressincronização sem limite. A posse é conferida de novo: uma Página que deixou de ser elegível é marcada no vínculo (`subscriptionError`) e responde `409 PAGE_NOT_ELIGIBLE` com `reason`. `subscribedAt` e `subscriptionError` só aparecem na resposta quando esta chamada tentou a inscrição de novo. 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: post_lead-page-resync 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: '202': description: Ressincronização iniciada content: application/json: example: started: true pageLinkId: cmgpl0001ab12cd34ef56 subscribedAt: '2026-10-21T10:02:44.000Z' subscriptionError: null '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 '409': description: >- A Página deixou de ser elegível para este workspace (`PAGE_NOT_ELIGIBLE`, com `reason`) content: application/json: schema: type: object properties: error: type: string code: type: string example: error: >- This Page is not available to be linked to this workspace. | Esta página não está disponível para vínculo neste workspace. code: PAGE_NOT_ELIGIBLE reason: PAGE_NOT_SHARED '429': description: >- Uma ressincronização deste vínculo rodou há menos de 10 minutos. Aguarde `retryAfterSeconds`. content: application/json: schema: type: object properties: error: type: string code: type: string retryAfterSeconds: type: integer example: error: >- A sync ran a moment ago. Wait before trying again. | Sincronização feita há pouco. Aguarde para tentar de novo. code: RESYNC_COOLDOWN retryAfterSeconds: 412 '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 '502': description: Não foi possível consultar a Meta. Tente de novo. content: application/json: schema: type: object properties: error: type: string code: type: string example: error: >- Could not reach Meta right now. Try again. | Não foi possível consultar a Meta agora. Tente novamente. code: LEADS_LOOKUP_UNAVAILABLE '503': description: >- A captura de leads não está configurada (`LEADS_NOT_CONFIGURED`), ou não foi possível conferir a espera (`RESYNC_UNAVAILABLE`) content: application/json: schema: type: object properties: error: type: string code: type: string example: error: >- Could not sync right now. Try again in a moment. | Não foi possível sincronizar agora. Tente novamente em instantes. code: RESYNC_UNAVAILABLE 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.