---
updatedAt: 2025-09-22T20:33:41.000Z
agentTools:
  projectIndex: https://docs.v7labs.com/llms.txt
---

# Show External Storage endpoint

## Response object

Storage object returned by this API consists of the following generic and required fields:

* *provider* (`aws` / `gcp` / `azure` / `minio`)
* *name* - name of the storage
* *slug* - "slug" version of the storage name
* *bucket* - data bucket name
* *prefix* - prefix key for Darwin related generated files

Additional fields appear based on the *provider* value:

* For `provider: aws`:
  * *region* - S3 bucket's region
* For `provider: azure`:
  * *tenant\_id* - "Tenant ID" that holds the storage account
* For `provider: minio`:
  * *base\_url* - URL to the MinIO server

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "darwin-api",
    "version": "2.0"
  },
  "servers": [
    {
      "url": "https://darwin.v7labs.com/api"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-default": "ApiKey {{key}}",
        "x-bearer-format": ""
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/teams/{team_slug}/storage/{storage_slug}": {
      "get": {
        "summary": "Show External Storage endpoint",
        "description": "",
        "operationId": "show-external-storage-endpoint-2",
        "parameters": [
          {
            "name": "team_slug",
            "in": "path",
            "description": "Slug of the team.",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "storage_slug",
            "in": "path",
            "description": "Slug of the external storage setting.",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"provider\": \"minio\",\n  \"default\": false,\n  \"name\": \"test\",\n  \"readonly\": true,\n  \"bucket\": \"bukkit\",\n  \"prefix\": \"test\",\n  \"base_url\": \"http://some-url:9000\",\n  \"slug\": \"test\"\n}"
                  }
                },
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "provider": {
                          "type": "string",
                          "example": "aws"
                        },
                        "default": {
                          "type": "boolean",
                          "example": false,
                          "default": true
                        },
                        "name": {
                          "type": "string",
                          "example": "test"
                        },
                        "readonly": {
                          "type": "boolean",
                          "example": true,
                          "default": true
                        },
                        "bucket": {
                          "type": "string",
                          "example": "bukkit"
                        },
                        "prefix": {
                          "type": "string",
                          "example": "test"
                        },
                        "region": {
                          "type": "string",
                          "example": "au-downunder-1"
                        },
                        "slug": {
                          "type": "string",
                          "example": "test"
                        },
                        "cloudfront_host": {
                          "type": "string",
                          "example": "a1b2c3d4e5.cloudfront.net"
                        }
                      }
                    },
                    {
                      "type": "object",
                      "properties": {
                        "provider": {
                          "type": "string",
                          "example": "gcp"
                        },
                        "default": {
                          "type": "boolean",
                          "example": false,
                          "default": true
                        },
                        "name": {
                          "type": "string",
                          "example": "test"
                        },
                        "readonly": {
                          "type": "boolean",
                          "example": true,
                          "default": true
                        },
                        "bucket": {
                          "type": "string",
                          "example": "bukkit"
                        },
                        "prefix": {
                          "type": "string",
                          "example": "test"
                        },
                        "slug": {
                          "type": "string",
                          "example": "test"
                        }
                      }
                    },
                    {
                      "type": "object",
                      "properties": {
                        "provider": {
                          "type": "string",
                          "example": "azure"
                        },
                        "default": {
                          "type": "boolean",
                          "example": false,
                          "default": true
                        },
                        "name": {
                          "type": "string",
                          "example": "test"
                        },
                        "readonly": {
                          "type": "boolean",
                          "example": true,
                          "default": true
                        },
                        "bucket": {
                          "type": "string",
                          "example": "bukkit"
                        },
                        "prefix": {
                          "type": "string",
                          "example": "test"
                        },
                        "slug": {
                          "type": "string",
                          "example": "test"
                        },
                        "tenant_id": {
                          "type": "string",
                          "example": "720bf9959be31ab049860ca48045e0fa0480a9b8"
                        }
                      }
                    },
                    {
                      "type": "object",
                      "properties": {
                        "provider": {
                          "type": "string",
                          "example": "minio"
                        },
                        "default": {
                          "type": "boolean",
                          "example": false,
                          "default": true
                        },
                        "name": {
                          "type": "string",
                          "example": "test"
                        },
                        "readonly": {
                          "type": "boolean",
                          "example": true,
                          "default": true
                        },
                        "bucket": {
                          "type": "string",
                          "example": "bukkit"
                        },
                        "prefix": {
                          "type": "string",
                          "example": "test"
                        },
                        "base_url": {
                          "type": "string",
                          "example": "http://some-url:9000"
                        },
                        "slug": {
                          "type": "string",
                          "example": "test"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```