---
title: "Get an external storage configuration"
method: GET
path: "/organization/external_storage/{external_storage_id}"
---

# Get an external storage configuration

`GET /organization/external_storage/{external_storage_id}`

## Request

- Base URL: `https://api.openai.com/v1`
- URL: `https://api.openai.com/v1/organization/external_storage/{external_storage_id}`
- Auth: HTTP bearer

Get one customer-managed external storage configuration.

## Path parameters

- `external_storage_id` 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
    - GcpExternalStorageProviderResponse
      - `type` 'gcp', required
      - `bucket` string, required
      - `workload_identity_project_number` string, required
      - `workload_identity_pool_id` string, required
      - `workload_identity_provider_id` string, required
      - `region` string, required
      - `audience` string, required
    - OciExternalStorageProviderResponse
      - `type` 'oci', required
      - `tenancy_ocid` string, required
      - `region` string, required
      - `bucket` string, required
  - `geography` string, required
  - `status` 'pending' | 'validated' | 'degraded' | 'unhealthy', required
  - `created_at` integer, required

## Other responses

- `400`: The organization is not enabled for external storage.
- `403`: The caller does not have permission to perform this operation.
- `404`: The organization or external storage was not found.

## Changes

- **2026-10-16** `13c0e09efdca`: 1 warning
  - added the new `degraded` enum value to the `status` response property for the response status `200`
- **2026-10-08** `bafa7e3ac5cb`: 1 breaking
  - added `#/components/schemas/OciExternalStorageProviderResponse` to the `provider` response property `oneOf` list for the response status `200`
- **2026-10-06** `487892d3954e`: 3 info
  - added the optional property `error/misalignment/review_target` to the response with the `400` status
  - added the optional property `error/misalignment/review_target` to the response with the `403` status
  - added the optional property `error/misalignment/review_target` to the response with the `404` status
- **2026-10-05** `7f654af7f94f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omnistack-sh/apis/openai-api/changes/organization/external_storage/:external_storage_id/get.md)

---

[API](https://skmtc.dev/omnistack-sh/apis/openai-api.md) - [All operations](https://skmtc.dev/omnistack-sh/apis/openai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omnistack-sh/apis/openai-api/revisions/0a26f104d35f?raw)