Recurso não encontrado

documento_nao_encontrado

Nenhum recurso com esse identificador nesta organização.

O que aconteceu

O id não existe, ou existe em outra organização. A API responde 404 nos dois casos, de propósito: dizer "existe, mas não é seu" já revelaria a existência de um recurso alheio. ⚠️ Este código não é só de documento. Ele responde por documento, webhook, signatário e pelas rotas de sandbox — leia o campo instance da resposta para saber qual rota o devolveu.

Por que costuma acontecer

• O id veio de outro ambiente (sandbox × produção) — é a causa mais comum.
• **Você chamou uma rota /api/v1/teste/* com chave de PRODUÇÃO.** Elas respondem 404, não 403: confirmar a existência dessas rotas já seria informação demais. Neste caso o documento está certo — a chave é que é do ambiente errado.
• O recurso foi criado por outra conta.
• Você está usando o hash_original onde a rota espera o id.
• No caso de /arquivo-original: o arquivo já foi purgado pelo fim da retenção.

Como resolver

• Confira o prefixo da chave primeiro: use_sk_live_ é produção, use_sk_test_ é sandbox. Os ids de um ambiente nunca existem no outro.
• Documento: liste com GET /api/v1/documentos?referencia_externa=… para achar o id certo a partir da sua própria referência.
• Webhook: liste com GET /api/v1/webhooks.
• Signatário: o id dele vem dentro do documento — GET /api/v1/documentos/{id}.
• Guarde o id devolvido na criação junto do seu registro: é ele que identifica o recurso em todas as rotas.

Relacionados

• chave_de_ambiente_errado — Chave de ambiente errado

Ramifique sempre pelo campo codigo da resposta — ele é estável. Nunca pelo texto da mensagem nem por esta URL.