Skip to main content
PUT
/
datasets
/
views
/
delivery_settings
/
bulk
cURL
curl --request PUT \
  --url https://api.brightdata.com/datasets/views/delivery_settings/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "views": [
    "v_id1",
    "v_id2"
  ],
  "filename": {
    "extension": "json",
    "template": "bd_{[datetime]}",
    "tz_offset": "+00:00"
  },
  "flatten_csv": false,
  "deliver": {
    "type": "s3",
    "bucket": "bucket_name",
    "credentials": {
      "aws-access-key": "AWS_ACCESS_KEY",
      "aws-secret-key": "AWS_SECRET_KEY"
    },
    "region": "us-east-1"
  },
  "tar": true,
  "compress": true,
  "batch_size": 1000
}
'
{
  "view_ids": [
    "v_id1",
    "v_id2"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt

Use this file to discover all available pages before exploring further.

Updates the delivery configuration for every view in the views array. All listed views receive the same deliver, filename, tar, compress and batch_size values, so use this endpoint when you want several views to deliver to the same destination with identical packaging rules.
To update a single view, use Update view delivery settings instead.
The deliver object must match the schema returned by Get destination type schema for the destination you select. The response returns view_ids, the full list of views that were updated.

Authorizations

​
Authorization
string
header
required

Use your Bright Data API Key as a Bearer token in the Authorization header.

How to authenticate:

  1. Obtain your API Key from the Bright Data account settings at https://brightdata.com/cp/setting/users
  2. Include the API Key in the Authorization header of your requests
  3. Format: Authorization: Bearer YOUR_API_KEY

Example:

Authorization: Bearer b5648e1096c6442f60a6c4bbbe73f8d2234d3d8324554bd6a7ec8f3f251f07df

Learn how to get your Bright Data API key: https://docs.brightdata.com/api-reference/authentication

Body

application/json

Delivery configuration for a dataset view. Used by the view delivery settings GET, PUT and bulk PUT endpoints.

​
views
string[]
required

The list of view IDs to update.

Example:
["v_id1", "v_id2"]
​
deliver
Microsoft Azure · object

Delivery destination configuration. The type field selects the destination (for example s3, sftp, webhook) and the remaining fields depend on the destination schema returned by /datasets/delivery_settings/{destination_type}/schema.

​
filename
object

Configuration for the output file name and format.

​
flatten_csv
boolean
default:false

When true, nested fields are flattened for CSV output.

​
tar
boolean
default:false

When true, delivered files are bundled into a TAR archive.

​
compress
boolean
default:false

When true, delivered files are gzip compressed.

​
batch_size
integer

Maximum records per batch file. Use to split large deliveries into smaller files. Maximum batch size is 5GB.

Example:

1000

Response

Views updated

​
view_ids
string[]