bytekit-sdk 0.9.2__tar.gz → 0.9.3__tar.gz

{bytekit_sdk-0.9.2 → bytekit_sdk-0.9.3}/CHANGELOG.md

@@ -5,6 +5,71 @@ PyPI distribution: `bytekit-sdk`. Import name: `bytekit`.
 
 ## Unreleased
 
+## 0.9.3
+
+_Release cut 2026-10-03._
+
+### Added
+
+- **`bytekit.ByteKit` and `bytekit.ByteKitError`** (#5351) — a two-line entry point that raises on
+  any non-2xx, the way the TypeScript SDK does: `client = ByteKit(api_key=...)`, then
+  `client.scrape.create(url=..., formats=["markdown"])`. Every API operation is a method on a resource (`scrape`, `screenshots`,
+  `bulk`, `monitors`, `usage`, ...), delegated to the generated `bytekit.api.*` function. Any
+  non-2xx response, a `200` scrape carrying the `failed` envelope, and any response the generated
+  operation cannot parse (an undocumented status, a non-JSON or drifted body) raises `ByteKitError` with
+  `status_code`, `code` and `message`; it subclasses `UnexpectedStatus`, so existing handlers keep
+  catching it. A transport failure propagates as the `httpx` exception. `AuthenticatedClient`,
+  `bytekit.api.*` and the returned `Error` models are unchanged.
+
+### Changed
+
+- **`BillingNode.raw_bytes` and `ScrapeSuccessEnvelope.content_length` docstrings name the
+  hosted-browser tier** (#5120) — a page served by that tier reports the browser's full measured
+  transfer as its byte basis. Docstring only, no model field changes. Regenerated from
+  `docs/api/openapi.yaml`.
+- **`ScrapeWarningCode` gains the five extraction codes** (#5130) — `EXTRACT_VALIDATION_FAILED`,
+  `EXHAUSTED_RETRIES`, `CONTENT_TRUNCATED`, `MODEL_REFUSAL` and `EMPTY_EXTRACTION`, so a scrape
+  response carrying one of them parses instead of failing on an unknown enum member. Regenerated
+  from `docs/api/openapi.yaml`.
+- **`ScreenshotRequest` gains `async_`, and `create_scrape` gains an `async_` query argument**
+  (#5349) — `async` is now accepted as a body field or a `?async=true` query parameter on both
+  `/v1/scrape` and `/v1/screenshots`; either one turns async on, and `false` in one never cancels
+  `true` in the other. Regenerated from `docs/api/openapi.yaml`.
+- `WebhookDeliveryResponseEventType` gains `MONITOR_SUSPENDED = "monitor.suspended"` (#5408). The
+  worker sends that event when a monitor is suspended because the account ran out of balance, and
+  `GET /v1/webhook-deliveries` can return it; before, parsing such a delivery raised `ValueError`.
+  Regenerated from `docs/api/openapi.yaml`.
+- The README quick start now uses the `ByteKit` facade (#5409), calling
+  `client.scrape.create(url=..., formats=["markdown"])` rather than `AuthenticatedClient` with
+  `create_scrape.sync(...)`, and the text under it says what the facade raises. The Error handling
+  section is unchanged. Documentation only, no code change.
+- **Models and docstrings follow the corrected spec** (#5410) — `ScrapeRequest.formats` items are
+  `ScrapeRequestFormatsItem | ScrapeRequestJsonFormat` (the four string formats, or the `json`
+  object entry), and `ScrapeFormats` gains `json`. `create_screenshot`, `create_sitemap` and the
+  three bulk creates type a `403` response, `create_scrape` a `503`, and `get_fetch` gains a
+  `custom` argument (a JSON-encoded object). `create_search` documents that its `503` can be the
+  `Error` envelope (`billing_entitlement_missing`) as well as the vendor-masked
+  `CreateSearchResponse503`, and caps `query` at 2048 characters. **Behavior change:** a
+  `billing_entitlement_missing` `503` from `create_search` is now returned as an `Error` model
+  instead of raising `UnexpectedStatus`; the vendor-masked body parses as before. Regenerated from
+  `docs/api/openapi.yaml`.
+
+### Fixed
+
+- `401 Unauthorized` now returns a typed `Error` instead of raising `UnexpectedStatus` on every
+  bearer-authenticated operation (#5114). The spec declared `401` on only one of them, so a
+  rejected API key hit the undocumented-status arm of the generated client — the same gap #3784
+  closed for `402`. A JSON `Error` envelope (`invalid_api_key`, or `unauthorized` when an operation
+  that also accepts a dashboard session gets no usable `Authorization` header) is now returned, and `sync_detailed(...).status_code` is `401`;
+  a non-JSON `401` still raises `UnexpectedStatus`, and `AuthenticatedClient.search()` still raises
+  on a `401`. Regenerated from the corrected spec:
+
+  ```python
+  result = create_scrape.sync(client=client, body=body)
+  if isinstance(result, Error):
+      print(result.error.code)  # invalid_api_key | unauthorized
+  ```
+
 ## 0.9.2
 
 _Release cut 2026-10-02._

{bytekit_sdk-0.9.2 → bytekit_sdk-0.9.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: bytekit-sdk
-Version: 0.9.2
+Version: 0.9.3
 Summary: Official Python SDK for the ByteKit API
 Project-URL: Homepage, https://bytekit.com
 Project-URL: Repository, https://github.com/Hunt-Labs-Inc/ByteKit
@@ -43,31 +43,25 @@ The installed version is available as `bytekit.__version__`.
 ## Quick start
 
 ```python
-from bytekit import AuthenticatedClient
-from bytekit.api.scrape import create_scrape
-from bytekit.models.scrape_request import ScrapeRequest
-from bytekit.models.scrape_request_formats_item import ScrapeRequestFormatsItem
-from bytekit.models.scrape_success_envelope import ScrapeSuccessEnvelope
+from bytekit import ByteKit
+from bytekit.models import ScrapeSuccessEnvelope
 
-# base_url defaults to https://api.bytekit.com, so only the token is required.
-client = AuthenticatedClient(token="sk_live_your_api_key_here")
+# base_url defaults to https://api.bytekit.com, so only the API key is required.
+client = ByteKit(api_key="sk_live_your_api_key_here")
 
-result = create_scrape.sync(
-    client=client,
-    body=ScrapeRequest(
-        url="https://example.com",
-        # Ask for markdown explicitly. `formats` is a list of enum members, not plain
-        # strings. Omit it and the server returns raw HTML instead, leaving
-        # `formats.markdown` unset.
-        formats=[ScrapeRequestFormatsItem.MARKDOWN],
-    ),
-)
+# Ask for markdown explicitly. Omit `formats` and the server returns raw HTML, leaving
+# `formats.markdown` unset.
+result = client.scrape.create(url="https://example.com", formats=["markdown"])
 
 if isinstance(result, ScrapeSuccessEnvelope):
     print(result.formats.markdown)
 ```
 
-See [Error handling](#error-handling) for what `result` can be when the request fails.
+`ByteKit` raises `ByteKitError` on any non-2xx response and on a scrape that comes back with the
+`failed` envelope, so `result` here is either the `ScrapeSuccessEnvelope` or, for a request that
+was queued, a `ScrapeQueuedEnvelope`. The generated operations the facade wraps
+(`create_scrape.sync` and the rest) return a typed `Error` for a documented error status instead;
+see [Error handling](#error-handling) for that contract.
 
 ### Error handling
 

{bytekit_sdk-0.9.2 → bytekit_sdk-0.9.3}/README.md

@@ -17,31 +17,25 @@ The installed version is available as `bytekit.__version__`.
 ## Quick start
 
 ```python
-from bytekit import AuthenticatedClient
-from bytekit.api.scrape import create_scrape
-from bytekit.models.scrape_request import ScrapeRequest
-from bytekit.models.scrape_request_formats_item import ScrapeRequestFormatsItem
-from bytekit.models.scrape_success_envelope import ScrapeSuccessEnvelope
+from bytekit import ByteKit
+from bytekit.models import ScrapeSuccessEnvelope
 
-# base_url defaults to https://api.bytekit.com, so only the token is required.
-client = AuthenticatedClient(token="sk_live_your_api_key_here")
+# base_url defaults to https://api.bytekit.com, so only the API key is required.
+client = ByteKit(api_key="sk_live_your_api_key_here")
 
-result = create_scrape.sync(
-    client=client,
-    body=ScrapeRequest(
-        url="https://example.com",
-        # Ask for markdown explicitly. `formats` is a list of enum members, not plain
-        # strings. Omit it and the server returns raw HTML instead, leaving
-        # `formats.markdown` unset.
-        formats=[ScrapeRequestFormatsItem.MARKDOWN],
-    ),
-)
+# Ask for markdown explicitly. Omit `formats` and the server returns raw HTML, leaving
+# `formats.markdown` unset.
+result = client.scrape.create(url="https://example.com", formats=["markdown"])
 
 if isinstance(result, ScrapeSuccessEnvelope):
     print(result.formats.markdown)
 ```
 
-See [Error handling](#error-handling) for what `result` can be when the request fails.
+`ByteKit` raises `ByteKitError` on any non-2xx response and on a scrape that comes back with the
+`failed` envelope, so `result` here is either the `ScrapeSuccessEnvelope` or, for a request that
+was queued, a `ScrapeQueuedEnvelope`. The generated operations the facade wraps
+(`create_scrape.sync` and the rest) return a typed `Error` for a documented error status instead;
+see [Error handling](#error-handling) for that contract.
 
 ### Error handling
 

{bytekit_sdk-0.9.2 → bytekit_sdk-0.9.3}/pyproject.toml

@@ -7,7 +7,7 @@
 # `pip install bytekit-sdk` yields a working `import bytekit`. Mirrors the npm sibling
 # @hunt-labs/bytekit-sdk.
 name = "bytekit-sdk"
-version = "0.9.2"
+version = "0.9.3"
 description = "Official Python SDK for the ByteKit API"
 readme = "README.md"
 requires-python = ">=3.10"

{bytekit_sdk-0.9.2 → bytekit_sdk-0.9.3}/src/bytekit/__init__.py

@@ -37,3 +37,18 @@ except PackageNotFoundError:
     # own test suite, which runs install-free via pyproject.toml's `pythonpath = ["src"]`.
     # A valid PEP 440 development version, never an empty string and never an import-time raise.
     __version__ = "0.0.0.dev0"
+
+
+# BYTEKIT-HANDWRITTEN: ByteKit facade export (#5351, injected post-generation)
+#
+# This fragment is APPENDED to the generated src/bytekit/__init__.py by
+# scripts/inject-handwritten.py, which installs the module itself as facade.py in the same run.
+#
+# Same shape as models_bulk_completed_webhook_export.py: `__all__` is a TUPLE the generator closed
+# above, so an append extends it by rebinding rather than editing the generated block.
+from .facade import ByteKit, ByteKitError
+
+__all__ = __all__ + (
+    "ByteKit",
+    "ByteKitError",
+)

{bytekit_sdk-0.9.2 → bytekit_sdk-0.9.3}/src/bytekit/api/account/get_account.py

@@ -44,6 +44,10 @@ def _parse_response(
         response_200 = errors.bytekit_parse(_parse_response_200, client=client, response=response)
 
         return response_200
+    if response.status_code == 401:
+        response_401 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
+
+        return response_401
     if response.status_code == 429:
         response_429 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
 

{bytekit_sdk-0.9.2 → bytekit_sdk-0.9.3}/src/bytekit/api/bulk/create_bulk.py

@@ -6,6 +6,7 @@ from ... import errors
 from ...client import AuthenticatedClient, Client
 from ...models.create_bulk_body import CreateBulkBody
 from ...models.create_bulk_response_202 import CreateBulkResponse202
+from ...models.create_bulk_response_403 import CreateBulkResponse403
 from ...models.error import Error
 from ...types import Response
 
@@ -31,7 +32,7 @@ def _get_kwargs(
 
 def _parse_response(
     *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Optional[Union[CreateBulkResponse202, Error]]:
+) -> Optional[Union[CreateBulkResponse202, CreateBulkResponse403, Error]]:
     if response.status_code == 202:
         response_202 = errors.bytekit_parse(CreateBulkResponse202.from_dict, client=client, response=response)
 
@@ -40,10 +41,18 @@ def _parse_response(
         response_400 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
 
         return response_400
+    if response.status_code == 401:
+        response_401 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
+
+        return response_401
     if response.status_code == 402:
         response_402 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
 
         return response_402
+    if response.status_code == 403:
+        response_403 = errors.bytekit_parse(CreateBulkResponse403.from_dict, client=client, response=response)
+
+        return response_403
     if response.status_code == 422:
         response_422 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
 
@@ -56,7 +65,7 @@ def _parse_response(
 
 def _build_response(
     *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Response[Union[CreateBulkResponse202, Error]]:
+) -> Response[Union[CreateBulkResponse202, CreateBulkResponse403, Error]]:
     return Response(
         status_code=errors.bytekit_status_code(response.status_code),  # BYTEKIT-STATUS-COERCE
         content=response.content,
@@ -69,7 +78,7 @@ def sync_detailed(
     *,
     client: Union[AuthenticatedClient, Client],
     body: CreateBulkBody,
-) -> Response[Union[CreateBulkResponse202, Error]]:
+) -> Response[Union[CreateBulkResponse202, CreateBulkResponse403, Error]]:
     """Create mixed bulk job
 
      Enqueues screenshots or scrapes in a single batch.
@@ -118,7 +127,7 @@ def sync_detailed(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[Union[CreateBulkResponse202, Error]]
+        Response[Union[CreateBulkResponse202, CreateBulkResponse403, Error]]
     """
 
     kwargs = _get_kwargs(
@@ -136,7 +145,7 @@ def sync(
     *,
     client: Union[AuthenticatedClient, Client],
     body: CreateBulkBody,
-) -> Optional[Union[CreateBulkResponse202, Error]]:
+) -> Optional[Union[CreateBulkResponse202, CreateBulkResponse403, Error]]:
     """Create mixed bulk job
 
      Enqueues screenshots or scrapes in a single batch.
@@ -185,7 +194,7 @@ def sync(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Union[CreateBulkResponse202, Error]
+        Union[CreateBulkResponse202, CreateBulkResponse403, Error]
     """
 
     return sync_detailed(
@@ -198,7 +207,7 @@ async def asyncio_detailed(
     *,
     client: Union[AuthenticatedClient, Client],
     body: CreateBulkBody,
-) -> Response[Union[CreateBulkResponse202, Error]]:
+) -> Response[Union[CreateBulkResponse202, CreateBulkResponse403, Error]]:
     """Create mixed bulk job
 
      Enqueues screenshots or scrapes in a single batch.
@@ -247,7 +256,7 @@ async def asyncio_detailed(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[Union[CreateBulkResponse202, Error]]
+        Response[Union[CreateBulkResponse202, CreateBulkResponse403, Error]]
     """
 
     kwargs = _get_kwargs(
@@ -263,7 +272,7 @@ async def asyncio(
     *,
     client: Union[AuthenticatedClient, Client],
     body: CreateBulkBody,
-) -> Optional[Union[CreateBulkResponse202, Error]]:
+) -> Optional[Union[CreateBulkResponse202, CreateBulkResponse403, Error]]:
     """Create mixed bulk job
 
      Enqueues screenshots or scrapes in a single batch.
@@ -312,7 +321,7 @@ async def asyncio(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Union[CreateBulkResponse202, Error]
+        Union[CreateBulkResponse202, CreateBulkResponse403, Error]
     """
 
     return (

{bytekit_sdk-0.9.2 → bytekit_sdk-0.9.3}/src/bytekit/api/bulk/delete_bulk.py

@@ -28,6 +28,10 @@ def _parse_response(
         response_200 = errors.bytekit_parse(DeleteBulkResponse200.from_dict, client=client, response=response)
 
         return response_200
+    if response.status_code == 401:
+        response_401 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
+
+        return response_401
     if response.status_code == 404:
         response_404 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
 

{bytekit_sdk-0.9.2 → bytekit_sdk-0.9.3}/src/bytekit/api/bulk/get_bulk.py

@@ -33,6 +33,10 @@ def _parse_response(
         response_202 = errors.bytekit_parse(GetBulkResponse202.from_dict, client=client, response=response)
 
         return response_202
+    if response.status_code == 401:
+        response_401 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
+
+        return response_401
     if response.status_code == 404:
         response_404 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
 
@@ -61,6 +65,17 @@ def sync_detailed(
 ) -> Response[Union[Error, GetBulkResponse200, GetBulkResponse202]]:
     """Get bulk job status
 
+     Returns the job envelope. Items are listed by `GET /v1/bulk/{id}/screenshots`.
+
+    **Cancelled by the platform.** When the account can no longer spend (its bandwidth
+    balance is exhausted, or the account is deleted) while items are still pending, ByteKit
+    cancels the job itself. It then reads `status: cancelled` even though you never called
+    `DELETE /v1/bulk/{id}`, and the cancellation sends no webhook.
+
+    **Job ids from other create routes.** The job is looked up by account only, so the id
+    of a job created by `POST /v1/scrape/bulk` or `POST /v1/fetch/bulk` is found here too, not
+    a `404`, with that job's envelope. An id from another account answers `404`.
+
     Args:
         id (str):
 
@@ -90,6 +105,17 @@ def sync(
 ) -> Optional[Union[Error, GetBulkResponse200, GetBulkResponse202]]:
     """Get bulk job status
 
+     Returns the job envelope. Items are listed by `GET /v1/bulk/{id}/screenshots`.
+
+    **Cancelled by the platform.** When the account can no longer spend (its bandwidth
+    balance is exhausted, or the account is deleted) while items are still pending, ByteKit
+    cancels the job itself. It then reads `status: cancelled` even though you never called
+    `DELETE /v1/bulk/{id}`, and the cancellation sends no webhook.
+
+    **Job ids from other create routes.** The job is looked up by account only, so the id
+    of a job created by `POST /v1/scrape/bulk` or `POST /v1/fetch/bulk` is found here too, not
+    a `404`, with that job's envelope. An id from another account answers `404`.
+
     Args:
         id (str):
 
@@ -114,6 +140,17 @@ async def asyncio_detailed(
 ) -> Response[Union[Error, GetBulkResponse200, GetBulkResponse202]]:
     """Get bulk job status
 
+     Returns the job envelope. Items are listed by `GET /v1/bulk/{id}/screenshots`.
+
+    **Cancelled by the platform.** When the account can no longer spend (its bandwidth
+    balance is exhausted, or the account is deleted) while items are still pending, ByteKit
+    cancels the job itself. It then reads `status: cancelled` even though you never called
+    `DELETE /v1/bulk/{id}`, and the cancellation sends no webhook.
+
+    **Job ids from other create routes.** The job is looked up by account only, so the id
+    of a job created by `POST /v1/scrape/bulk` or `POST /v1/fetch/bulk` is found here too, not
+    a `404`, with that job's envelope. An id from another account answers `404`.
+
     Args:
         id (str):
 
@@ -141,6 +178,17 @@ async def asyncio(
 ) -> Optional[Union[Error, GetBulkResponse200, GetBulkResponse202]]:
     """Get bulk job status
 
+     Returns the job envelope. Items are listed by `GET /v1/bulk/{id}/screenshots`.
+
+    **Cancelled by the platform.** When the account can no longer spend (its bandwidth
+    balance is exhausted, or the account is deleted) while items are still pending, ByteKit
+    cancels the job itself. It then reads `status: cancelled` even though you never called
+    `DELETE /v1/bulk/{id}`, and the cancellation sends no webhook.
+
+    **Job ids from other create routes.** The job is looked up by account only, so the id
+    of a job created by `POST /v1/scrape/bulk` or `POST /v1/fetch/bulk` is found here too, not
+    a `404`, with that job's envelope. An id from another account answers `404`.
+
     Args:
         id (str):
 

{bytekit_sdk-0.9.2 → bytekit_sdk-0.9.3}/src/bytekit/api/bulk/list_bulk_screenshots.py

@@ -5,6 +5,7 @@ import httpx
 
 from ... import errors
 from ...client import AuthenticatedClient, Client
+from ...models.error import Error
 from ...models.list_bulk_screenshots_response_200 import ListBulkScreenshotsResponse200
 from ...models.list_bulk_screenshots_status import ListBulkScreenshotsStatus
 from ...types import UNSET, Response, Unset
@@ -42,11 +43,15 @@ def _get_kwargs(
 
 def _parse_response(
     *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Optional[ListBulkScreenshotsResponse200]:
+) -> Optional[Union[Error, ListBulkScreenshotsResponse200]]:
     if response.status_code == 200:
         response_200 = errors.bytekit_parse(ListBulkScreenshotsResponse200.from_dict, client=client, response=response)
 
         return response_200
+    if response.status_code == 401:
+        response_401 = errors.bytekit_parse(Error.from_dict, client=client, response=response)
+
+        return response_401
     if client.raise_on_unexpected_status:
         raise errors.bytekit_unexpected(response)  # BYTEKIT-OP-GUARD
     else:
@@ -55,7 +60,7 @@ def _parse_response(
 
 def _build_response(
     *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Response[ListBulkScreenshotsResponse200]:
+) -> Response[Union[Error, ListBulkScreenshotsResponse200]]:
     return Response(
         status_code=errors.bytekit_status_code(response.status_code),  # BYTEKIT-STATUS-COERCE
         content=response.content,
@@ -71,7 +76,7 @@ def sync_detailed(
     cursor: Union[Unset, str] = UNSET,
     limit: Union[Unset, int] = UNSET,
     status: Union[Unset, ListBulkScreenshotsStatus] = UNSET,
-) -> Response[ListBulkScreenshotsResponse200]:
+) -> Response[Union[Error, ListBulkScreenshotsResponse200]]:
     """List bulk job items
 
      Returns the bulk job's items, discriminated by `type`.
@@ -107,7 +112,7 @@ def sync_detailed(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[ListBulkScreenshotsResponse200]
+        Response[Union[Error, ListBulkScreenshotsResponse200]]
     """
 
     kwargs = _get_kwargs(
@@ -131,7 +136,7 @@ def sync(
     cursor: Union[Unset, str] = UNSET,
     limit: Union[Unset, int] = UNSET,
     status: Union[Unset, ListBulkScreenshotsStatus] = UNSET,
-) -> Optional[ListBulkScreenshotsResponse200]:
+) -> Optional[Union[Error, ListBulkScreenshotsResponse200]]:
     """List bulk job items
 
      Returns the bulk job's items, discriminated by `type`.
@@ -167,7 +172,7 @@ def sync(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        ListBulkScreenshotsResponse200
+        Union[Error, ListBulkScreenshotsResponse200]
     """
 
     return sync_detailed(
@@ -186,7 +191,7 @@ async def asyncio_detailed(
     cursor: Union[Unset, str] = UNSET,
     limit: Union[Unset, int] = UNSET,
     status: Union[Unset, ListBulkScreenshotsStatus] = UNSET,
-) -> Response[ListBulkScreenshotsResponse200]:
+) -> Response[Union[Error, ListBulkScreenshotsResponse200]]:
     """List bulk job items
 
      Returns the bulk job's items, discriminated by `type`.
@@ -222,7 +227,7 @@ async def asyncio_detailed(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[ListBulkScreenshotsResponse200]
+        Response[Union[Error, ListBulkScreenshotsResponse200]]
     """
 
     kwargs = _get_kwargs(
@@ -244,7 +249,7 @@ async def asyncio(
     cursor: Union[Unset, str] = UNSET,
     limit: Union[Unset, int] = UNSET,
     status: Union[Unset, ListBulkScreenshotsStatus] = UNSET,
-) -> Optional[ListBulkScreenshotsResponse200]:
+) -> Optional[Union[Error, ListBulkScreenshotsResponse200]]:
     """List bulk job items
 
      Returns the bulk job's items, discriminated by `type`.
@@ -280,7 +285,7 @@ async def asyncio(
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        ListBulkScreenshotsResponse200
+        Union[Error, ListBulkScreenshotsResponse200]
     """
 
     return (