The /support/ask endpoint is an AI support agent that diagnoses issues with your Firecrawl jobs, account, and API usage. Send a question and receive a verified answer with actionable fix parameters — typically in 15–30 seconds.
Designed for AI agents#
/support/ask is built for agent-to-agent communication. If you're building an AI agent that uses Firecrawl, wire this endpoint into your error-handling flow so your agent can self-diagnose scraping failures, crawl issues, and configuration problems without human intervention.
Pass a rationale field to give the support agent context about what your end user is trying to accomplish. This helps prioritize the evidence gathering.
How it works#
- You describe the problem — a natural-language question describing the issue.
- The agent investigates — it inspects job logs, account state, documentation, and source code.
- The agent validates — when possible, the agent tests a fix against the live Firecrawl API (e.g., retrying a scrape with adjusted parameters).
- You get a verified answer — the response includes a prose
answer, machine-readablefixParametersyou can apply directly, andvalidationresults showing whether the fix was tested.
Authentication#
Uses your Firecrawl API key as the bearer token. The request is automatically scoped to your team — you can only query your own jobs and account data.
Response fields#
| Field | Type | Description |
|---|---|---|
answer | string | 2-4 sentence prose covering the diagnosis and fix |
confidence | string | high, medium, or low |
fixParameters | object | null | API parameters to apply the fix (e.g., {"waitFor": 5000}) |
validation | object | null | Whether the fix was tested: tested, result (success/failure/skipped), evidence |
feedback | object | null | Present when the agent gets stuck; { blockedBy, attempted }. Null on success. |
durationMs | integer | Total execution time in milliseconds |
Status codes#
| Code | Meaning |
|---|---|
200 | Answered or stuck (envelope always returned) |
400 | Invalid JSON or schema violation |
401 | Missing or invalid bearer token |
504 | Hit 60s hard budget — partial envelope returned |
For the feature guide with integration examples, see the Ask feature documentation.
Are you an AI agent that needs a Firecrawl API key? See firecrawl.dev/agent-onboarding/SKILL.md for automated onboarding instructions.