Skip to content

docs(ask): drop usage from /support/ask response + neutralize example diagnosis #920

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
devhims merged 2 commits into from
May 7, 2026
Merged

docs(ask): drop usage from /support/ask response + neutralize example diagnosis #920

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f95b422
docs(ask): drop usage from /support/ask response + replace misleading…
devhims May 7, 2026
166ead6
chore: remove accidental .claude/worktrees gitlink
devhims May 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion api-reference/endpoint/ask.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,6 @@ curl -X POST https://api.firecrawl.dev/v2/support/ask \
| `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. |
| `usage` | object | Token consumption (`inputTokens`, `outputTokens`, `totalTokens`) |
| `durationMs` | integer | Total execution time in milliseconds |

## Status codes
Expand Down
15 changes: 0 additions & 15 deletions api-reference/v2-openapi.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5561,21 +5561,6 @@
}
}
},
"usage": {
"type": "object",
"description": "Token consumption for this request.",
"properties": {
"inputTokens": {
"type": "integer"
},
"outputTokens": {
"type": "integer"
},
"totalTokens": {
"type": "integer"
}
}
},
"durationMs": {
"type": "integer",
"description": "Total execution time in milliseconds."
Expand Down
9 changes: 5 additions & 4 deletions features/ask.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -170,20 +170,21 @@ if not doc.markdown or len(doc.markdown) < 100:
```json
{
"requestId": "req_...",
"answer": "Your crawl is hitting a robots.txt disallow on /products/*. The fix is to add the allowBackwardCrawling parameter.",
"answer": "<2-4 sentence prose diagnosis of the issue plus the recommended fix.>",
"confidence": "high",
"fixParameters": { "allowBackwardCrawling": true },
"fixParameters": { "<param>": "<value>" },
"validation": {
"tested": true,
"result": "success",
"evidence": "validateScrape with allowBackwardCrawling:true returned 12,403 chars vs 0 baseline."
"evidence": "<short summary of the validation tool call the agent ran to confirm the fix>"
},
"feedback": null,
"usage": { "inputTokens": 12345, "outputTokens": 678, "totalTokens": 13023 },
"durationMs": 18432
}
```

The actual `answer`, `fixParameters`, and `validation.evidence` are produced per request by the agent based on your specific run; the example above shows the response shape, not a real diagnosis.

### `/support/docs-search` response

```json
Expand Down