docs: PPE docs improvements

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@{runId}@charge.yaml

@@ -7,6 +7,8 @@ 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.
 
+    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/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: ''