Merge branch 'master' into turn-back-Apify-vale-rules

Author: TC-MO

.github/workflows/nginx.conf-test.yaml

@@ -9,7 +9,7 @@ jobs:
   nginx-test-job:
     runs-on: ubuntu-latest
     container:
-      image: docker.io/library/nginx:1.28.0-alpine-slim
+      image: docker.io/library/nginx:1.29.1-alpine-slim
     steps:
       - name: Checkout repository
         uses: actions/checkout@v5

apify-api/openapi/components/schemas/actors/UpdateActorRequest.yaml

@@ -50,3 +50,24 @@ properties:
     oneOf:
       - nullable: true
       - $ref: ./DefaultRunOptions.yaml
+  taggedBuilds:
+    type: object
+    description: |
+      Object containing the Actor's tagged builds, where the key is the tag name (e.g., _latest_) and the value is an object containing the build ID.
+      The object you provide will completely overwrite all existing tagged builds for the Actor.
+
+      - To create or reassign a tag: Include it in the object with the desired `buildId`.
+      - To remove a specific tag: Submit the object without that tag's key.
+      - To remove all tags: Provide an empty object: `{}`.
+      - If this field is omitted or `null`, the existing tags will not be changed.
+    nullable: true
+    additionalProperties:
+      type: object
+      required:
+        - buildId
+      properties:
+        buildId:
+          type: string
+    example:
+      latest:
+        buildId: z2EryhbfhgSyqj6Hn

apify-api/openapi/paths/actor-runs/actor-runs.yaml

@@ -12,7 +12,7 @@ get:
     By default, the records are sorted by the `startedAt` field in ascending
     order. Therefore, you can use pagination to incrementally fetch all records while
     new ones are still being created. To sort the records in descending order, use
-    `desc=1` parameter. You can also filter runs by status ([available
+    `desc=1` parameter. You can also filter runs by `startedAt`` and `status`` fields ([available
     statuses](https://docs.apify.com/platform/actors/running/runs-and-builds#lifecycle)).
   operationId: actorRuns_get
   parameters:
@@ -58,6 +58,28 @@ get:
       schema:
         type: string
         example: SUCCEEDED
+    - name: startedAfter
+      in: query
+      description: |
+        Filter runs that started after the specified date and time (inclusive).
+        The value must be a valid ISO 8601 datetime string (UTC).
+      style: form
+      explode: true
+      schema:
+        type: string
+        format: date-time
+        example: "2025-09-01T00:00:00.000Z"
+    - name: startedBefore
+      in: query
+      description: |
+        Filter runs that started before the specified date and time (inclusive).
+        The value must be a valid ISO 8601 datetime string (UTC).
+      style: form
+      explode: true
+      schema:
+        type: string
+        format: date-time
+        example: "2025-09-17T23:59:59.000Z"
   responses:
     # todo 404?
     '200':

apify-api/openapi/paths/actor-runs/actor-runs@{runId}@charge.yaml

@@ -7,6 +7,12 @@ post:
     The event you are charging for must be one of the configured events in your Actor. If the Actor is not set up as pay per event, or if the event is not configured,
     the endpoint will return an error. The endpoint must be called from the Actor run itself, with the same API token that the run was started with.
 
+    :::info Learn more about pay-per-event pricing
+
+    For more details about pay-per-event (PPE) pricing, refer to our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event).
+
+    :::
+
   operationId: PostChargeRun
   parameters:
     - name: runId

apify-api/openapi/paths/actors/acts@{actorId}@runs.yaml

@@ -66,6 +66,28 @@ get:
       schema:
         type: string
         example: SUCCEEDED
+    - name: startedAfter
+      in: query
+      description: |
+        Filter runs that started after the specified date and time (inclusive).
+        The value must be a valid ISO 8601 datetime string (UTC).
+      style: form
+      explode: true
+      schema:
+        type: string
+        format: date-time
+        example: "2025-09-01T00:00:00.000Z"
+    - name: startedBefore
+      in: query
+      description: |
+        Filter runs that started before the specified date and time (inclusive).
+        The value must be a valid ISO 8601 datetime string (UTC).
+      style: form
+      explode: true
+      schema:
+        type: string
+        format: date-time
+        example: "2025-09-17T23:59:59.000Z"
   responses:
     '200':
       description: ''

apify-api/openapi/paths/datasets/datasets@{datasetId}.yaml

@@ -5,6 +5,9 @@ get:
   description: |
     Returns dataset object for given dataset ID.
 
+    This does not return dataset items, only information about the storage itself.
+    To retrieve dataset items, use the [List dataset items](/api/v2/dataset-items-get) endpoint.
+
     :::note
 
     Keep in mind that attributes `itemCount` and `cleanItemCount` are not propagated right away after data are pushed into a dataset.

apify-api/openapi/paths/datasets/datasets@{datasetId}@items.yaml

@@ -367,6 +367,14 @@ get:
       schema:
         type: boolean
         example: false
+    - name: signature
+      in: query
+      description: Signature used to access the items.
+      required: false
+      style: simple
+      schema:
+        type: string
+        example: 2wTI46Bg8qWQrV7tavlPI
   responses:
     '200':
       description: ''

apify-api/openapi/paths/key-value-stores/key-value-stores@{storeId}@keys.yaml

@@ -48,6 +48,14 @@ get:
       schema:
         type: string
         example: post-images-
+    - name: signature
+      in: query
+      description: Signature used to access the keys.
+      required: false
+      style: simple
+      schema:
+        type: string
+        example: 2wTI46Bg8qWQrV7tavlPI
   responses:
     '200':
       description: ''

apify-api/openapi/paths/key-value-stores/key-value-stores@{storeId}@records@{recordKey}.yaml

@@ -32,6 +32,14 @@ get:
       schema:
         type: string
         example: someKey
+    - name: signature
+      in: query
+      description: Signature used to access the record.
+      required: false
+      style: simple
+      schema:
+        type: string
+        example: 2wTI46Bg8qWQrV7tavlPI
   responses:
     '200':
       description: ''

apify-api/plugins/decorators/client-references-links-decorator.js

@@ -34,8 +34,8 @@ function ClientReferencesLinksDecorator(target) {
     const pyLink = target[X_PY_DOC_URLS_PROPERTY];
     const jsLink = target[X_JS_DOC_URLS_PROPERTY];
 
-    const jsImgUrl = 'https://raw.githubusercontent.com/apify/openapi/b1206ac2adf8f39b05e5a09bf32c2802af58d851/assets/javascript.svg';
-    const pyImgUrl = 'https://raw.githubusercontent.com/apify/openapi/b1206ac2adf8f39b05e5a09bf32c2802af58d851/assets/python.svg';
+    const jsImgUrl = '/img/javascript-40x40.svg';
+    const pyImgUrl = '/img/python-40x40.svg';
 
     const jsAlt = 'Apify API JavaScript Client Reference';
     const pyAlt = 'Apify API Python Client Reference';
@@ -49,11 +49,13 @@ function ClientReferencesLinksDecorator(target) {
     }
 
     if (pyLink) {
-        prepend += `<a href="${pyLink}" target="_blank"><img src="${pyImgUrl}" class="openapi-clients-box-icon" alt="${pyAlt}"/></a>`;
+        prepend += `<a href="${pyLink}" target="_blank" class="client-docs-link">
+            <img src="${pyImgUrl}" class="openapi-clients-box-icon" width="24px" height="24px" alt="${pyAlt}"/>Python</a>`;
     }
 
     if (jsLink) {
-        prepend += `<a href="${jsLink}" target="_blank"><img src="${jsImgUrl}" class="openapi-clients-box-icon" alt="${jsAlt}" /></a>`;
+        prepend += `<a href="${jsLink}" target="_blank" class="client-docs-link">
+            <img src="${jsImgUrl}" class="openapi-clients-box-icon" width="24px" height="24px" alt="${jsAlt}" />JavaScript</a>`;
     }
 
     prepend += `</span>`;