From 25451525b8c71e8c0c68b3fe776d19eac30833c2 Mon Sep 17 00:00:00 2001 From: Jan Buchar Date: Wed, 14 Jan 2026 12:11:56 +0100 Subject: [PATCH 1/5] Simplify nullable fields --- .../openapi/components/schemas/actor-runs/Run.yaml | 14 ++++---------- 1 file changed, 4 insertions(+), 10 deletions(-) diff --git a/apify-api/openapi/components/schemas/actor-runs/Run.yaml b/apify-api/openapi/components/schemas/actor-runs/Run.yaml index c9b5c78c71..e9d32465dd 100644 --- a/apify-api/openapi/components/schemas/actor-runs/Run.yaml +++ b/apify-api/openapi/components/schemas/actor-runs/Run.yaml @@ -93,18 +93,12 @@ properties: nullable: true example: master usage: - allOf: - - oneOf: - - nullable: true - - $ref: ./RunUsage.yaml - - {} + nullable: true + $ref: ./RunUsage.yaml usageTotalUsd: type: number nullable: true example: 0.2654 usageUsd: - allOf: - - oneOf: - - nullable: true - - $ref: ./RunUsage.yaml - - {} + nullable: true + $ref: ./RunUsage.yaml From e549938ac97ff8188893a95d9ea63cebd7412bf3 Mon Sep 17 00:00:00 2001 From: Jan Buchar Date: Wed, 14 Jan 2026 12:25:35 +0100 Subject: [PATCH 2/5] feat: Better describe the circumstances under which run usage infor is included in API responses --- apify-api/openapi/components/schemas/actor-runs/Run.yaml | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/apify-api/openapi/components/schemas/actor-runs/Run.yaml b/apify-api/openapi/components/schemas/actor-runs/Run.yaml index e9d32465dd..437856654b 100644 --- a/apify-api/openapi/components/schemas/actor-runs/Run.yaml +++ b/apify-api/openapi/components/schemas/actor-runs/Run.yaml @@ -98,7 +98,16 @@ properties: usageTotalUsd: type: number nullable: true + description: >- + Total cost in USD for this run. Represents what you actually pay. + For run owners: includes platform usage (compute units) and/or event costs depending on the Actor's pricing model. + For non-owners: only available for Pay-Per-Event actors (event costs only). + Not available for Pay-Per-Result actors when you're not the Actor owner. example: 0.2654 usageUsd: nullable: true + description: >- + Platform usage costs breakdown in USD. Only present if you own the run AND are paying for platform usage + (Pay-Per-Usage, Rental, or Pay-Per-Event with usage costs like standby Actors). + Not available for standard Pay-Per-Event actors or Pay-Per-Result actors owned by others. $ref: ./RunUsage.yaml From d92e3f19aedb6c2ff1d5b89efa9ee209c4fae0e9 Mon Sep 17 00:00:00 2001 From: Jan Buchar Date: Wed, 14 Jan 2026 17:17:21 +0100 Subject: [PATCH 3/5] Update apify-api/openapi/components/schemas/actor-runs/Run.yaml MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Zuzana Štětinová <40138689+stetizu1@users.noreply.github.com> --- apify-api/openapi/components/schemas/actor-runs/Run.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apify-api/openapi/components/schemas/actor-runs/Run.yaml b/apify-api/openapi/components/schemas/actor-runs/Run.yaml index 437856654b..cbc5e4176a 100644 --- a/apify-api/openapi/components/schemas/actor-runs/Run.yaml +++ b/apify-api/openapi/components/schemas/actor-runs/Run.yaml @@ -102,7 +102,7 @@ properties: Total cost in USD for this run. Represents what you actually pay. For run owners: includes platform usage (compute units) and/or event costs depending on the Actor's pricing model. For non-owners: only available for Pay-Per-Event actors (event costs only). - Not available for Pay-Per-Result actors when you're not the Actor owner. + Not available for Pay-Per-Result Actors when you're not the Actor owner. example: 0.2654 usageUsd: nullable: true From c2af22a24e592b171e142ac77bf6a19f2b74933c Mon Sep 17 00:00:00 2001 From: Jan Buchar Date: Wed, 14 Jan 2026 17:17:31 +0100 Subject: [PATCH 4/5] Update apify-api/openapi/components/schemas/actor-runs/Run.yaml MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Zuzana Štětinová <40138689+stetizu1@users.noreply.github.com> --- apify-api/openapi/components/schemas/actor-runs/Run.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apify-api/openapi/components/schemas/actor-runs/Run.yaml b/apify-api/openapi/components/schemas/actor-runs/Run.yaml index cbc5e4176a..63cce40037 100644 --- a/apify-api/openapi/components/schemas/actor-runs/Run.yaml +++ b/apify-api/openapi/components/schemas/actor-runs/Run.yaml @@ -109,5 +109,5 @@ properties: description: >- Platform usage costs breakdown in USD. Only present if you own the run AND are paying for platform usage (Pay-Per-Usage, Rental, or Pay-Per-Event with usage costs like standby Actors). - Not available for standard Pay-Per-Event actors or Pay-Per-Result actors owned by others. + Not available for standard Pay-Per-Event Actors or Pay-Per-Result Actors owned by others. $ref: ./RunUsage.yaml From 9fb19a29834b724332d652ae643745fb8db37790 Mon Sep 17 00:00:00 2001 From: Jan Buchar Date: Thu, 15 Jan 2026 09:22:06 +0100 Subject: [PATCH 5/5] Update apify-api/openapi/components/schemas/actor-runs/Run.yaml MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: František Nesveda --- apify-api/openapi/components/schemas/actor-runs/Run.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apify-api/openapi/components/schemas/actor-runs/Run.yaml b/apify-api/openapi/components/schemas/actor-runs/Run.yaml index 63cce40037..88f4790290 100644 --- a/apify-api/openapi/components/schemas/actor-runs/Run.yaml +++ b/apify-api/openapi/components/schemas/actor-runs/Run.yaml @@ -101,7 +101,7 @@ properties: description: >- Total cost in USD for this run. Represents what you actually pay. For run owners: includes platform usage (compute units) and/or event costs depending on the Actor's pricing model. - For non-owners: only available for Pay-Per-Event actors (event costs only). + For non-owners: only available for Pay-Per-Event Actors (event costs only). Not available for Pay-Per-Result Actors when you're not the Actor owner. example: 0.2654 usageUsd: