diff --git a/api-reference/endpoint/ask.mdx b/api-reference/endpoint/ask.mdx index c0e5f9ca..4abc0f3e 100644 --- a/api-reference/endpoint/ask.mdx +++ b/api-reference/endpoint/ask.mdx @@ -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 diff --git a/api-reference/v2-openapi.json b/api-reference/v2-openapi.json index 42889906..30258266 100644 --- a/api-reference/v2-openapi.json +++ b/api-reference/v2-openapi.json @@ -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." diff --git a/features/ask.mdx b/features/ask.mdx index e57179e6..7250dbe2 100644 --- a/features/ask.mdx +++ b/features/ask.mdx @@ -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": { "": "" }, "validation": { "tested": true, "result": "success", - "evidence": "validateScrape with allowBackwardCrawling:true returned 12,403 chars vs 0 baseline." + "evidence": "" }, "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