diff --git a/apify-api/openapi/components/objects/datasets/dataset-items.yaml b/apify-api/openapi/components/objects/datasets/dataset-items.yaml index a26310b90f..212a50d100 100644 --- a/apify-api/openapi/components/objects/datasets/dataset-items.yaml +++ b/apify-api/openapi/components/objects/datasets/dataset-items.yaml @@ -445,9 +445,18 @@ postById: For more information about dataset schema validation, see [Dataset schema](https://docs.apify.com/platform/actors/development/actor-definition/dataset-schema/validation). **IMPORTANT:** The limit of request payload size for the dataset is 5 MB. If the array exceeds the size, you'll need to split it into a number of smaller arrays. + + To save bandwidth and speed up your upload, you can send the request payload compressed and set the `Content-Encoding` header accordingly. + + Below is a list of supported `Content-Encoding` types. + + * Brotli: `Content-Encoding: br` + * Gzip: `Content-Encoding: gzip` + * Deflate: `Content-Encoding: deflate` operationId: dataset_items_post parameters: - $ref: "../../parameters/datasetParameters.yaml#/datasetId" + - $ref: "../../parameters/keyValueStoreParameters.yaml#/Content-Encoding" x-legacy-doc-urls: - https://docs.apify.com/api/v2#/reference/datasets/item-collection/put-items - https://docs.apify.com/api/v2#/reference/datasets/put-items @@ -468,9 +477,17 @@ postDefault: This endpoint is a shortcut that resolves the run's `defaultDatasetId` and proxies to the [Store items](/api/v2/dataset-items-post) endpoint. + To save bandwidth and speed up your upload, you can send the request payload compressed and set the `Content-Encoding` header accordingly. + + Below is a list of supported `Content-Encoding` types. + + * Brotli: `Content-Encoding: br` + * Gzip: `Content-Encoding: gzip` + * Deflate: `Content-Encoding: deflate` operationId: actorRun_dataset_items_post parameters: - $ref: "../../parameters/runAndBuildParameters.yaml#/runId" + - $ref: "../../parameters/keyValueStoreParameters.yaml#/Content-Encoding" postLastRun: <<: [*sharedPost, *sharedTagLastRun] @@ -481,11 +498,19 @@ postLastRun: This endpoint is a shortcut that resolves the last run's `defaultDatasetId` and proxies to the [Store items](/api/v2/dataset-items-post) endpoint. + To save bandwidth and speed up your upload, you can send the request payload compressed and set the `Content-Encoding` header accordingly. + + Below is a list of supported `Content-Encoding` types. + + * Brotli: `Content-Encoding: br` + * Gzip: `Content-Encoding: gzip` + * Deflate: `Content-Encoding: deflate` operationId: act_runs_last_dataset_items_post parameters: - $ref: "../../parameters/runAndBuildParameters.yaml#/actorId" - $ref: "../../parameters/lastRunParameters.yaml#/status" - $ref: "../../parameters/lastRunParameters.yaml#/origin" + - $ref: "../../parameters/keyValueStoreParameters.yaml#/Content-Encoding" postTaskLastRun: <<: [*sharedPost, *sharedTagTaskLastRun] @@ -496,8 +521,16 @@ postTaskLastRun: 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. + To save bandwidth and speed up your upload, you can send the request payload compressed and set the `Content-Encoding` header accordingly. + + Below is a list of supported `Content-Encoding` types. + + * Brotli: `Content-Encoding: br` + * Gzip: `Content-Encoding: gzip` + * Deflate: `Content-Encoding: deflate` operationId: actorTask_runs_last_dataset_items_post parameters: - $ref: "../../parameters/runAndBuildParameters.yaml#/actorTaskId" - $ref: "../../parameters/lastRunParameters.yaml#/status" - $ref: "../../parameters/lastRunParameters.yaml#/origin" + - $ref: "../../parameters/keyValueStoreParameters.yaml#/Content-Encoding" diff --git a/apify-api/openapi/components/objects/key-value-stores/key-value-store-record.yaml b/apify-api/openapi/components/objects/key-value-stores/key-value-store-record.yaml index 0b91487d34..c2ecc8236a 100644 --- a/apify-api/openapi/components/objects/key-value-stores/key-value-store-record.yaml +++ b/apify-api/openapi/components/objects/key-value-stores/key-value-store-record.yaml @@ -217,9 +217,9 @@ putById: Below is a list of supported `Content-Encoding` types. + * Brotli compression: `Content-Encoding: br` * Gzip compression: `Content-Encoding: gzip` * Deflate compression: `Content-Encoding: deflate` - * Brotli compression: `Content-Encoding: br` operationId: keyValueStore_record_put parameters: - $ref: "../../parameters/keyValueStoreParameters.yaml#/storeId" diff --git a/apify-api/openapi/components/objects/key-value-stores/key-value-store-records.yaml b/apify-api/openapi/components/objects/key-value-stores/key-value-store-records.yaml index 9be7b47380..162c119605 100644 --- a/apify-api/openapi/components/objects/key-value-stores/key-value-store-records.yaml +++ b/apify-api/openapi/components/objects/key-value-stores/key-value-store-records.yaml @@ -157,9 +157,9 @@ putById: Below is a list of supported `Content-Encoding` types. + * Brotli compression: `Content-Encoding: br` * Gzip compression: `Content-Encoding: gzip` * Deflate compression: `Content-Encoding: deflate` - * Brotli compression: `Content-Encoding: br` operationId: keyValueStore_record_put parameters: - $ref: "../../parameters/keyValueStoreParameters.yaml#/storeId" diff --git a/apify-api/openapi/components/parameters/keyValueStoreParameters.yaml b/apify-api/openapi/components/parameters/keyValueStoreParameters.yaml index b6c8b2a422..4676cb1c9d 100644 --- a/apify-api/openapi/components/parameters/keyValueStoreParameters.yaml +++ b/apify-api/openapi/components/parameters/keyValueStoreParameters.yaml @@ -86,13 +86,13 @@ attachment: Content-Encoding: name: Content-Encoding in: header - description: "" + description: Compression encoding of the request body. required: false style: simple schema: enum: + - br - gzip - deflate - - br - identity type: string