Add Last run related dataset endpoints

Author: Pijukatel

apify-api/openapi/components/objects/datasets/dataset-items.yaml

@@ -276,28 +276,20 @@ getDefault:
     - $ref: "../../parameters/datasetItemsParameters.yaml#/skipFailedPages"
     - $ref: "../../parameters/storageParameters.yaml#/signature"
 
-sharedHead: &sharedHead
-  responses:
-    "200":
-      description: ""
-      headers:
-        $ref: ../../headers/ApifyPaginationHeaders.yaml
-      content: {}
-    "400":
-      $ref: ../../responses/BadRequest.yaml
-  deprecated: false
-
-headById:
-  <<: *sharedHead
+getLastRun:
+  <<: *sharedGet
   tags:
-    - Storage/Datasets
-  summary: Get dataset items headers
+    - Last Actor run
+  summary: Get last run's dataset items
   description: |
-    Returns only the HTTP headers for the dataset items endpoint, without the response body.
-    This is useful to check pagination metadata or verify access without downloading the full dataset.
-  operationId: dataset_items_head
+    Returns data stored in the default dataset of the last Actor run in the desired format.
+
+    This endpoint is a shortcut that resolves the last run's `defaultDatasetId` and proxies to the
+    [Get dataset items](/api/v2/dataset-items-get) endpoint.
+  operationId: act_runs_last_dataset_items_get
   parameters:
-    - $ref: "../../parameters/storageParameters.yaml#/datasetId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
     - $ref: "../../parameters/datasetItemsParameters.yaml#/format"
     - $ref: "../../parameters/datasetItemsParameters.yaml#/clean"
     - $ref: "../../parameters/paginationParameters.yaml#/offset"
@@ -320,20 +312,25 @@ headById:
     - $ref: "../../parameters/datasetItemsParameters.yaml#/skipFailedPages"
     - $ref: "../../parameters/storageParameters.yaml#/signature"
 
-headDefault:
-  <<: *sharedHead
+headById:
+  responses:
+    "200":
+      description: ""
+      headers:
+        $ref: ../../headers/ApifyPaginationHeaders.yaml
+        content: {}
+    "400":
+      $ref: ../../responses/BadRequest.yaml
+  deprecated: false
   tags:
-    - Default storages
-  summary: Get default dataset items headers
+    - Storage/Datasets
+  summary: Get dataset items headers
   description: |
-    Returns only the HTTP headers for the dataset items endpoint of the Actor run's default dataset,
-    without the response body.
-
-    This endpoint is a shortcut for getting the run's `defaultDatasetId` and then using the
-    [Head dataset items](/api/v2/dataset-items-head) endpoint.
-  operationId: actorRun_dataset_items_head
+    Returns only the HTTP headers for the dataset items endpoint, without the response body.
+    This is useful to check pagination metadata or verify access without downloading the full dataset.
+  operationId: dataset_items_head
   parameters:
-    - $ref: "../../parameters/runAndBuildParameters.yaml#/runId"
+    - $ref: "../../parameters/storageParameters.yaml#/datasetId"
     - $ref: "../../parameters/datasetItemsParameters.yaml#/format"
     - $ref: "../../parameters/datasetItemsParameters.yaml#/clean"
     - $ref: "../../parameters/paginationParameters.yaml#/offset"
@@ -438,3 +435,19 @@ postDefault:
   operationId: actorRun_dataset_items_post
   parameters:
     - $ref: "../../parameters/runAndBuildParameters.yaml#/runId"
+
+postLastRun:
+  <<: *sharedPost
+  tags:
+    - Last Actor run
+  summary: Store items in last run's dataset
+  description: |
+    Appends an item or an array of items to the end of the last Actor run's default dataset.
+
+    This endpoint is a shortcut that resolves the last run's `defaultDatasetId` and proxies to the
+    [Store items](/api/v2/dataset-items-post) endpoint.
+
+  operationId: act_runs_last_dataset_items_post
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"

apify-api/openapi/components/objects/datasets/dataset-statistics.yaml

@@ -46,3 +46,18 @@ getDefault:
   operationId: actorRun_dataset_statistics_get
   parameters:
     - $ref: "../../parameters/runAndBuildParameters.yaml#/runId"
+
+getLastRun:
+  <<: *sharedGet
+  tags:
+    - Last Actor run
+  summary: Get last run's dataset statistics
+  description: |
+    Returns statistics for the last Actor run's default dataset.
+
+    This endpoint is a shortcut that resolves the last run's `defaultDatasetId` and proxies to the
+    [Get dataset statistics](/api/v2/dataset-statistics-get) endpoint.
+  operationId: act_runs_last_dataset_statistics_get
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"

apify-api/openapi/components/objects/datasets/dataset.yaml

@@ -80,6 +80,21 @@ getDefault:
   parameters:
     - $ref: "../../parameters/runAndBuildParameters.yaml#/runId"
 
+getLastRun:
+  <<: *sharedGet
+  tags:
+    - Last Actor run
+  summary: Get last run's default dataset
+  description: |
+    Returns the default dataset associated with the last Actor run.
+
+    This endpoint is a shortcut for getting the last run's `defaultDatasetId` and then using the
+    [Get dataset](/api/v2/dataset-get) endpoint.
+  operationId: act_runs_last_dataset_get
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
+
 sharedPut: &sharedPut
   requestBody:
     description: ""
@@ -141,6 +156,21 @@ putDefault:
   parameters:
     - $ref: "../../parameters/runAndBuildParameters.yaml#/runId"
 
+putLastRun:
+  <<: *sharedPut
+  tags:
+    - Last Actor run
+  summary: Update last run's default dataset
+  description: |
+    Updates the default dataset associated with the last Actor run.
+
+    This endpoint is a shortcut for getting the last run's `defaultDatasetId` and then using the
+    [Update dataset](/api/v2/dataset-put) endpoint.
+  operationId: act_runs_last_dataset_put
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
+
 sharedDelete: &sharedDelete
   responses:
     <<: *commonErrors
@@ -170,7 +200,26 @@ deleteDefault:
   tags:
     - Default storages
   summary: Delete default dataset
-  description: Deletes default dataset associated with an Actor run.
+  description: |
+    Deletes default dataset associated with an Actor run.
+
+    This endpoint is a shortcut for getting the last run's `defaultDatasetId` and then using the
+    [ Delete dataset ](/api/v2/dataset-delete) endpoint.
   operationId: actorRun_dataset_delete
   parameters:
     - $ref: "../../parameters/runAndBuildParameters.yaml#/runId"
+
+deleteLastRun:
+  <<: *sharedDelete
+  tags:
+    - Last Actor run
+  summary: Delete last run's default dataset
+  description: |
+    Deletes the default dataset associated with the last Actor run.
+
+    This endpoint is a shortcut for getting the last run's `defaultDatasetId` and then using the
+    [Delete dataset](/api/v2/dataset-delete) endpoint.
+  operationId: act_runs_last_dataset_delete
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"

apify-api/openapi/components/tags.yaml

@@ -431,3 +431,7 @@
   x-displayName: Default storages - Introduction
   description: |
     The API endpoints described in this section are convenience endpoints that provide access to Actor run's default storages (dataset, key-value store, and request queue) without the need to resolve the storage ID first.
+- name: Last Actor run
+  x-displayName: Last Actor run - Introduction
+  description: |
+    The API endpoints described in this section are convenience endpoints that provide access to Actor's last run and all it's sub resources without the need to resolve the run ID first.

apify-api/openapi/components/x-tag-groups.yaml

@@ -44,3 +44,4 @@
 - name: Convenience endpoints
   tags:
     - Default storages
+    - Last Actor run

apify-api/openapi/openapi.yaml

@@ -514,6 +514,12 @@ paths:
     $ref: "paths/actors/acts@{actorId}@runs@{runId}@resurrect.yaml"
   "/v2/acts/{actorId}/runs/last":
     $ref: "paths/actors/acts@{actorId}@runs@last.yaml"
+  "/v2/acts/{actorId}/runs/last/dataset":
+    $ref: "paths/actors/acts@{actorId}@runs@last@dataset.yaml"
+  "/v2/acts/{actorId}/runs/last/dataset/items":
+    $ref: "paths/actors/acts@{actorId}@runs@last@dataset@items.yaml"
+  "/v2/acts/{actorId}/runs/last/dataset/statistics":
+    $ref: "paths/actors/acts@{actorId}@runs@last@dataset@statistics.yaml"
   "/v2/acts/{actorId}/runs/{runId}":
     $ref: "paths/actors/acts@{actorId}@runs@{runId}.yaml"
   "/v2/acts/{actorId}/runs/{runId}/abort":

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

@@ -1,6 +1,4 @@
 get:
   $ref: "../../components/objects/datasets/dataset-items.yaml#/getDefault"
-head:
-  $ref: "../../components/objects/datasets/dataset-items.yaml#/headDefault"
 post:
   $ref: "../../components/objects/datasets/dataset-items.yaml#/postDefault"

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

@@ -0,0 +1,6 @@
+get:
+  $ref: "../../components/objects/datasets/dataset.yaml#/getLastRun"
+put:
+  $ref: "../../components/objects/datasets/dataset.yaml#/putLastRun"
+delete:
+  $ref: "../../components/objects/datasets/dataset.yaml#/deleteLastRun"

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

@@ -0,0 +1,4 @@
+get:
+  $ref: "../../components/objects/datasets/dataset-items.yaml#/getLastRun"
+post:
+  $ref: "../../components/objects/datasets/dataset-items.yaml#/postLastRun"

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

@@ -0,0 +1,2 @@
+get:
+  $ref: "../../components/objects/datasets/dataset-statistics.yaml#/getLastRun"