Skip to main content
POST
/
support
/
ask
Ask the Firecrawl support agent
curl --request POST \
  --url https://api.firecrawl.dev/v2/support/ask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>",
  "rationale": "<string>"
}
'
{
  "answer": "<string>",
  "fixParameters": {},
  "validation": {},
  "feedback": {},
  "durationMs": 123
}
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.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
question
string
required

Question or issue for the support agent to diagnose.

​
rationale
string

Optional context about what the end user is trying to accomplish.

Response

Support agent answer

​
answer
string

Diagnosis and recommended fix.

​
confidence
enum<string>
Available options:
high,
medium,
low
​
fixParameters
object

Machine-readable API parameters that may fix the issue.

​
validation
object

Validation result when the support agent tested or attempted a fix.

​
feedback
object

Present when the support agent is blocked or needs more information.

​
durationMs
integer

Total support-agent execution time in milliseconds.