Merge remote-tracking branch 'origin/feat/better-llms' into feat/better-llms

Author: HonzaTuron

.vale.ini

@@ -1,6 +1,6 @@
 StylesPath = .github/styles
 MinAlertLevel = warning
-IgnoredScopes = code, tt, table, tr, td
+IgnoredScopes = code, tt, table, tr, td, frontmatter
 
 Vocab = Docs
 

apify-api/openapi/components/schemas/datasets/Dataset.yaml

@@ -69,5 +69,13 @@ properties:
   consoleUrl:
     type: string
     example: 'https://console.apify.com/storage/datasets/27TmTznX9YPeAYhkC'
+  itemsPublicUrl:
+    type: string
+    description: "A public link to access the dataset items directly."
+    example: 'https://api.apify.com/v2/datasets/WkzbQMuFYuamGv3YF/items?signature=abc123'
+  urlSigningSecretKey:
+    type: string
+    description: "A secret key for generating signed public URLs. It is only provided to clients with WRITE permission for the dataset."
+    nullable: true
   stats:
     $ref: ./DatasetStats.yaml

apify-api/openapi/components/schemas/key-value-stores/KeyValueStore.yaml

@@ -6,6 +6,7 @@ required:
   - modifiedAt
   - accessedAt
   - consoleUrl
+  - keysPublicUrl
 type: object
 properties:
   id:
@@ -42,5 +43,13 @@ properties:
   consoleUrl:
     type: string
     example: 'https://console.apify.com/storage/key-value-stores/27TmTznX9YPeAYhkC'  
+  keysPublicUrl:
+    type: string
+    description: "A public link to access keys of the key-value store directly."
+    example: 'https://api.apify.com/v2/key-value-stores/WkzbQMuFYuamGv3YF/keys?signature=abc123'
+  urlSigningSecretKey:
+    type: string
+    description: "A secret key for generating signed public URLs. It is only provided to clients with WRITE permission for the key-value store."
+    nullable: true
   stats:
     $ref: ./KeyValueStoreStats.yaml

apify-api/openapi/components/schemas/key-value-stores/ListOfKeysResponse.yaml

@@ -14,13 +14,18 @@ properties:
       required:
         - key
         - size
+        - recordPublicUrl
       properties:
         key:
           type: string
           example: second-key
         size:
           type: number
           example: 36
+        recordPublicUrl:
+          type: string
+          description: "A public link to access this record directly."
+          example: 'https://api.apify.com/v2/key-value-stores/WkzbQMuFYuamGv3YF/records/some-key?signature=abc123'
     description: ''
   count:
     type: number

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

@@ -51,8 +51,8 @@ get:
     - name: status
       in: query
       description: |
-        Return only runs with the provided status ([available
-        statuses](https://docs.apify.com/platform/actors/running/runs-and-builds#lifecycle))
+        Single status or comma-separated list of statuses, see ([available
+        statuses](https://docs.apify.com/platform/actors/running/runs-and-builds#lifecycle)). Used to filter runs by the specified statuses only.
       style: form
       explode: true
       schema:

apify-api/openapi/paths/actor-tasks/actor-tasks@{actorTaskId}@runs.yaml

@@ -57,8 +57,8 @@ get:
     - name: status
       in: query
       description: |
-        Return only runs with the provided status ([available
-        statuses](https://docs.apify.com/platform/actors/running/runs-and-builds#lifecycle))
+        Single status or comma-separated list of statuses, see ([available
+        statuses](https://docs.apify.com/platform/actors/running/runs-and-builds#lifecycle)). Used to filter runs by the specified statuses only.
       style: form
       explode: true
       schema:

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

@@ -59,8 +59,8 @@ get:
     - name: status
       in: query
       description: |
-        Return only runs with the provided status ([available
-        statuses](https://docs.apify.com/platform/actors/running/runs-and-builds#lifecycle))
+        Single status or comma-separated list of statuses, see ([available
+        statuses](https://docs.apify.com/platform/actors/running/runs-and-builds#lifecycle)). Used to filter runs by the specified statuses only.
       style: form
       explode: true
       schema:

sources/platform/actors/publishing/monetize.mdx

@@ -98,6 +98,15 @@ where:
 
 Only paid user activity is included in profit calculations.
 
+:::note Negative profit isolation
+
+An Actor's negative net profit does not affect the positive profit of another Actor. For aggregation purposes, any Actor with a negative net profit is considered to have a profit of $0.
+
+- _Previously:_ `Total Profit = (-$90) + $100 = $10`
+- _Now:_ `Total Profit = $0 + $100 = $100`
+
+:::
+
 #### How to set pricing for PPE
 
 1. _Understand your costs_: Analyze resource usage (e.g CPU, memory, proxies, external APIs) and identify cost drivers