refactor: remove type mentions from parameter docstrings

Types are already specified in type hints, so docstrings should not
redundantly mention them.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: vdusek

src/apify_client/_internal_models.py

@@ -52,7 +52,7 @@ class WebhookRepresentationList(RootModel[list[WebhookRepresentation]]):
 
     @classmethod
     def from_webhooks(cls, webhooks: list[dict | WebhookCreate]) -> WebhookRepresentationList:
-        """Construct from a list of webhook dictionaries or `WebhookCreate` models."""
+        """Construct from a list of webhook dictionaries."""
         representations = []
         for webhook in webhooks:
             webhook_dict = webhook.model_dump(exclude_none=True) if isinstance(webhook, WebhookCreate) else webhook
@@ -74,11 +74,11 @@ def encode_to_base64(cls, webhooks: list[dict | WebhookCreate]) -> str: ...
 
     @classmethod
     def encode_to_base64(cls, webhooks: list[dict | WebhookCreate] | None) -> str | None:
-        """Encode a list of webhook dictionaries or `WebhookCreate` models to base64 for API transmission.
+        """Encode a list of webhooks to base64 for API transmission.
 
         Args:
-            webhooks: A list of webhook dictionaries or `WebhookCreate` models with keys like
-                `event_types`, `request_url`, etc. If None, returns None.
+            webhooks: A list of webhooks with keys like `event_types`, `request_url`, etc.
+                If None, returns None.
 
         Returns:
             A base64-encoded JSON string, or None if webhooks is None.

src/apify_client/_resource_clients/actor.py

@@ -252,7 +252,7 @@ def start(
             webhooks: Optional ad-hoc webhooks (https://docs.apify.com/webhooks/ad-hoc-webhooks) associated with
                 the Actor run which can be used to receive a notification, e.g. when the Actor finished or failed.
                 If you already have a webhook set up for the Actor or task, you do not have to add it again here.
-                Each webhook is represented by a dictionary or `WebhookCreate` model containing these items:
+                Each webhook is represented by a dictionary containing these items:
                     * `event_types`: List of `WebhookEventType` values which trigger the webhook.
                     * `request_url`: URL to which to send the webhook HTTP request.
                     * `payload_template`: Optional template for the request payload.
@@ -717,7 +717,7 @@ async def start(
             webhooks: Optional ad-hoc webhooks (https://docs.apify.com/webhooks/ad-hoc-webhooks) associated with
                 the Actor run which can be used to receive a notification, e.g. when the Actor finished or failed.
                 If you already have a webhook set up for the Actor or task, you do not have to add it again here.
-                Each webhook is represented by a dictionary or `WebhookCreate` model containing these items:
+                Each webhook is represented by a dictionary containing these items:
                     * `event_types`: List of `WebhookEventType` values which trigger the webhook.
                     * `request_url`: URL to which to send the webhook HTTP request.
                     * `payload_template`: Optional template for the request payload.

src/apify_client/_resource_clients/request_queue.py

@@ -172,7 +172,7 @@ def add_request(self, request: dict | RequestDraft, *, forefront: bool | None =
         https://docs.apify.com/api/v2#/reference/request-queues/request-collection/add-request
 
         Args:
-            request: The request to add to the queue, as a dictionary or `RequestDraft` model.
+            request: The request to add to the queue.
             forefront: Whether to add the request to the head or the end of the queue.
 
         Returns:
@@ -226,7 +226,7 @@ def update_request(self, request: dict | Request, *, forefront: bool | None = No
         https://docs.apify.com/api/v2#/reference/request-queues/request/update-request
 
         Args:
-            request: The updated request, as a dictionary or `Request` model.
+            request: The updated request.
             forefront: Whether to put the updated request in the beginning or the end of the queue.
 
         Returns:
@@ -335,7 +335,7 @@ def batch_add_requests(
         https://docs.apify.com/api/v2#/reference/request-queues/batch-request-operations/add-requests
 
         Args:
-            requests: List of requests to be added to the queue, each as a dictionary or `RequestDraft` model.
+            requests: List of requests to be added to the queue.
             forefront: Whether to add requests to the front of the queue.
             max_parallel: Specifies the maximum number of parallel tasks for API calls. This is only applicable
                 to the async client. For the sync client, this value must be set to 1, as parallel execution
@@ -411,7 +411,7 @@ def batch_delete_requests(self, requests: list[dict | RequestDraft]) -> BatchDel
         https://docs.apify.com/api/v2#/reference/request-queues/batch-request-operations/delete-requests
 
         Args:
-            requests: List of the requests to delete, each as a dictionary or `RequestDraft` model.
+            requests: List of the requests to delete.
         """
         requests_as_dicts: list[dict] = [
             (RequestDraft.model_validate(r) if isinstance(r, dict) else r).model_dump(by_alias=True, exclude_none=True)
@@ -602,7 +602,7 @@ async def add_request(self, request: dict | RequestDraft, *, forefront: bool | N
         https://docs.apify.com/api/v2#/reference/request-queues/request-collection/add-request
 
         Args:
-            request: The request to add to the queue, as a dictionary or `RequestDraft` model.
+            request: The request to add to the queue.
             forefront: Whether to add the request to the head or the end of the queue.
 
         Returns:
@@ -654,7 +654,7 @@ async def update_request(self, request: dict | Request, *, forefront: bool | Non
         https://docs.apify.com/api/v2#/reference/request-queues/request/update-request
 
         Args:
-            request: The updated request, as a dictionary or `Request` model.
+            request: The updated request.
             forefront: Whether to put the updated request in the beginning or the end of the queue.
 
         Returns:
@@ -813,7 +813,7 @@ async def batch_add_requests(
         https://docs.apify.com/api/v2#/reference/request-queues/batch-request-operations/add-requests
 
         Args:
-            requests: List of requests to be added to the queue, each as a dictionary or `RequestDraft` model.
+            requests: List of requests to be added to the queue.
             forefront: Whether to add requests to the front of the queue.
             max_parallel: Specifies the maximum number of parallel tasks for API calls. This is only applicable
                 to the async client. For the sync client, this value must be set to 1, as parallel execution
@@ -891,7 +891,7 @@ async def batch_delete_requests(self, requests: list[dict | RequestDraft]) -> Ba
         https://docs.apify.com/api/v2#/reference/request-queues/batch-request-operations/delete-requests
 
         Args:
-            requests: List of the requests to delete, each as a dictionary or `RequestDraft` model.
+            requests: List of the requests to delete.
         """
         requests_as_dicts: list[dict] = [
             (RequestDraft.model_validate(r) if isinstance(r, dict) else r).model_dump(by_alias=True, exclude_none=True)

src/apify_client/_resource_clients/task.py

@@ -101,7 +101,7 @@ def update(
                 in the task settings.
             restart_on_error: If true, the Task run process will be restarted whenever it exits with
                 a non-zero status code.
-            task_input: Task input dictionary or `TaskInput` model.
+            task_input: Task input dictionary.
             title: A human-friendly equivalent of the name.
             actor_standby_desired_requests_per_actor_run: The desired number of concurrent HTTP requests for
                 a single Actor Standby run.
@@ -164,7 +164,7 @@ def start(
         https://docs.apify.com/api/v2#/reference/actor-tasks/run-collection/run-task
 
         Args:
-            task_input: Task input dictionary or `TaskInput` model.
+            task_input: Task input dictionary.
             build: Specifies the Actor build to run. It can be either a build tag or build number. By default,
                 the run uses the build specified in the task settings (typically latest).
             max_items: Maximum number of results that will be returned by this run. If the Actor is charged
@@ -180,7 +180,7 @@ def start(
             webhooks: Optional ad-hoc webhooks (https://docs.apify.com/webhooks/ad-hoc-webhooks) associated with
                 the Actor run which can be used to receive a notification, e.g. when the Actor finished or failed.
                 If you already have a webhook set up for the Actor or task, you do not have to add it again here.
-                Each webhook is represented by a dictionary or `WebhookCreate` model containing these items:
+                Each webhook is represented by a dictionary containing these items:
                     * `event_types`: List of `WebhookEventType` values which trigger the webhook.
                     * `request_url`: URL to which to send the webhook HTTP request.
                     * `payload_template`: Optional template for the request payload.
@@ -231,7 +231,7 @@ def call(
         https://docs.apify.com/api/v2#/reference/actor-tasks/run-collection/run-task
 
         Args:
-            task_input: Task input dictionary or `TaskInput` model.
+            task_input: Task input dictionary.
             build: Specifies the Actor build to run. It can be either a build tag or build number. By default,
                 the run uses the build specified in the task settings (typically latest).
             max_items: Maximum number of results that will be returned by this run. If the Actor is charged per result,
@@ -295,7 +295,7 @@ def update_input(self, *, task_input: dict | TaskInput) -> dict:
         https://docs.apify.com/api/v2#/reference/actor-tasks/task-input-object/update-task-input
 
         Args:
-            task_input: The new default input for this task, as a dictionary or `TaskInput` model.
+            task_input: The new default input for this task.
 
         Returns:
             The updated task input.
@@ -405,7 +405,7 @@ async def update(
                 in the task settings.
             restart_on_error: If true, the Task run process will be restarted whenever it exits with
                 a non-zero status code.
-            task_input: Task input dictionary or `TaskInput` model.
+            task_input: Task input dictionary.
             title: A human-friendly equivalent of the name.
             actor_standby_desired_requests_per_actor_run: The desired number of concurrent HTTP requests for
                 a single Actor Standby run.
@@ -468,7 +468,7 @@ async def start(
         https://docs.apify.com/api/v2#/reference/actor-tasks/run-collection/run-task
 
         Args:
-            task_input: Task input dictionary or `TaskInput` model.
+            task_input: Task input dictionary.
             build: Specifies the Actor build to run. It can be either a build tag or build number. By default,
                 the run uses the build specified in the task settings (typically latest).
             max_items: Maximum number of results that will be returned by this run. If the Actor is charged
@@ -484,7 +484,7 @@ async def start(
             webhooks: Optional ad-hoc webhooks (https://docs.apify.com/webhooks/ad-hoc-webhooks) associated with
                 the Actor run which can be used to receive a notification, e.g. when the Actor finished or failed.
                 If you already have a webhook set up for the Actor or task, you do not have to add it again here.
-                Each webhook is represented by a dictionary or `WebhookCreate` model containing these items:
+                Each webhook is represented by a dictionary containing these items:
                     * `event_types`: List of `WebhookEventType` values which trigger the webhook.
                     * `request_url`: URL to which to send the webhook HTTP request.
                     * `payload_template`: Optional template for the request payload.
@@ -535,7 +535,7 @@ async def call(
         https://docs.apify.com/api/v2#/reference/actor-tasks/run-collection/run-task
 
         Args:
-            task_input: Task input dictionary or `TaskInput` model.
+            task_input: Task input dictionary.
             build: Specifies the Actor build to run. It can be either a build tag or build number. By default,
                 the run uses the build specified in the task settings (typically latest).
             max_items: Maximum number of results that will be returned by this run. If the Actor is charged per result,
@@ -598,7 +598,7 @@ async def update_input(self, *, task_input: dict | TaskInput) -> dict:
         https://docs.apify.com/api/v2#/reference/actor-tasks/task-input-object/update-task-input
 
         Args:
-            task_input: The new default input for this task, as a dictionary or `TaskInput` model.
+            task_input: The new default input for this task.
 
         Returns:
             The updated task input.

src/apify_client/_resource_clients/task_collection.py

@@ -96,7 +96,7 @@ def create(
                 in the task settings.
             restart_on_error: If true, the Task run process will be restarted whenever it exits with
                 a non-zero status code.
-            task_input: Task input object, as a dictionary or `TaskInput` model.
+            task_input: Task input object.
             title: A human-friendly equivalent of the name.
             actor_standby_desired_requests_per_actor_run: The desired number of concurrent HTTP requests for
                 a single Actor Standby run.
@@ -213,7 +213,7 @@ async def create(
                 in the task settings.
             restart_on_error: If true, the Task run process will be restarted whenever it exits with
                 a non-zero status code.
-            task_input: Task input object, as a dictionary or `TaskInput` model.
+            task_input: Task input object.
             title: A human-friendly equivalent of the name.
             actor_standby_desired_requests_per_actor_run: The desired number of concurrent HTTP requests for
                 a single Actor Standby run.