Skip to content

docs(cli): document CLI request attribution and agent origin - #1675

Open
mintlify[bot] wants to merge 2 commits into
mainfrom
autopilot/7d9c65fc
Open

mintlify[bot] wants to merge 2 commits into
mainfrom
autopilot/7d9c65fc

Conversation

@mintlify

@mintlify mintlify Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

Adds a "Request attribution" section to the CLI page. It explains how tools that wrap the CLI set FIRECRAWL_INTEGRATION so their requests are attributed to them instead of cli.

The same section now explains that CLI requests carry a cli@<version> origin. When a coding agent runs the CLI, the origin also names the agent (for example cli.codex@<version>). Set FIRECRAWL_CLI_DISABLE_AGENT_ORIGIN=1 to turn that off.

It also corrects the integration field description in the OpenAPI spec. A body value of cli no longer beats a valid X-Integration header, so "the body value takes precedence" was no longer fully true.

Based on feat(cli): let wrappers set the integration tag with FIRECRAWL_INTEGRATION, which sends the variable as the X-Integration header, fix(api): let a valid X-Integration header override a body integration of cli, which made the API honor it, and feat: stamp the coding agent in the request origin, which added the agent origin and its opt-out.

Needs a human look: the example value _my-tool follows the CLI README. I renamed the section from "Integration attribution" to "Request attribution" because it now covers the origin too. The page lists the seven detected agents by name. Drop the list if you'd rather not keep it in sync with the CLI.

@mintlify

mintlify Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated
firecrawl 🟢 Ready View Preview Oct 24, 2026, 3:52 AM

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

@mintlify mintlify Bot changed the title docs(cli): document FIRECRAWL_INTEGRATION for CLI wrappers docs(cli): document CLI request attribution and agent origin Oct 24, 2026

This branch was successfully deployed

1 active deployment
staging — dc2631a2 Deployed Oct 24, 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