feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 29
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-d60fed3d26479d1ee76b77df8415390504542522e7188792a23bf77b9f37ed63.yml
-openapi_spec_hash: 263672c59d9b01c50f7d2307fbd82ec0
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-adab8df19dce27396e4a0e698287f083e1f932e63b85fd8dd4d54f80f0e0b5a8.yml
+openapi_spec_hash: 717fea46f446ff97bad627f200963fd7
 config_hash: ff35e224e809656528c44163aa41bebd

src/context/dev/resources/web.py

@@ -1949,8 +1949,24 @@ def web_scrape_md(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WebWebScrapeMdResponse:
-        """
-        Scrapes the given URL into LLM usable Markdown.
+        """Scrapes the given URL into LLM usable Markdown.
+
+        Inspect key_metadata on JSON
+        responses from a recognized API key; use error_code to distinguish stable
+        failure categories.
+
+        ### Billing & errors
+
+        | HTTP status | Billed?        | Meaning                                                                                  |
+        | ----------- | -------------- | ---------------------------------------------------------------------------------------- |
+        | 200         | Yes — 1 credit | Successful scrape, including a zero-length result when includeSelectors matched nothing  |
+        | 400         | No             | Invalid input, skipped PDF, or the page could not be scraped                             |
+        | 401 / 403   | No             | Invalid/disabled key, insufficient permissions, or credits exhausted; inspect error_code |
+        | 404         | No             | Target page returned or fingerprinted as not found                                       |
+        | 408         | No             | Request timed out                                                                        |
+        | 415         | No             | Unsupported content type                                                                 |
+        | 429         | No             | Per-minute rate limit exceeded; honor Retry-After                                        |
+        | 500         | No             | Internal error                                                                           |
 
         Args:
           url: Full URL to scrape into LLM usable Markdown (must include http:// or https://
@@ -4007,8 +4023,24 @@ async def web_scrape_md(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WebWebScrapeMdResponse:
-        """
-        Scrapes the given URL into LLM usable Markdown.
+        """Scrapes the given URL into LLM usable Markdown.
+
+        Inspect key_metadata on JSON
+        responses from a recognized API key; use error_code to distinguish stable
+        failure categories.
+
+        ### Billing & errors
+
+        | HTTP status | Billed?        | Meaning                                                                                  |
+        | ----------- | -------------- | ---------------------------------------------------------------------------------------- |
+        | 200         | Yes — 1 credit | Successful scrape, including a zero-length result when includeSelectors matched nothing  |
+        | 400         | No             | Invalid input, skipped PDF, or the page could not be scraped                             |
+        | 401 / 403   | No             | Invalid/disabled key, insufficient permissions, or credits exhausted; inspect error_code |
+        | 404         | No             | Target page returned or fingerprinted as not found                                       |
+        | 408         | No             | Request timed out                                                                        |
+        | 415         | No             | Unsupported content type                                                                 |
+        | 429         | No             | Per-minute rate limit exceeded; honor Retry-After                                        |
+        | 500         | No             | Internal error                                                                           |
 
         Args:
           url: Full URL to scrape into LLM usable Markdown (must include http:// or https://

src/context/dev/types/web_web_scrape_md_response.py

@@ -102,6 +102,13 @@ class KeyMetadata(BaseModel):
 
 
 class WebWebScrapeMdResponse(BaseModel):
+    content_length: int = FieldInfo(alias="contentLength")
+    """UTF-8 byte length of the returned Markdown.
+
+    Use 0 to identify an empty result and compare small values against your
+    workload's minimum useful-content threshold.
+    """
+
     markdown: str
     """Page content converted to GitHub Flavored Markdown"""