Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt

Use this file to discover all available pages before exploring further.

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

  1. You describe the problem — a natural-language question describing the issue.
  2. The agent investigates — it inspects job logs, account state, documentation, and source code.
  3. The agent validates — when possible, the agent tests a fix against the live Firecrawl API (e.g., retrying a scrape with adjusted parameters).
  4. You get a verified answer — the response includes a prose answer, machine-readable fixParameters you can apply directly, and validation results 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. 
curl -X POST https://api.firecrawl.dev/v2/support/ask \
  -H "Authorization: Bearer fc-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "my crawl returned 3 pages but I expected 50",
    "rationale": "user is on their third failed crawl attempt today"
  }'

​
Response fields

FieldTypeDescription
answerstring2-4 sentence prose covering the diagnosis and fix
confidencestringhigh, medium, or low
fixParametersobject | nullAPI parameters to apply the fix (e.g., {"waitFor": 5000})
validationobject | nullWhether the fix was tested: tested, result (success/failure/skipped), evidence
feedbackobject | nullPresent when the agent gets stuck; { blockedBy, attempted }. Null on success.
durationMsintegerTotal execution time in milliseconds

​
Status codes

CodeMeaning
200Answered or stuck (envelope always returned)
400Invalid JSON or schema violation
401Missing or invalid bearer token
504Hit 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.