retab 0.0.41__tar.gz → 0.0.42__tar.gz

retab-0.0.42/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.1
+Name: retab
+Version: 0.0.42
+Summary: Retab official python library
+Home-page: https://github.com/Retab-dev/retab
+Author: Retab
+Author-email: contact@retab.com
+Project-URL: Team website, https://retab.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Intended Audience :: Science/Research
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: Pillow
+Requires-Dist: httpx
+Requires-Dist: pydantic
+Requires-Dist: pydantic_core
+Requires-Dist: requests
+Requires-Dist: tqdm
+Requires-Dist: types-tqdm
+Requires-Dist: backoff
+Requires-Dist: termplotlib
+Requires-Dist: Levenshtein
+Requires-Dist: pandas
+Requires-Dist: numpy
+Requires-Dist: motor
+Requires-Dist: rich
+Requires-Dist: puremagic
+Requires-Dist: pycountry
+Requires-Dist: phonenumbers
+Requires-Dist: email_validator
+Requires-Dist: python-stdnum
+Requires-Dist: nanoid
+Requires-Dist: openai
+Requires-Dist: google-genai
+Requires-Dist: google-generativeai
+Requires-Dist: anthropic
+Requires-Dist: tiktoken
+Requires-Dist: truststore
+Requires-Dist: ruff
+
+# Retab
+
+<div align="center" style="margin-bottom: 1em;">
+
+<img src="https://raw.githubusercontent.com/Retab-dev/retab/refs/heads/main/assets/retab-logo.png" alt="Retab Logo" width="150">
+
+
+  *The AI Automation Platform*
+
+Made with love by the team at [Retab](https://retab.com) 🤍.
+
+[Our Website](https://retab.com) | [Documentation](https://docs.retab.com/get-started/introduction) | [Discord](https://discord.com/invite/vc5tWRPqag) | [Twitter](https://x.com/retabdev)
+
+
+</div>
+
+---
+
+### What is Retab?
+
+Retab solves all the major challenges in document processing with LLMs:
+
+1. **Universal Document Preprocessing**: Convert any file type (PDFs, Excel, emails, etc.) into LLM-ready format without writing custom parsers
+2. **Structured, Schema-driven Extraction**: Get consistent, reliable outputs using schema-based prompt engineering
+3. **Processors**: Publish a live, stable, shareable document processor.
+4. **Automations**: Create document processing workflows that can be triggered by events (mailbox, upload link, endpoint, outlook plugin).
+5. **Evaluations**: Evaluate the performance of models against annotated datasets
+6. **Optimizations**: Identify the most used processors and help you finetune models to reduce costs and improve performance
+
+We are offering you all the software-defined primitives to build your own document processing solutions. We see it as **Stripe** for document processing.
+
+Our goal is to make the process of analyzing documents and unstructured data as **easy** and **transparent** as possible.
+
+**A new, lighter paradigm**
+Large Language Models collapse entire layers of legacy OCR pipelines into a single, elegant abstraction. When a model can read, reason, and structure text natively, we no longer need brittle heuristics, handcrafted parsers, or heavyweight ETL jobs. Instead, we can expose a small, principled API: "give me the document, tell me the schema, and get back structured truth." Complexity evaporates, reliability rises, speed follows, and costs fall—because every component you remove is one that can no longer break. LLM‑first design lets us focus less on plumbing and more on the questions we actually want answered.
+
+Many people haven't yet realized how powerful LLMs have become at document processing tasks - we're here to help **unlock these capabilities**.
+
+---
+
+## Go further
+
+* [Quickstart](/get-started/quickstart)
+* [API Reference](/api-reference/introduction)
+
+---
+
+## Code examples
+
+## You can check our Github repository to see code examples: [python examples](https://github.com/Retab-dev/retab/tree/main/examples) and [jupyter notebooks](https://github.com/Retab-dev/retab-nodejs/tree/main/notebooks).
+
+## Community
+
+Let's create the future of document processing together!
+
+Join our [discord community](https://discord.com/invite/vc5tWRPqag) to share tips, discuss best practices, and showcase what you build. Or just [tweet](https://x.com/retabdev) at us.
+
+We can't wait to see how you'll use Retab.
+
+* [Discord](https://discord.com/invite/vc5tWRPqag)
+* [Twitter](https://x.com/retabdev)
+
+---
+
+## Roadmap
+
+We share our roadmap publicly on [Github](https://github.com/Retab-dev/retab)
+
+Among the features we're working on:
+
+* [ ] Node.js SDK
+* [ ] Low-level speed optimizations for Evals Frontend
+* [ ] Schema optimization autopilot
+* [ ] Sources API
+* [ ] Parse API for RAG
+

retab-0.0.42/README.md

@@ -0,0 +1,76 @@
+# Retab
+
+<div align="center" style="margin-bottom: 1em;">
+
+<img src="https://raw.githubusercontent.com/Retab-dev/retab/refs/heads/main/assets/retab-logo.png" alt="Retab Logo" width="150">
+
+
+  *The AI Automation Platform*
+
+Made with love by the team at [Retab](https://retab.com) 🤍.
+
+[Our Website](https://retab.com) | [Documentation](https://docs.retab.com/get-started/introduction) | [Discord](https://discord.com/invite/vc5tWRPqag) | [Twitter](https://x.com/retabdev)
+
+
+</div>
+
+---
+
+### What is Retab?
+
+Retab solves all the major challenges in document processing with LLMs:
+
+1. **Universal Document Preprocessing**: Convert any file type (PDFs, Excel, emails, etc.) into LLM-ready format without writing custom parsers
+2. **Structured, Schema-driven Extraction**: Get consistent, reliable outputs using schema-based prompt engineering
+3. **Processors**: Publish a live, stable, shareable document processor.
+4. **Automations**: Create document processing workflows that can be triggered by events (mailbox, upload link, endpoint, outlook plugin).
+5. **Evaluations**: Evaluate the performance of models against annotated datasets
+6. **Optimizations**: Identify the most used processors and help you finetune models to reduce costs and improve performance
+
+We are offering you all the software-defined primitives to build your own document processing solutions. We see it as **Stripe** for document processing.
+
+Our goal is to make the process of analyzing documents and unstructured data as **easy** and **transparent** as possible.
+
+**A new, lighter paradigm**
+Large Language Models collapse entire layers of legacy OCR pipelines into a single, elegant abstraction. When a model can read, reason, and structure text natively, we no longer need brittle heuristics, handcrafted parsers, or heavyweight ETL jobs. Instead, we can expose a small, principled API: "give me the document, tell me the schema, and get back structured truth." Complexity evaporates, reliability rises, speed follows, and costs fall—because every component you remove is one that can no longer break. LLM‑first design lets us focus less on plumbing and more on the questions we actually want answered.
+
+Many people haven't yet realized how powerful LLMs have become at document processing tasks - we're here to help **unlock these capabilities**.
+
+---
+
+## Go further
+
+* [Quickstart](/get-started/quickstart)
+* [API Reference](/api-reference/introduction)
+
+---
+
+## Code examples
+
+## You can check our Github repository to see code examples: [python examples](https://github.com/Retab-dev/retab/tree/main/examples) and [jupyter notebooks](https://github.com/Retab-dev/retab-nodejs/tree/main/notebooks).
+
+## Community
+
+Let's create the future of document processing together!
+
+Join our [discord community](https://discord.com/invite/vc5tWRPqag) to share tips, discuss best practices, and showcase what you build. Or just [tweet](https://x.com/retabdev) at us.
+
+We can't wait to see how you'll use Retab.
+
+* [Discord](https://discord.com/invite/vc5tWRPqag)
+* [Twitter](https://x.com/retabdev)
+
+---
+
+## Roadmap
+
+We share our roadmap publicly on [Github](https://github.com/Retab-dev/retab)
+
+Among the features we're working on:
+
+* [ ] Node.js SDK
+* [ ] Low-level speed optimizations for Evals Frontend
+* [ ] Schema optimization autopilot
+* [ ] Sources API
+* [ ] Parse API for RAG
+

{retab-0.0.41 → retab-0.0.42}/retab/client.py

@@ -34,7 +34,7 @@ class BaseRetab:
 
     Args:
         api_key (str, optional): Retab API key. If not provided, will look for RETAB_API_KEY env variable.
-        base_url (str, optional): Base URL for API requests. Defaults to https://api.retab.dev
+        base_url (str, optional): Base URL for API requests. Defaults to https://api.retab.com
         timeout (float): Request timeout in seconds. Defaults to 240.0
         max_retries (int): Maximum number of retries for failed requests. Defaults to 3
         openai_api_key (str, optional): OpenAI API key. Will look for OPENAI_API_KEY env variable if not provided
@@ -63,12 +63,12 @@ class BaseRetab:
 
         if api_key is None:
             raise ValueError(
-                "No API key provided. You can create an API key at https://retab.dev\n"
+                "No API key provided. You can create an API key at https://retab.com\n"
                 "Then either pass it to the client (api_key='your-key') or set the RETAB_API_KEY environment variable"
             )
 
         if base_url is None:
-            base_url = os.environ.get("RETAB_API_BASE_URL", "https://api.retab.dev")
+            base_url = os.environ.get("RETAB_API_BASE_URL", "https://api.retab.com")
 
         truststore.inject_into_ssl()
         self.api_key = api_key
@@ -154,7 +154,7 @@ class Retab(BaseRetab):
 
     Args:
         api_key (str, optional): Retab API key. If not provided, will look for RETAB_API_KEY env variable.
-        base_url (str, optional): Base URL for API requests. Defaults to https://api.retab.dev
+        base_url (str, optional): Base URL for API requests. Defaults to https://api.retab.com
         timeout (float): Request timeout in seconds. Defaults to 240.0
         max_retries (int): Maximum number of retries for failed requests. Defaults to 3
         openai_api_key (str, optional): OpenAI API key. Will look for OPENAI_API_KEY env variable if not provided
@@ -422,7 +422,7 @@ class AsyncRetab(BaseRetab):
 
     Args:
         api_key (str, optional): Retab API key. If not provided, will look for RETAB_API_KEY env variable.
-        base_url (str, optional): Base URL for API requests. Defaults to https://api.retab.dev
+        base_url (str, optional): Base URL for API requests. Defaults to https://api.retab.com
         timeout (float): Request timeout in seconds. Defaults to 240.0
         max_retries (int): Maximum number of retries for failed requests. Defaults to 3
         openai_api_key (str, optional): OpenAI API key. Will look for OPENAI_API_KEY env variable if not provided

{retab-0.0.41 → retab-0.0.42}/retab/resources/consensus/completions_stream.py

@@ -123,7 +123,7 @@ class Completions(SyncAPIResource, BaseCompletionsMixin):
 
         Usage:
         ```python
-        with retab.devpletions.stream(json_schema, messages, model, temperature, reasoning_effort) as stream:
+        with retab.completions.stream(json_schema, messages, model, temperature, reasoning_effort) as stream:
             for response in stream:
                 print(response)
         ```
@@ -210,7 +210,7 @@ class AsyncCompletions(AsyncAPIResource, BaseCompletionsMixin):
 
         Usage:
         ```python
-        async with retab.devpletions.stream(json_schema, messages, model, temperature, reasoning_effort, n_consensus) as stream:
+        async with retab.completions.stream(json_schema, messages, model, temperature, reasoning_effort, n_consensus) as stream:
             async for response in stream:
                 print(response)
         ```

{retab-0.0.41 → retab-0.0.42}/retab/resources/documents/client.py

@@ -17,6 +17,7 @@ from ...types.documents.parse import ParseRequest, ParseResult, TableParsingForm
 from ...types.browser_canvas import BrowserCanvas
 from ...types.mime import MIMEData
 from ...types.modalities import Modality
+from ...types.ai_models import LLMModel
 from ...types.schemas.object import Schema
 from ...types.standards import PreparedRequest
 from .extractions import AsyncExtractions, Extractions
@@ -89,7 +90,7 @@ class BaseDocumentsMixin:
     def _prepare_parse(
         self,
         document: Path | str | IOBase | MIMEData | PIL.Image.Image | HttpUrl,
-        fast_mode: bool = False,
+        model: LLMModel,
         table_parsing_format: TableParsingFormat = "html",
         image_resolution_dpi: int = 72,
         browser_canvas: BrowserCanvas = "A4",
@@ -99,7 +100,7 @@ class BaseDocumentsMixin:
 
         parse_request = ParseRequest(
             document=mime_document,
-            fast_mode=fast_mode,
+            model=model,
             table_parsing_format=table_parsing_format,
             image_resolution_dpi=image_resolution_dpi,
             browser_canvas=browser_canvas,
@@ -290,7 +291,7 @@ class Documents(SyncAPIResource, BaseDocumentsMixin):
     def parse(
         self,
         document: Path | str | IOBase | MIMEData | PIL.Image.Image | HttpUrl,
-        fast_mode: bool = False,
+        model: LLMModel,
         table_parsing_format: TableParsingFormat = "html",
         image_resolution_dpi: int = 72,
         browser_canvas: BrowserCanvas = "A4",
@@ -304,7 +305,7 @@ class Documents(SyncAPIResource, BaseDocumentsMixin):
 
         Args:
             document: The document to parse. Can be a file path (Path or str), file-like object, MIMEData, PIL Image, or URL.
-            fast_mode: Use fast mode for parsing (may reduce quality). Defaults to False.
+            model: The AI model to use for document parsing.
             table_parsing_format: Format for parsing tables. Options: "html", "json", "yaml", "markdown". Defaults to "html".
             image_resolution_dpi: DPI for image processing. Defaults to 72.
             browser_canvas: Canvas size for document rendering. Defaults to "A4".
@@ -318,7 +319,7 @@ class Documents(SyncAPIResource, BaseDocumentsMixin):
         """
         request = self._prepare_parse(
             document=document,
-            fast_mode=fast_mode,
+            model=model,
             table_parsing_format=table_parsing_format,
             image_resolution_dpi=image_resolution_dpi,
             browser_canvas=browser_canvas,
@@ -512,7 +513,7 @@ class AsyncDocuments(AsyncAPIResource, BaseDocumentsMixin):
     async def parse(
         self,
         document: Path | str | IOBase | MIMEData | PIL.Image.Image | HttpUrl,
-        fast_mode: bool = False,
+        model: LLMModel,
         table_parsing_format: TableParsingFormat = "html",
         image_resolution_dpi: int = 72,
         browser_canvas: BrowserCanvas = "A4",
@@ -526,7 +527,7 @@ class AsyncDocuments(AsyncAPIResource, BaseDocumentsMixin):
 
         Args:
             document: The document to parse. Can be a file path (Path or str), file-like object, MIMEData, PIL Image, or URL.
-            fast_mode: Use fast mode for parsing (may reduce quality). Defaults to False.
+            model: The AI model to use for document parsing.
             table_parsing_format: Format for parsing tables. Options: "html", "json", "yaml", "markdown". Defaults to "html".
             image_resolution_dpi: DPI for image processing. Defaults to 72.
             browser_canvas: Canvas size for document rendering. Defaults to "A4".
@@ -540,7 +541,7 @@ class AsyncDocuments(AsyncAPIResource, BaseDocumentsMixin):
         """
         request = self._prepare_parse(
             document=document,
-            fast_mode=fast_mode,
+            model=model,
             table_parsing_format=table_parsing_format,
             image_resolution_dpi=image_resolution_dpi,
             browser_canvas=browser_canvas,

{retab-0.0.41 → retab-0.0.42}/retab/resources/processors/automations/endpoints.py

@@ -31,6 +31,7 @@ class EndpointsMixin:
 
     def prepare_list(
         self,
+        processor_id: str,
         before: Optional[str] = None,
         after: Optional[str] = None,
         limit: Optional[int] = 10,
@@ -40,6 +41,7 @@ class EndpointsMixin:
         webhook_url: Optional[str] = None,
     ) -> PreparedRequest:
         params = {
+            "processor_id": processor_id,
             "before": before,
             "after": after,
             "limit": limit,
@@ -120,11 +122,12 @@ class Endpoints(SyncAPIResource, EndpointsMixin):
             need_validation=need_validation,
         )
         response = self._client._prepared_request(request)
-        print(f"Endpoint Created. Url: https://www.retab.dev/dashboard/processors/automations/{response['id']}")
+        print(f"Endpoint Created. Url: https://www.retab.com/dashboard/processors/automations/{response['id']}")
         return Endpoint.model_validate(response)
 
     def list(
         self,
+        processor_id: str,
         before: Optional[str] = None,
         after: Optional[str] = None,
         limit: Optional[int] = 10,
@@ -145,7 +148,7 @@ class Endpoints(SyncAPIResource, EndpointsMixin):
         Returns:
             ListEndpoints: Paginated list of endpoint configurations with metadata
         """
-        request = self.prepare_list(before, after, limit, order, name, webhook_url)
+        request = self.prepare_list(processor_id, before, after, limit, order, name, webhook_url)
         response = self._client._prepared_request(request)
         return ListEndpoints.model_validate(response)
 
@@ -229,12 +232,13 @@ class AsyncEndpoints(AsyncAPIResource, EndpointsMixin):
             need_validation=need_validation,
         )
         response = await self._client._prepared_request(request)
-        print(f"Endpoint Created. Url: https://www.retab.dev/dashboard/processors/automations/{response['id']}")
+        print(f"Endpoint Created. Url: https://www.retab.com/dashboard/processors/automations/{response['id']}")
 
         return Endpoint.model_validate(response)
 
     async def list(
         self,
+        processor_id: str,
         before: Optional[str] = None,
         after: Optional[str] = None,
         limit: Optional[int] = 10,
@@ -242,7 +246,7 @@ class AsyncEndpoints(AsyncAPIResource, EndpointsMixin):
         name: Optional[str] = None,
         webhook_url: Optional[str] = None,
     ) -> ListEndpoints:
-        request = self.prepare_list(before, after, limit, order, name, webhook_url)
+        request = self.prepare_list(processor_id, before, after, limit, order, name, webhook_url)
         response = await self._client._prepared_request(request)
         return ListEndpoints.model_validate(response)
 

{retab-0.0.41 → retab-0.0.42}/retab/resources/processors/automations/links.py

@@ -128,7 +128,7 @@ class Links(SyncAPIResource, LinksMixin):
         )
         response = self._client._prepared_request(request)
 
-        print(f"Link Created. Url: https://www.retab.dev/dashboard/processors/automations/{response['id']}")
+        print(f"Link Created. Url: https://www.retab.com/dashboard/processors/automations/{response['id']}")
         return Link.model_validate(response)
 
     def list(
@@ -248,7 +248,7 @@ class AsyncLinks(AsyncAPIResource, LinksMixin):
             password=password,
         )
         response = await self._client._prepared_request(request)
-        print(f"Link Created. Url: https://www.retab.dev/dashboard/processors/automations/{response['id']}")
+        print(f"Link Created. Url: https://www.retab.com/dashboard/processors/automations/{response['id']}")
         return Link.model_validate(response)
 
     async def list(

{retab-0.0.41 → retab-0.0.42}/retab/resources/processors/automations/logs.py

@@ -147,7 +147,7 @@ class Logs(SyncAPIResource, LogsMixin):
         request = self.prepare_rerun(processor_id, log_id)
         response = self._client._prepared_request(request)
 
-        print(f"Webhook call run successfully. Log available at https://www.retab.dev/dashboard/processors/{processor_id}/logs/{log_id}")
+        print(f"Webhook call run successfully. Log available at https://www.retab.com/dashboard/processors/{processor_id}/logs/{log_id}")
 
         return ExternalRequestLog.model_validate(response)
 
@@ -217,6 +217,6 @@ class AsyncLogs(AsyncAPIResource, LogsMixin):
         request = self.prepare_rerun(processor_id, log_id)
         response = await self._client._prepared_request(request)
 
-        print(f"Webhook call run successfully. Log available at https://www.retab.dev/dashboard/processors/{processor_id}/logs/{log_id}")
+        print(f"Webhook call run successfully. Log available at https://www.retab.com/dashboard/processors/{processor_id}/logs/{log_id}")
 
         return ExternalRequestLog.model_validate(response)

{retab-0.0.41 → retab-0.0.42}/retab/resources/processors/automations/mailboxes.py

@@ -43,6 +43,7 @@ class MailBoxesMixin:
 
     def prepare_list(
         self,
+        processor_id: str,
         before: str | None = None,
         after: str | None = None,
         limit: int = 10,
@@ -52,6 +53,7 @@ class MailBoxesMixin:
         webhook_url: Optional[str] = None,
     ) -> PreparedRequest:
         params = {
+            "processor_id": processor_id,
             "before": before,
             "after": after,
             "limit": limit,
@@ -65,15 +67,12 @@ class MailBoxesMixin:
 
         return PreparedRequest(method="GET", url=self.mailboxes_base_url, params=params)
 
-    def prepare_get(self, email: str) -> PreparedRequest:
-        return PreparedRequest(method="GET", url=f"{self.mailboxes_base_url}/{email}")
-
-    def prepare_get_from_id(self, mailbox_id: str) -> PreparedRequest:
-        return PreparedRequest(method="GET", url=f"{self.mailboxes_base_url}/from_id/{mailbox_id}")
+    def prepare_get(self, mailbox_id: str) -> PreparedRequest:
+        return PreparedRequest(method="GET", url=f"{self.mailboxes_base_url}/{mailbox_id}")
 
     def prepare_update(
         self,
-        email: str,
+        mailbox_id: str,
         name: str = PydanticUndefined,  # type: ignore[assignment]
         default_language: str = PydanticUndefined,  # type: ignore[assignment]
         webhook_url: str = PydanticUndefined,  # type: ignore[assignment]
@@ -91,10 +90,10 @@ class MailBoxesMixin:
             authorized_domains=authorized_domains,
             authorized_emails=authorized_emails,
         )
-        return PreparedRequest(method="PUT", url=f"/v1/processors/automations/mailboxes/{email}", data=update_mailbox_request.model_dump(mode="json"))
+        return PreparedRequest(method="PUT", url=f"/v1/processors/automations/mailboxes/{mailbox_id}", data=update_mailbox_request.model_dump(mode="json"))
 
-    def prepare_delete(self, email: str) -> PreparedRequest:
-        return PreparedRequest(method="DELETE", url=f"/v1/processors/automations/mailboxes/{email}", raise_for_status=True)
+    def prepare_delete(self, mailbox_id: str) -> PreparedRequest:
+        return PreparedRequest(method="DELETE", url=f"/v1/processors/automations/mailboxes/{mailbox_id}", raise_for_status=True)
 
 
 class Mailboxes(SyncAPIResource, MailBoxesMixin):
@@ -144,12 +143,13 @@ class Mailboxes(SyncAPIResource, MailBoxesMixin):
         )
         response = self._client._prepared_request(request)
 
-        print(f"Mailbox {response['email']} created. Url: https://www.retab.dev/dashboard/processors/automations/{response['id']}")
+        print(f"Mailbox {response['email']} created. Url: https://www.retab.com/dashboard/processors/automations/{response['id']}")
 
         return Mailbox.model_validate(response)
 
     def list(
         self,
+        processor_id: str,
         before: str | None = None,
         after: str | None = None,
         limit: int = 10,
@@ -174,6 +174,7 @@ class Mailboxes(SyncAPIResource, MailBoxesMixin):
             ListMailboxes: List of mailbox configurations
         """
         request = self.prepare_list(
+            processor_id=processor_id,
             before=before,
             after=after,
             limit=limit,
@@ -185,22 +186,22 @@ class Mailboxes(SyncAPIResource, MailBoxesMixin):
         response = self._client._prepared_request(request)
         return ListMailboxes.model_validate(response)
 
-    def get(self, email: str) -> Mailbox:
+    def get(self, mailbox_id: str) -> Mailbox:
         """Get a specific email automation configuration.
 
         Args:
-            email: Email address of the mailbox
+            mailbox_id: ID of the mailbox
 
         Returns:
             Mailbox: The mailbox configuration
         """
-        request = self.prepare_get(email)
+        request = self.prepare_get(mailbox_id)
         response = self._client._prepared_request(request)
         return Mailbox.model_validate(response)
 
     def update(
         self,
-        email: str,
+        mailbox_id: str,
         name: str = PydanticUndefined,  # type: ignore[assignment]
         default_language: str = PydanticUndefined,  # type: ignore[assignment]
         webhook_url: str = PydanticUndefined,  # type: ignore[assignment]
@@ -225,7 +226,7 @@ class Mailboxes(SyncAPIResource, MailBoxesMixin):
             Mailbox: The updated mailbox configuration
         """
         request = self.prepare_update(
-            email=email,
+            mailbox_id=mailbox_id,
             name=name,
             default_language=default_language,
             webhook_url=webhook_url,
@@ -237,13 +238,13 @@ class Mailboxes(SyncAPIResource, MailBoxesMixin):
         response = self._client._prepared_request(request)
         return Mailbox.model_validate(response)
 
-    def delete(self, email: str) -> None:
+    def delete(self, mailbox_id: str) -> None:
         """Delete an email automation configuration.
 
         Args:
             email: Email address of the mailbox to delete
         """
-        request = self.prepare_delete(email)
+        request = self.prepare_delete(mailbox_id)
         self._client._prepared_request(request)
         return None
 
@@ -278,12 +279,13 @@ class AsyncMailboxes(AsyncAPIResource, MailBoxesMixin):
         )
         response = await self._client._prepared_request(request)
 
-        print(f"Mailbox {response['email']} created. Url: https://www.retab.dev/dashboard/processors/automations/{response['id']}")
+        print(f"Mailbox {response['email']} created. Url: https://www.retab.com/dashboard/processors/automations/{response['id']}")
 
         return Mailbox.model_validate(response)
 
     async def list(
         self,
+        processor_id: str,
         before: str | None = None,
         after: str | None = None,
         limit: int = 10,
@@ -292,18 +294,27 @@ class AsyncMailboxes(AsyncAPIResource, MailBoxesMixin):
         name: str | None = None,
         webhook_url: str | None = None,
     ) -> ListMailboxes:
-        request = self.prepare_list(before=before, after=after, limit=limit, order=order, email=email, name=name, webhook_url=webhook_url)
+        request = self.prepare_list(
+            processor_id=processor_id,
+            before=before,
+            after=after,
+            limit=limit,
+            order=order,
+            email=email,
+            name=name,
+            webhook_url=webhook_url,
+        )
         response = await self._client._prepared_request(request)
         return ListMailboxes.model_validate(response)
 
-    async def get(self, email: str) -> Mailbox:
-        request = self.prepare_get(email)
+    async def get(self, mailbox_id: str) -> Mailbox:
+        request = self.prepare_get(mailbox_id)
         response = await self._client._prepared_request(request)
         return Mailbox.model_validate(response)
 
     async def update(
         self,
-        email: str,
+        mailbox_id: str,
         name: str = PydanticUndefined,  # type: ignore[assignment]
         default_language: str = PydanticUndefined,  # type: ignore[assignment]
         webhook_url: str = PydanticUndefined,  # type: ignore[assignment]
@@ -313,7 +324,7 @@ class AsyncMailboxes(AsyncAPIResource, MailBoxesMixin):
         authorized_emails: List[str] = PydanticUndefined,  # type: ignore[assignment]
     ) -> Mailbox:
         request = self.prepare_update(
-            email=email,
+            mailbox_id=mailbox_id,
             name=name,
             default_language=default_language,
             webhook_url=webhook_url,
@@ -325,8 +336,8 @@ class AsyncMailboxes(AsyncAPIResource, MailBoxesMixin):
         response = await self._client._prepared_request(request)
         return Mailbox.model_validate(response)
 
-    async def delete(self, email: str) -> None:
-        request = self.prepare_delete(email)
+    async def delete(self, mailbox_id: str) -> None:
+        request = self.prepare_delete(mailbox_id)
         await self._client._prepared_request(request)
         return None
 
@@ -334,12 +345,12 @@ class AsyncMailboxes(AsyncAPIResource, MailBoxesMixin):
 class TestMailboxesMixin:
     def prepare_forward(
         self,
-        email: str,
+        mailbox_id: str,
         document: Path | str | IOBase | HttpUrl | MIMEData,
         verbose: bool = True,
     ) -> PreparedRequest:
         mime_document = prepare_mime_document(document)
-        return PreparedRequest(method="POST", url=f"/v1/processors/automations/mailboxes/tests/forward/{email}", data={"document": mime_document.model_dump()})
+        return PreparedRequest(method="POST", url=f"/v1/processors/automations/mailboxes/tests/forward/{mailbox_id}", data={"document": mime_document.model_dump()})
 
     def print_forward_verbose(self, email_data: EmailData) -> None:
         print("\nTEST EMAIL FORWARDING RESULTS:")
@@ -360,7 +371,7 @@ class TestMailboxesMixin:
 class TestMailboxes(SyncAPIResource, TestMailboxesMixin):
     def forward(
         self,
-        email: str,
+        mailbox_id: str,
         document: Path | str | IOBase | HttpUrl | MIMEData,
         verbose: bool = True,
     ) -> EmailData:
@@ -372,7 +383,7 @@ class TestMailboxes(SyncAPIResource, TestMailboxesMixin):
         Returns:
             DocumentExtractResponse: The simulated extraction response
         """
-        request = self.prepare_forward(email, document, verbose)
+        request = self.prepare_forward(mailbox_id, document, verbose)
         response = self._client._prepared_request(request)
 
         email_data = EmailData.model_validate(response)
@@ -385,11 +396,11 @@ class TestMailboxes(SyncAPIResource, TestMailboxesMixin):
 class AsyncTestMailboxes(AsyncAPIResource, TestMailboxesMixin):
     async def forward(
         self,
-        email: str,
+        mailbox_id: str,
         document: Path | str | IOBase | HttpUrl | MIMEData,
         verbose: bool = True,
     ) -> EmailData:
-        request = self.prepare_forward(email, document, verbose)
+        request = self.prepare_forward(mailbox_id, document, verbose)
         response = await self._client._prepared_request(request)
         email_data = EmailData.model_validate(response)
         if verbose: