# Agent Auth (WorkOS ID-JAG) (/ai-onboarding/agent-auth)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 975 · updated: 2026-07-30 -->
Related: [Skills + CLI](/sdks/cli.md), [Advanced Scraping Guide](/advanced-scraping-guide.md)

If you need a browser sign-in or dashboard API key, use human-in-the-loop onboarding via [`SKILL.md`](https://www.firecrawl.dev/agent-onboarding/SKILL.md). See [Get credentials](/ai-onboarding#get-credentials).

This page summarizes WorkOS ID-JAG registration for Firecrawl. Use [`auth.md`](https://www.firecrawl.dev/auth.md) for the full registration instructions, claim requirements, and error handling.

<Card title="Back to Get credentials" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M15 6C15 6 9.00001 10.4189 9 12C8.99999 13.5812 15 18 15 18&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/ai-onboarding#get-credentials">
  Compare the dashboard, CLI, and WorkOS ID-JAG options on the Build with AI onboarding page.
</Card>

## Need a human sign-in or dashboard key? [#need-a-human-sign-in-or-dashboard-key]

Use this if you cannot mint a WorkOS ID-JAG for Firecrawl, or you are not sure.

<Card title="Use SKILL.md onboarding" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M17 8.5C17 5.73858 14.7614 3.5 12 3.5C9.23858 3.5 7 5.73858 7 8.5C7 11.2614 9.23858 13.5 12 13.5C14.7614 13.5 17 11.2614 17 8.5Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M19 20.5C19 16.634 15.866 13.5 12 13.5C8.13401 13.5 5 16.634 5 20.5&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="https://www.firecrawl.dev/agent-onboarding/SKILL.md">
  Browser sign-in, CLI install, skills, MCP wiring, and dashboard API keys.
</Card>

## Using WorkOS ID-JAG [#using-workos-id-jag]

Use this when your agent platform can mint a WorkOS ID-JAG for Firecrawl.

<Card title="Open auth.md" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M8 7L16 7&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M8 11L12 11&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M13 21.5V21C13 18.1716 13 16.7574 13.8787 15.8787C14.7574 15 16.1716 15 19 15H19.5M20 13.3431V10C20 6.22876 20 4.34315 18.8284 3.17157C17.6569 2 15.7712 2 12 2C8.22877 2 6.34315 2 5.17157 3.17157C4 4.34314 4 6.22876 4 10L4 14.5442C4 17.7892 4 19.4117 4.88607 20.5107C5.06508 20.7327 5.26731 20.9349 5.48933 21.1139C6.58831 22 8.21082 22 11.4558 22C12.1614 22 12.5141 22 12.8372 21.886C12.9044 21.8623 12.9702 21.835 13.0345 21.8043C13.3436 21.6564 13.593 21.407 14.0919 20.9081L18.8284 16.1716C19.4065 15.5935 19.6955 15.3045 19.8478 14.9369C20 14.5694 20 14.1606 20 13.3431Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="https://www.firecrawl.dev/auth.md">
  Agent registration instructions for identity-aware agents. Follow the steps in order.
</Card>

For claim requirements, discovery, registration, limits, and errors, use [`auth.md`](https://www.firecrawl.dev/auth.md).

## Discovery [#discovery]

Discovery steps live in [`auth.md`](https://www.firecrawl.dev/auth.md) Step 1. If you already have a direct link to [`auth.md`](https://www.firecrawl.dev/auth.md), fetch it. You do not need this page.

## What happens next [#what-happens-next]

Follow [`auth.md`](https://www.firecrawl.dev/auth.md) Steps 1–4 to discover the registration flow, register at `POST /agent/auth`, and use the returned API key with the Firecrawl API.