---
title: "Create Bulk Export Destination"
method: POST
path: "/api/v1/bulk-exports/destinations"
tags: ["bulk-exports"]
---

# Create Bulk Export Destination

`POST /api/v1/bulk-exports/destinations`

Create a new bulk export destination

## Request body

- BulkExportDestinationCreate
  - `destination_type` 's3'
  - `display_name` string, required
  - `config` BulkExportDestinationS3Config, required
    - `endpoint_url` string, nullable
    - `prefix` string
    - `bucket_name` string, nullable
    - `region` string, nullable
    - `s3_additional_kwargs` object, nullable
    - `config_kwargs_s3` BotocoreS3Config — Typed subset of botocore Config s3 parameter. See: https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html
      - `addressing_style` 'auto' | 'virtual' | 'path', nullable — S3 addressing style. Use "virtual" for services that require virtual-hosted style (e.g. Volcengine TOS), "path" for path-style, or "auto" (default) to let boto3 decide.
      - `use_accelerate_endpoint` boolean, nullable — Whether to use the S3 Accelerate endpoint.
      - `payload_signing_enabled` boolean, nullable — Whether to SHA256 sign SigV4 payloads.
      - `us_east_1_regional_endpoint` 'regional' | 'legacy', nullable — Which S3 endpoint to use when region is us-east-1.
    - `include_bucket_in_prefix` boolean — Whether to prepend the bucket name to the S3 file path. Defaults to True. Set to False to skip prepending the bucket name if bucket name is already in the endpoint URL.
    - `aws_role_arn` string, nullable — AWS IAM role ARN that LangSmith assumes instead of using static credentials.
  - `credentials` BulkExportDestinationS3Credentials
    - `access_key_id` string, required
    - `secret_access_key` string, required
    - `session_token` string, nullable

## Response `200`

Successful Response

- BulkExportDestination
  - `destination_type` 's3'
  - `display_name` string, required
  - `config` BulkExportDestinationS3Config, required
    - `endpoint_url` string, nullable
    - `prefix` string
    - `bucket_name` string, nullable
    - `region` string, nullable
    - `s3_additional_kwargs` object, nullable
    - `config_kwargs_s3` BotocoreS3Config — Typed subset of botocore Config s3 parameter. See: https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html
      - `addressing_style` 'auto' | 'virtual' | 'path', nullable — S3 addressing style. Use "virtual" for services that require virtual-hosted style (e.g. Volcengine TOS), "path" for path-style, or "auto" (default) to let boto3 decide.
      - `use_accelerate_endpoint` boolean, nullable — Whether to use the S3 Accelerate endpoint.
      - `payload_signing_enabled` boolean, nullable — Whether to SHA256 sign SigV4 payloads.
      - `us_east_1_regional_endpoint` 'regional' | 'legacy', nullable — Which S3 endpoint to use when region is us-east-1.
    - `include_bucket_in_prefix` boolean — Whether to prepend the bucket name to the S3 file path. Defaults to True. Set to False to skip prepending the bucket name if bucket name is already in the endpoint URL.
    - `aws_role_arn` string, nullable — AWS IAM role ARN that LangSmith assumes instead of using static credentials.
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `credentials_keys` string[], required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/revisions/a0acb3a6a101/schema)