From 0867bd024b1cf7e83246b31ab899455c97454d30 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 17 Aug 2026 13:42:53 +0000 Subject: [PATCH 1/5] docs: add agent usability redirects and endpoint lookup tables Land the 15 August 2026 Firecrawl Agent Usability Actionables redirects and the two content improvements still open from the July 18 baseline. docs.json: add 15 redirects (5 browser/interact, 2 crawl, 8 team management) for slug variants agents construct from HTTP paths. The redirects array goes 118 -> 133 entries. The get-team-activity redirect targets /api-reference/endpoint/activity rather than the proposed /api-reference/endpoint/team-activity, which is itself a redirect source and would have produced a two-hop chain. api-reference/endpoint/activity.mdx: add a "Team Management Endpoints" verb-to-slug lookup table mapping each team operation to its /v2/team/... HTTP path and its canonical docs page. Placed on the first page of the Account Endpoints group, which is where the team-* redirects land. features/interact.mdx: extend the existing "Choose the right interaction model" table with an SDK methods column instead of adding a second, overlapping operations table. Method names verified against the snippets under snippets/v2/browser and snippets/v2/interact. --- api-reference/endpoint/activity.mdx | 13 +++++++ docs.json | 60 +++++++++++++++++++++++++++++ features/interact.mdx | 10 ++--- 3 files changed, 78 insertions(+), 5 deletions(-) diff --git a/api-reference/endpoint/activity.mdx b/api-reference/endpoint/activity.mdx index cf57c1e3e..5bf997559 100644 --- a/api-reference/endpoint/activity.mdx +++ b/api-reference/endpoint/activity.mdx @@ -11,3 +11,16 @@ Lists your recent API activity from the last 24 hours. Use this to discover job | `crawl` | `GET /v2/crawl/{id}` | | `batch_scrape` | `GET /v2/batch/scrape/{id}` | | `agent` | `GET /v2/agent/{jobId}` | + +## Team Management Endpoints + +Team endpoints are served under `/v2/team/...`, but their docs slugs drop the `team` prefix. Use this table to map an operation to the right HTTP path and docs page. + +| Operation | API path | Docs page | +|---|---|---| +| Team activity | `GET /v2/team/activity` | [`activity`](/api-reference/endpoint/activity) | +| Credit usage | `GET /v2/team/credit-usage` | [`credit-usage`](/api-reference/endpoint/credit-usage) | +| Credit usage (historical) | `GET /v2/team/credit-usage/historical` | [`credit-usage-historical`](/api-reference/endpoint/credit-usage-historical) | +| Queue status | `GET /v2/team/queue-status` | [`queue-status`](/api-reference/endpoint/queue-status) | +| Token usage | `GET /v2/team/token-usage` | [`token-usage`](/api-reference/endpoint/token-usage) | +| Token usage (historical) | `GET /v2/team/token-usage/historical` | [`token-usage-historical`](/api-reference/endpoint/token-usage-historical) | diff --git a/docs.json b/docs.json index c75eecbfe..879b240c5 100755 --- a/docs.json +++ b/docs.json @@ -4841,6 +4841,66 @@ ] }, "redirects": [ + { + "destination": "/api-reference/endpoint/browser-create", + "source": "/api-reference/endpoint/browser-create-session" + }, + { + "destination": "/api-reference/endpoint/browser-execute", + "source": "/api-reference/endpoint/browser-actions" + }, + { + "destination": "/api-reference/endpoint/scrape-browser-delete", + "source": "/api-reference/endpoint/scrape-delete-interact" + }, + { + "destination": "/api-reference/endpoint/crawl-params-preview", + "source": "/api-reference/endpoint/crawl-url-params-preview" + }, + { + "destination": "/api-reference/endpoint/crawl-params-preview", + "source": "/api-reference/endpoint/crawl-url-preview" + }, + { + "destination": "/api-reference/endpoint/crawl-active", + "source": "/api-reference/endpoint/crawl-get-active" + }, + { + "destination": "/features/interact", + "source": "/features/scrape-and-interact" + }, + { + "destination": "/api-reference/endpoint/token-usage", + "source": "/api-reference/endpoint/get-token-usage" + }, + { + "destination": "/api-reference/endpoint/token-usage-historical", + "source": "/api-reference/endpoint/get-token-usage-historical" + }, + { + "destination": "/api-reference/endpoint/activity", + "source": "/api-reference/endpoint/get-team-activity" + }, + { + "destination": "/api-reference/endpoint/queue-status", + "source": "/api-reference/endpoint/get-team-queue-status" + }, + { + "destination": "/api-reference/endpoint/credit-usage-historical", + "source": "/api-reference/endpoint/get-team-credit-usage-historical" + }, + { + "destination": "/api-reference/endpoint/token-usage", + "source": "/api-reference/endpoint/team/get-token-usage" + }, + { + "destination": "/api-reference/endpoint/token-usage-historical", + "source": "/api-reference/endpoint/team/get-token-usage-historical" + }, + { + "destination": "/api-reference/endpoint/credit-usage-historical", + "source": "/api-reference/endpoint/team/get-credit-usage-historical" + }, { "destination": "/mcp-server", "source": "/mcp-server/connect" diff --git a/features/interact.mdx b/features/interact.mdx index deb1d02c5..0d277f604 100644 --- a/features/interact.mdx +++ b/features/interact.mdx @@ -53,12 +53,12 @@ Scrape a page to get clean data, then call `/interact` to start taking actions i ## Choose the right interaction model -| Need | Use | Canonical docs | -|---|---|---| -| Start a standalone browser session without scraping first | Browser Sandbox / standalone Interact session | [Browser Sandbox](/features/browser), [Create Browser Session](/api-reference/endpoint/browser-create), [Execute Browser Code](/api-reference/endpoint/browser-execute), [List Browser Sessions](/api-reference/endpoint/browser-list), [Delete Browser Session](/api-reference/endpoint/browser-delete) | -| Continue from a scrape result using `scrapeId` | Interact after scraping | [Execute Interact](/api-reference/endpoint/scrape-execute), [Stop Interact](/api-reference/endpoint/scrape-browser-delete) | +| Need | Use | Canonical docs | SDK methods (Node) | +|---|---|---|---| +| Start a standalone browser session without scraping first | Browser Sandbox / standalone Interact session | [Browser Sandbox](/features/browser), [Create Browser Session](/api-reference/endpoint/browser-create), [Execute Browser Code](/api-reference/endpoint/browser-execute), [List Browser Sessions](/api-reference/endpoint/browser-list), [Delete Browser Session](/api-reference/endpoint/browser-delete) | `browser()`, `browserExecute()`, `listBrowsers()`, `deleteBrowser()` | +| Continue from a scrape result using `scrapeId` | Interact after scraping | [Execute Interact](/api-reference/endpoint/scrape-execute), [Stop Interact](/api-reference/endpoint/scrape-browser-delete) | `interact()`, `stopInteraction()` | -Use scrape-bound Interact when the workflow begins with `POST /v2/scrape` and the response includes `data.metadata.scrapeId`. Use Browser Sandbox when you need a standalone session with its own lifecycle. +Use scrape-bound Interact when the workflow begins with `POST /v2/scrape` and the response includes `data.metadata.scrapeId`. Use Browser Sandbox when you need a standalone session with its own lifecycle. The Python SDK uses the snake_case equivalents (`browser()`, `browser_execute()`, `list_browsers()`, `delete_browser()`, `interact()`, `stop_interaction()`). From a5aaff0b0bbeab2433a162a6aecc268e78847f3f Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 18 Aug 2026 18:45:51 +0000 Subject: [PATCH 2/5] docs: drop lead-in prose above team endpoint table --- api-reference/endpoint/activity.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/api-reference/endpoint/activity.mdx b/api-reference/endpoint/activity.mdx index 5bf997559..c186fdccc 100644 --- a/api-reference/endpoint/activity.mdx +++ b/api-reference/endpoint/activity.mdx @@ -14,8 +14,6 @@ Lists your recent API activity from the last 24 hours. Use this to discover job ## Team Management Endpoints -Team endpoints are served under `/v2/team/...`, but their docs slugs drop the `team` prefix. Use this table to map an operation to the right HTTP path and docs page. - | Operation | API path | Docs page | |---|---|---| | Team activity | `GET /v2/team/activity` | [`activity`](/api-reference/endpoint/activity) | From ee1dca652d24b7292f14c774f2d78d3d78cc1d63 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 20 Aug 2026 20:09:44 +0000 Subject: [PATCH 3/5] docs: unlink token usage pages from team endpoint table --- api-reference/endpoint/activity.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/endpoint/activity.mdx b/api-reference/endpoint/activity.mdx index c186fdccc..314f1959a 100644 --- a/api-reference/endpoint/activity.mdx +++ b/api-reference/endpoint/activity.mdx @@ -20,5 +20,5 @@ Lists your recent API activity from the last 24 hours. Use this to discover job | Credit usage | `GET /v2/team/credit-usage` | [`credit-usage`](/api-reference/endpoint/credit-usage) | | Credit usage (historical) | `GET /v2/team/credit-usage/historical` | [`credit-usage-historical`](/api-reference/endpoint/credit-usage-historical) | | Queue status | `GET /v2/team/queue-status` | [`queue-status`](/api-reference/endpoint/queue-status) | -| Token usage | `GET /v2/team/token-usage` | [`token-usage`](/api-reference/endpoint/token-usage) | -| Token usage (historical) | `GET /v2/team/token-usage/historical` | [`token-usage-historical`](/api-reference/endpoint/token-usage-historical) | +| Token usage | `GET /v2/team/token-usage` | `token-usage` | +| Token usage (historical) | `GET /v2/team/token-usage/historical` | `token-usage-historical` | From db52f69abc757078d0b455668416c09228dd3fd4 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 20 Aug 2026 20:09:44 +0000 Subject: [PATCH 4/5] docs: hide token usage endpoint pages from api reference --- api-reference/endpoint/token-usage-historical.mdx | 3 +++ api-reference/endpoint/token-usage.mdx | 3 +++ 2 files changed, 6 insertions(+) diff --git a/api-reference/endpoint/token-usage-historical.mdx b/api-reference/endpoint/token-usage-historical.mdx index bcf4a7c09..8ce941e58 100644 --- a/api-reference/endpoint/token-usage-historical.mdx +++ b/api-reference/endpoint/token-usage-historical.mdx @@ -1,6 +1,9 @@ --- title: 'Historical Token Usage' openapi: '/api-reference/v2-openapi.json GET /team/token-usage/historical' +hidden: true +noindex: true + --- Returns historical token usage on a month-by-month basis. The endpoint can also breaks usage down by API key optionally. diff --git a/api-reference/endpoint/token-usage.mdx b/api-reference/endpoint/token-usage.mdx index 059350120..33cca1270 100644 --- a/api-reference/endpoint/token-usage.mdx +++ b/api-reference/endpoint/token-usage.mdx @@ -1,6 +1,9 @@ --- title: 'Token Usage' openapi: '/api-reference/v2-openapi.json GET /team/token-usage' +hidden: true +noindex: true + --- We've simplified billing so that Extract now uses credits, just like all of the other endpoints. Each credit is worth 15 tokens. Reported token usage now includes usage from all endpoints. From 65fd45127af7037b5d746476aab4e3f5d4f3eac3 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 20 Aug 2026 20:17:40 +0000 Subject: [PATCH 5/5] docs: drop token usage rows from team endpoint table --- api-reference/endpoint/activity.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/api-reference/endpoint/activity.mdx b/api-reference/endpoint/activity.mdx index 314f1959a..9ebd3292b 100644 --- a/api-reference/endpoint/activity.mdx +++ b/api-reference/endpoint/activity.mdx @@ -20,5 +20,3 @@ Lists your recent API activity from the last 24 hours. Use this to discover job | Credit usage | `GET /v2/team/credit-usage` | [`credit-usage`](/api-reference/endpoint/credit-usage) | | Credit usage (historical) | `GET /v2/team/credit-usage/historical` | [`credit-usage-historical`](/api-reference/endpoint/credit-usage-historical) | | Queue status | `GET /v2/team/queue-status` | [`queue-status`](/api-reference/endpoint/queue-status) | -| Token usage | `GET /v2/team/token-usage` | `token-usage` | -| Token usage (historical) | `GET /v2/team/token-usage/historical` | `token-usage-historical` |