From f95b4226b0948894d00cd6b612557e1f33e87286 Mon Sep 17 00:00:00 2001 From: Himanshu Gupta Date: Thu, 7 May 2026 19:57:59 +0530 Subject: [PATCH 1/2] docs(ask): drop usage from /support/ask response + replace misleading example MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit support-agent dropped `usage` from the customer-facing /v2/support/ask response envelope (it was an internal cost-tracking signal customers can't act on). Sync the docs: - api-reference/v2-openapi.json: remove `usage` from AskResponse schema. - api-reference/endpoint/ask.mdx: remove the `usage` row from the response fields table. - features/ask.mdx: remove the `usage` line from the /ask example payload AND replace the prior example answer/fixParameters/validation with neutral placeholders. The previous example was a fabricated diagnosis ("Your crawl is hitting a robots.txt disallow on /products/*. The fix is to add the allowBackwardCrawling parameter.") that read like real Firecrawl guidance — readers might apply it to unrelated runs even though the agent's actual answer is generated per-request from the user's specific job logs. Replaced with `<...>` placeholders + an explicit note clarifying that the example shows the shape, not a real diagnosis. The /support/docs-search example keeps its usage field — that endpoint still returns it (different envelope shape, different code path). Co-Authored-By: Claude Opus 4.6 --- .claude/worktrees/objective-lovelace-bb576a | 1 + api-reference/endpoint/ask.mdx | 1 - api-reference/v2-openapi.json | 15 --------------- features/ask.mdx | 9 +++++---- 4 files changed, 6 insertions(+), 20 deletions(-) create mode 160000 .claude/worktrees/objective-lovelace-bb576a diff --git a/.claude/worktrees/objective-lovelace-bb576a b/.claude/worktrees/objective-lovelace-bb576a new file mode 160000 index 00000000..0ec4bbc1 --- /dev/null +++ b/.claude/worktrees/objective-lovelace-bb576a @@ -0,0 +1 @@ +Subproject commit 0ec4bbc10486052004649077b1840d28f8e76e91 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 From 166ead6fb38cb0c5f0f27d85f48e0dfb210de4d2 Mon Sep 17 00:00:00 2001 From: Himanshu Gupta Date: Thu, 7 May 2026 19:58:14 +0530 Subject: [PATCH 2/2] chore: remove accidental .claude/worktrees gitlink --- .claude/worktrees/objective-lovelace-bb576a | 1 - 1 file changed, 1 deletion(-) delete mode 160000 .claude/worktrees/objective-lovelace-bb576a diff --git a/.claude/worktrees/objective-lovelace-bb576a b/.claude/worktrees/objective-lovelace-bb576a deleted file mode 160000 index 0ec4bbc1..00000000 --- a/.claude/worktrees/objective-lovelace-bb576a +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 0ec4bbc10486052004649077b1840d28f8e76e91