Skip to content

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

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

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

Conversation

@Max17190

@Max17190 Max17190 commented Sep 13, 2026 •

Copy link
Copy Markdown
Contributor

Why

Document keyless Search, Scrape, and Parse feedback alongside the authenticated API contract.

Summary

  • Add request schemas and examples, reason codes, and evidence rules for keyless feedback.
  • Explain the feedback window, one submission per job, retries, failure observations, and Parse feedback retention in caller terms.
  • Keep the 8 KiB size limit in the request schema while keeping the page concise.
  • Preserve authenticated feedback, the separate Search Feedback endpoint, and translated files.

Publish before enabling API #4616; keyless invitations link to this page.

Test Plan

  • Validated the OpenAPI JSON with jq empty api-reference/v2-openapi.json.
  • Passed sh scripts/check-extraction-hostile-markdown.sh.
  • Ran mint validate; it remains blocked by existing missing-snippet warnings outside the changed pages.

@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 Sep 23, 2026, 11:06 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.

This branch was successfully deployed

1 active deployment
staging — a70335cc Deployed Sep 23, 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