Skip to content

docs: document keyless feedback in the v2 API reference - #1414

Open
Max17190 wants to merge 24 commits into
mainfrom
max/document-keyless-feedback
Open

Max17190 wants to merge 24 commits into
mainfrom
max/document-keyless-feedback

Conversation

@Max17190

@Max17190 Max17190 commented Sep 13, 2026 •

Copy link
Copy Markdown
Member

Why

Document optional, evidence-based feedback for keyless Search, Scrape, and Parse using the API contract in #4616.

Summary

  • Describe the API invitation, job references, 24-hour window, retries, failure observations, and Parse retention.
  • Document endpoint-specific observations, reason codes, evidence requirements, and request limits in OpenAPI.
  • Preserve authenticated feedback and the separate Search Feedback endpoint.

Publish before enabling the API invitations publicly; they link to this page. MCP and CLI support can follow once the API and docs are available.

Test Plan

  • Valid OpenAPI JSON and 861 schema parity cases against the API implementation.
  • Extraction-hostile markdown and locale fixture checks pass.
  • Published preview verified with a fresh Firecrawl scrape: invitation wording, visible keyless required fields, metadata locations, expiry, retry timing, and size limits.
  • The repository-wide locale literal check has the same 14 translated-page failures on main. Mintlify validation has the same 12 missing-snippet warnings on main. None of those pages is changed here.
  • Requested Cubic review; no Cubic check or review has been posted for this PR.

@mintlify

mintlify Bot commented Sep 13, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
firecrawl 🟢 Ready View Preview Oct 1, 2026, 4:51 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@Max17190 Max17190 changed the title docs(api): document keyless feedback in the v2 reference docs: document keyless feedback in the v2 API reference Sep 14, 2026
Remove the daily submission allowance and the exact attempt rate from the
feedback reference and OpenAPI description. Each job accepts one submission,
retries return the original record, and attempts are rate limited.
The keyless feedback API caps each knownSources URL at 2048 characters,
matching the comparison reference.
Declare minLength 1 for origin, matching the API validation.
@Max17190
Max17190 marked this pull request as ready for review October 1, 2026 16:08
@Max17190

Max17190 commented Oct 1, 2026

Copy link
Copy Markdown
Member Author

@cubic-dev-ai review this PR. Review the full diff using firecrawl/firecrawl#4616 as the API contract, including optional invitation language, endpoint-specific evidence, the 24-hour window, and preservation of authenticated feedback.

This branch was successfully deployed

1 active deployment
staging — 3d302198 Deployed Oct 1, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant