---
title: "Create an external storage configuration"
method: POST
path: "/organization/external_storage"
---

# Create an external storage configuration

`POST /organization/external_storage`

Register one customer-managed external storage configuration.

## Request body

- CreateExternalStorageBody
  - `project_id` string, required
  - `provider` union, required
    - AwsExternalStorageProviderParams
      - `type` 'aws', required
      - `bucket` string, required
      - `role_arn` string, required
    - AzureExternalStorageProviderParams
      - `type` 'azure', required
      - `tenant_id` string, required
      - `subscription_id` string, required
      - `resource_group` string, required
      - `account_name` string, required
      - `container` string, required

## Response `200`

Success

- ExternalStorageResponse
  - `object` 'organization.external_storage', required
  - `id` string, required
  - `project_id` string, required
  - `provider` union, required
    - AwsExternalStorageProviderResponse
      - `type` 'aws', required
      - `account_id` string, required
      - `region` string, required
      - `bucket` string, required
      - `role_arn` string, required
      - `external_id` string, required
    - AzureExternalStorageProviderResponse
      - `type` 'azure', required
      - `tenant_id` string, required
      - `subscription_id` string, required
      - `resource_group` string, required
      - `account_name` string, required
      - `container` string, required
      - `region` string, required
  - `geography` string, required
  - `status` 'pending' | 'validated' | 'unhealthy', required
  - `created_at` integer, required

## Changes

- **2026-09-18** `8ad6af0ee4e1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openai/apis/openapi/changes/organization/external_storage/post.md)

---

[API](https://skmtc.dev/openai/apis/openapi.md) · [All operations](https://skmtc.dev/openai/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc.dev/openai/apis/openapi/revisions/c40bf0ba89d2?raw)