docs: correct Stacks API archive prerequisites, add troubleshooting, remove Metadata API archive page

[rafa-stacks]

What & why

Corrects several inaccuracies on the Stacks Blockchain API archive page, adds guidance for post-restore behavior and troubleshooting, and removes the now-obsolete Token Metadata API archive page.

Changes

resources/archive/stacks-api.mdx

• Block height prerequisite — the API does not require the node to be at the same block height. Reworded to clarify the API's block height can be greater than or equal to the Stacks node's.
• Archive date compatibility — the Stacks node archive need not match the API archive date. Changed to: the Stacks blockchain archive was created on the same date as, or an earlier date than, the API archive.
• Postgres restore time — "may take up to an hour" → "may take several hours" depending on database specs and tuning.
• New "Receiving new blocks" section — explains that once restored and connected to the node, the API begins receiving and accepting new block events, and how to confirm via logs and /extended/v1/status.
• New "Troubleshooting" section — covers the case where the API stops advancing, with the DB does not contain a parent block at height ... error: its cause (API DB behind the node) and resolution (re-restore so API height ≥ node height, then restart).

Remove Token Metadata API archive page

• Deleted resources/archive/token-metadata-api.mdx (EN + ES) and removed it from both archive meta.json nav files.

Verification

• stacks-api.mdx compiles and renders cleanly (200, no MDX errors); new sections present.
• No dangling references to the removed Metadata API archive page remain; archive nav resolves.

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
hiro-systems-docs	Ready	Preview	Jul 24, 2026 9:36pm