Skip to content

Add OAuth for apps guide for the REST API - #1712

Open
erikengervall wants to merge 2 commits into
mainfrom
capy/add-oauth-for-apps
Open

erikengervall wants to merge 2 commits into
mainfrom
capy/add-oauth-for-apps

Conversation

@erikengervall

@erikengervall erikengervall commented Oct 22, 2026 •

Copy link
Copy Markdown
Contributor

Adds an English guide, "OAuth for apps", under API Reference. It covers how a third-party app lets a user sign in with Firecrawl and call the REST API on that user's account without the user pasting an API key.

The page covers discovery metadata, client registration (Dynamic Client Registration or a Client ID Metadata Document), the authorize request with PKCE, code exchange, calling the API with an fco_ bearer token, refresh token rotation, revocation, and the error codes from both the authorization server and the REST API. It states that firecrawl:global is full access to the chosen team, and points users to Settings to see and revoke connections.

Localized pages are left to the translation pipeline.

Merge after firecrawl/firecrawl#5154 and https://github.com/firecrawl/firecrawl-web/pull/4135 are deployed, because the page describes revoking REST connections in Settings.

@mintlify

mintlify Bot commented Oct 22, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
firecrawl 🟢 Ready View Preview Oct 24, 2026, 4:41 AM

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

@capy-ai capy-ai Bot changed the title Add OAuth for apps page Add OAuth for apps guide for the REST API Oct 24, 2026
Only a refresh token revokes the whole connection; an access token sent to
/revoke ends that access token alone. A refresh token used twice revokes
the connection outright, including the tokens the first refresh returned.
Both match the grant RPCs that back REST connections.

Co-Authored-By: Claude <noreply@anthropic.com>

This branch was successfully deployed

1 active deployment
staging — e199eaad 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