docs(openapi): Add undocumented last task run endpoints (#2446)

### Description
- Add undocumented, but public API endpoints related to the last task
run
  - last Actor run dataset
  - last Actor run rq
  - last Actor run kvs
- Abstract reusable parts of nearly duplicate endpoints and use
references.
- Replace prose description of previously not properly documented
redispatch endpoints by links to their documentation.
(prose description is no longer needed, all redispatch endpoints have
their own pages)

### Issues
Partially implements: #2286

Author: Pijukatel

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

@@ -22,6 +22,10 @@ sharedTagLastRun: &sharedTagLastRun
   tags:
     - Last Actor run's default dataset
 
+sharedTagTaskLastRun: &sharedTagTaskLastRun
+  tags:
+    - Last Actor task run's default dataset
+
 parametersGetHeadById: &parametersGetHeadById
   parameters:
     - $ref: "../../parameters/datasetParameters.yaml#/datasetId"
@@ -320,6 +324,40 @@ getLastRun:
     - $ref: "../../parameters/datasetParameters.yaml#/skipFailedPages"
     - $ref: "../../parameters/storageParameters.yaml#/signature"
 
+getTaskLastRun:
+  <<: [*sharedGet, *sharedTagTaskLastRun]
+  summary: Get last task run's dataset items
+  description: |
+    Returns data stored in the default dataset of the last Actor task run in the desired format.
+
+    This endpoint is a shortcut that resolves the last task run's `defaultDatasetId` and proxies to the
+    [Get dataset items](/api/v2/dataset-items-get) endpoint.
+  operationId: actorTask_runs_last_dataset_items_get
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorTaskId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
+    - $ref: "../../parameters/datasetParameters.yaml#/format"
+    - $ref: "../../parameters/datasetParameters.yaml#/clean"
+    - $ref: "../../parameters/paginationParameters.yaml#/offset"
+    - $ref: "../../parameters/datasetParameters.yaml#/limit"
+    - $ref: "../../parameters/datasetParameters.yaml#/fields"
+    - $ref: "../../parameters/datasetParameters.yaml#/omit"
+    - $ref: "../../parameters/datasetParameters.yaml#/unwind"
+    - $ref: "../../parameters/datasetParameters.yaml#/flatten"
+    - $ref: "../../parameters/datasetParameters.yaml#/descDataset"
+    - $ref: "../../parameters/datasetParameters.yaml#/attachment"
+    - $ref: "../../parameters/datasetParameters.yaml#/delimiter"
+    - $ref: "../../parameters/datasetParameters.yaml#/bom"
+    - $ref: "../../parameters/datasetParameters.yaml#/xmlRoot"
+    - $ref: "../../parameters/datasetParameters.yaml#/xmlRow"
+    - $ref: "../../parameters/datasetParameters.yaml#/skipHeaderRow"
+    - $ref: "../../parameters/datasetParameters.yaml#/skipHidden"
+    - $ref: "../../parameters/datasetParameters.yaml#/skipEmpty"
+    - $ref: "../../parameters/datasetParameters.yaml#/simplified"
+    - $ref: "../../parameters/datasetParameters.yaml#/view"
+    - $ref: "../../parameters/datasetParameters.yaml#/skipFailedPages"
+    - $ref: "../../parameters/storageParameters.yaml#/signature"
+
 headById:
   <<: [*parametersGetHeadById, *sharedTagById]
   responses:
@@ -429,3 +467,17 @@ postLastRun:
   parameters:
     - $ref: "../../parameters/runAndBuildParameters.yaml#/actorId"
     - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
+
+postTaskLastRun:
+  <<: [*sharedPost, *sharedTagTaskLastRun]
+  summary: Store items in last task run's dataset
+  description: |
+    Appends an item or an array of items to the end of the last Actor task run's default dataset.
+
+    This endpoint is a shortcut that resolves the last task run's `defaultDatasetId` and proxies to the
+    [Store items](/api/v2/dataset-items-post) endpoint.
+
+  operationId: actorTask_runs_last_dataset_items_post
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorTaskId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"

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

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

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

@@ -40,6 +40,13 @@ sharedLastRun: &sharedLastRun
     - $ref: "../../parameters/runAndBuildParameters.yaml#/actorId"
     - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
 
+sharedTaskLastRun: &sharedTaskLastRun
+  tags:
+    - Last Actor task run's default dataset
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorTaskId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
+
 sharedGet: &sharedGet
   responses:
     <<: [*common200, *commonErrors]
@@ -94,6 +101,16 @@ getLastRun:
     [Get dataset](/api/v2/dataset-get) endpoint.
   operationId: act_runs_last_dataset_get
 
+getTaskLastRun:
+  <<: [*sharedGet, *sharedTaskLastRun]
+  summary: Get last task run's default dataset
+  description: |
+    Returns the default dataset associated with the last Actor task run.
+
+    This endpoint is a shortcut for getting the last task run's `defaultDatasetId` and then using the
+    [Get dataset](/api/v2/dataset-get) endpoint.
+  operationId: actorTask_runs_last_dataset_get
+
 sharedPut: &sharedPut
   requestBody:
     description: ""
@@ -150,6 +167,16 @@ putLastRun:
     [Update dataset](/api/v2/dataset-put) endpoint.
   operationId: act_runs_last_dataset_put
 
+putTaskLastRun:
+  <<: [*sharedPut, *sharedTaskLastRun]
+  summary: Update last task run's default dataset
+  description: |
+    Updates the default dataset associated with the last Actor task run.
+
+    This endpoint is a shortcut for getting the last task run's `defaultDatasetId` and then using the
+    [Update dataset](/api/v2/dataset-put) endpoint.
+  operationId: actorTask_runs_last_dataset_put
+
 sharedDelete: &sharedDelete
   responses:
     <<: *commonErrors
@@ -189,3 +216,13 @@ deleteLastRun:
     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
+
+deleteTaskLastRun:
+  <<: [*sharedDelete, *sharedTaskLastRun]
+  summary: Delete last task run's default dataset
+  description: |
+    Deletes the default dataset associated with the last Actor task run.
+
+    This endpoint is a shortcut for getting the last task run's `defaultDatasetId` and then using the
+    [Delete dataset](/api/v2/dataset-delete) endpoint.
+  operationId: actorTask_runs_last_dataset_delete

apify-api/openapi/components/objects/key-value-stores/key-value-store-keys.yaml

@@ -24,6 +24,10 @@ sharedTagLastRun: &sharedTagLastRun
   tags:
     - Last Actor run's default key-value store
 
+sharedTagTaskLastRun: &sharedTagTaskLastRun
+  tags:
+    - Last Actor task run's default key-value store
+
 sharedGet: &sharedGet
   responses:
     <<: *commonErrors
@@ -98,3 +102,21 @@ getLastRun:
     - $ref: "../../parameters/keyValueStoreParameters.yaml#/collectionKeys"
     - $ref: "../../parameters/keyValueStoreParameters.yaml#/prefixKeys"
     - $ref: "../../parameters/storageParameters.yaml#/signature"
+
+getTaskLastRun:
+  <<: [*sharedGet, *sharedTagTaskLastRun]
+  summary: Get last task run's default store's list of keys
+  description: |
+    Returns a list of keys for the default key-value store of the last Actor task run.
+
+    This endpoint is a shortcut for getting the last task run's `defaultKeyValueStoreId` and then using the
+    [Get list of keys](/api/v2/key-value-store-keys-get) endpoint.
+  operationId: actorTask_runs_last_keyValueStore_keys_get
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorTaskId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/exclusiveStartKey"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/limit"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/collectionKeys"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/prefixKeys"
+    - $ref: "../../parameters/storageParameters.yaml#/signature"

apify-api/openapi/components/objects/key-value-stores/key-value-store-record.yaml

@@ -24,6 +24,10 @@ sharedTagLastRun: &sharedTagLastRun
   tags:
     - Last Actor run's default key-value store
 
+sharedTagTaskLastRun: &sharedTagTaskLastRun
+  tags:
+    - Last Actor task run's default key-value store
+
 sharedGet: &sharedGet
   responses:
     <<: *commonErrors
@@ -156,6 +160,22 @@ getLastRun:
     - $ref: "../../parameters/storageParameters.yaml#/signature"
     - $ref: "../../parameters/keyValueStoreParameters.yaml#/attachment"
 
+getTaskLastRun:
+  <<: [*sharedGet, *sharedTagTaskLastRun]
+  summary: Get last task run's default store's record
+  description: |
+    Gets a value stored under a specific key in the default key-value store of the last Actor task run.
+
+    This endpoint is a shortcut for getting the last task run's `defaultKeyValueStoreId` and then using the
+    [Get record](/api/v2/key-value-store-record-get) endpoint.
+  operationId: actorTask_runs_last_keyValueStore_record_get
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorTaskId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/recordKey"
+    - $ref: "../../parameters/storageParameters.yaml#/signature"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/attachment"
+
 headById:
   <<: *sharedTagById
   summary: Check if a record exists
@@ -244,11 +264,27 @@ putLastRun:
     - $ref: "../../parameters/keyValueStoreParameters.yaml#/recordKey"
     - $ref: "../../parameters/keyValueStoreParameters.yaml#/Content-Encoding"
 
+putTaskLastRun:
+  <<: [*sharedPutPost, *sharedTagTaskLastRun]
+  summary: Store record in last task run's default store
+  description: |
+    Stores a value under a specific key in the default key-value store of the last Actor task run.
+
+    This endpoint is a shortcut for getting the last task run's `defaultKeyValueStoreId` and then using the
+    [Store record](/api/v2/key-value-store-record-put) endpoint.
+  operationId: actorTask_runs_last_keyValueStore_record_put
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorTaskId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/recordKey"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/Content-Encoding"
+
 postById:
   <<: [*sharedPutPost, *sharedTagById]
   summary: Store record (POST)
   description: |
     Stores a value under a specific key to the key-value store.
+
     This endpoint is an alias for the [`PUT` record](#tag/Key-value-storesRecord/operation/keyValueStore_record_put) method and behaves identically.
   operationId: keyValueStore_record_post
   parameters:
@@ -265,7 +301,6 @@ postDefault:
   summary: Store record in default store (POST)
   description: |
     Stores a value under a specific key in the default key-value store of the Actor run.
-    This endpoint is an alias for the [`PUT` record](/api/v2/key-value-store-record-put) method and behaves identically.
 
     This endpoint is a shortcut for getting the run's `defaultKeyValueStoreId` and then using the
     [Store record](/api/v2/key-value-store-record-post) endpoint.
@@ -280,7 +315,6 @@ postLastRun:
   summary: Store record in last run's default store (POST)
   description: |
     Stores a value under a specific key in the default key-value store of the last Actor run.
-    This endpoint is an alias for the [`PUT` record](/api/v2/act-runs-last-key-value-store-record-put) method and behaves identically.
 
     This endpoint is a shortcut for getting the last run's `defaultKeyValueStoreId` and then using the
     [Store record](/api/v2/key-value-store-record-post) endpoint.
@@ -291,6 +325,21 @@ postLastRun:
     - $ref: "../../parameters/keyValueStoreParameters.yaml#/recordKey"
     - $ref: "../../parameters/keyValueStoreParameters.yaml#/Content-Encoding"
 
+postTaskLastRun:
+  <<: [*sharedPutPost, *sharedTagTaskLastRun]
+  summary: Store record in last task run's default store (POST)
+  description: |
+    Stores a value under a specific key in the default key-value store of the last Actor task run.
+
+    This endpoint is a shortcut for getting the last task run's `defaultKeyValueStoreId` and then using the
+    [Store record](/api/v2/key-value-store-record-post) endpoint.
+  operationId: actorTask_runs_last_keyValueStore_record_post
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorTaskId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/recordKey"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/Content-Encoding"
+
 deleteById:
   <<: [*sharedDelete, *sharedTagById]
   summary: Delete record
@@ -336,3 +385,17 @@ deleteLastRun:
     - $ref: "../../parameters/runAndBuildParameters.yaml#/actorId"
     - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
     - $ref: "../../parameters/keyValueStoreParameters.yaml#/recordKey"
+
+deleteTaskLastRun:
+  <<: [*sharedDelete, *sharedTagTaskLastRun]
+  summary: Delete last task run's default store's record
+  description: |
+    Removes a record specified by a key from the default key-value store of the last Actor task run.
+
+    This endpoint is a shortcut for getting the last task run's `defaultKeyValueStoreId` and then using the
+    [Delete record](/api/v2/key-value-store-record-delete) endpoint.
+  operationId: actorTask_runs_last_keyValueStore_record_delete
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorTaskId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/recordKey"

apify-api/openapi/components/objects/key-value-stores/key-value-store-records.yaml

@@ -24,6 +24,10 @@ sharedTagLastRun: &sharedTagLastRun
   tags:
     - Last Actor run's default key-value store
 
+sharedTagTaskLastRun: &sharedTagTaskLastRun
+  tags:
+    - Last Actor task run's default key-value store
+
 common200: &common200
   "200":
     description: A ZIP archive containing the requested records.
@@ -85,6 +89,22 @@ getLastRun:
     - $ref: "../../parameters/keyValueStoreParameters.yaml#/prefixRecords"
     - $ref: "../../parameters/storageParameters.yaml#/signature"
 
+getTaskLastRun:
+  <<: [*sharedGet, *sharedTagTaskLastRun]
+  summary: Download last task run's default store's records
+  description: |
+    Downloads all records from the default key-value store of the last Actor task run as a ZIP archive.
+
+    This endpoint is a shortcut for getting the last task run's `defaultKeyValueStoreId` and then using the
+    [Download records](/api/v2/key-value-store-records-get) endpoint.
+  operationId: actorTask_runs_last_keyValueStore_records_get
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorTaskId"
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/statusLastRun"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/collectionRecords"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/prefixRecords"
+    - $ref: "../../parameters/storageParameters.yaml#/signature"
+
 sharedPutPost: &sharedPutPost
   requestBody:
     description: ""
@@ -241,3 +261,31 @@ postLastRun:
     - $ref: "../../parameters/runAndBuildParameters.yaml#/actorId"
     - $ref: "../../parameters/keyValueStoreParameters.yaml#/recordKey"
     - $ref: "../../parameters/keyValueStoreParameters.yaml#/Content-Encoding"
+
+putTaskLastRun:
+  <<: [*sharedPutPost, *sharedTagTaskLastRun]
+  summary: Store record in last task run's default store
+  description: |
+    Stores a value under a specific key to the default key-value store of the last Actor task run.
+
+    This endpoint is a shortcut for getting the last task run's `defaultKeyValueStoreId` and then using the
+    [PUT record](/api/v2/key-value-store-record-put) endpoint.
+  operationId: actorTask_runs_last_keyValueStore_records_put
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorTaskId"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/recordKey"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/Content-Encoding"
+
+postTaskLastRun:
+  <<: [*sharedPutPost, *sharedTagTaskLastRun]
+  summary: Store record in last task run's default store (POST)
+  description: |
+    Stores a value under a specific key to the default key-value store of the last Actor task run.
+
+    This endpoint is a shortcut for getting the last task run's `defaultKeyValueStoreId` and then using the
+    [POST record](/api/v2/key-value-store-record-post) endpoint.
+  operationId: actorTask_runs_last_keyValueStore_records_post
+  parameters:
+    - $ref: "../../parameters/runAndBuildParameters.yaml#/actorTaskId"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/recordKey"
+    - $ref: "../../parameters/keyValueStoreParameters.yaml#/Content-Encoding"