> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gcore.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create S3-compatible storage

> Creates a new S3-compatible storage instance in the specified location and returns the storage details including credentials.



## OpenAPI

````yaml /api-reference/services_docs_mintlify/object_storage_api.yaml post /storage/v4/object_storages
openapi: 3.1.0
info:
  title: Gcore OpenAPI – Object Storage API
  description: >-
    This OpenAPI is an aggregated OpenAPI specification that unifies all Gcore
    products into a single file. It covers Cloud, CDN, DNS, WAAP, DDoS
    Protection, Object Storage, Streaming, and FastEdge services.
  version: 4b5ff58882b3
servers:
  - url: https://api.gcore.com
security:
  - APIKey: []
tags:
  - name: Notifications
  - name: S3-Compatible Storage
  - name: SFTP Storage
  - name: SSHKeys
  - name: Storage
  - name: Storage Locations
  - name: Storage Statistics
paths:
  /storage/v4/object_storages:
    post:
      tags:
        - S3-Compatible Storage
      summary: Create S3-compatible storage
      description: >-
        Creates a new S3-compatible storage instance in the specified location
        and returns the storage details including credentials.
      operationId: createS3StorageV4
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/S3StorageCreateBodyV4'
        required: true
      responses:
        '201':
          description: S3StorageResV4
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/S3StorageResV4'
        '400':
          description: ErrResponse
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrResponse'
        '401':
          description: ErrResponse
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrResponse'
        '403':
          description: ErrResponse
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrResponse'
        '409':
          description: ErrResponse
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrResponse'
components:
  schemas:
    S3StorageCreateBodyV4:
      title: >-
        S3StorageCreateBodyV4 Request body for creating an S3-compatible
        storage.
      required:
        - location_name
        - name
      type: object
      properties:
        location_name:
          type: string
          description: Location code where the storage should be created
          example: s-region-1
        name:
          type: string
          description: User-defined name for the storage instance
          example: my-storage-prod
    S3StorageResV4:
      title: >-
        S3StorageResV4 S3-compatible storage with connection details and
        credentials. Use address and access_keys to connect.
      required:
        - access_keys
        - address
        - created_at
        - full_name
        - id
        - location_name
        - name
        - provisioning_status
      type: object
      properties:
        access_keys:
          type: array
          description: S3 access keys
          items:
            $ref: '#/components/schemas/S3CredentialsV4'
        address:
          type: string
          description: Full hostname/address for accessing the storage endpoint
          example: luxembourg-2.storage.example.com
        created_at:
          type: string
          description: ISO 8601 timestamp when the storage was created
          format: date-time
          example: '2025-08-05T09:17:02Z'
        full_name:
          type: string
          description: >-
            Read-only internal full name of the storage, composed as
            "{`client_id`}-{name}".

            Used internally by the backend. Clients should continue to identify
            the storage by `name`.
          example: 696-my-storage-prod
        id:
          type: integer
          description: Unique identifier for the storage instance
          format: int64
          example: 1
        location_name:
          type: string
          description: Geographic location code where the storage is provisioned
          example: luxembourg-2
        name:
          type: string
          description: >-
            User-defined name for the storage instance, as supplied at creation
            time.
          example: my-storage-prod
        provisioning_status:
          type: string
          description: >-
            Lifecycle status of the storage. Use this to check readiness before
            operations.
          example: active
          enum:
            - creating
            - active
            - updating
            - deleting
            - deleted
    ErrResponse:
      type: object
      properties:
        error:
          type: string
      description: ErrResponse is an error response
    S3CredentialsV4:
      title: >-
        S3CredentialsV4 S3-compatible access key pair for authenticating
        requests to the storage endpoint.
      required:
        - access_key
        - secret_key
      type: object
      properties:
        access_key:
          type: string
          description: >-
            Access key ID used as the username in S3 authentication. Pass this
            in the `AWS_ACCESS_KEY_ID` field of your S3 client.
          example: AKIAIOSFODNN7EXAMPLE
        secret_key:
          type: string
          description: >-
            Secret key used as the password in S3 authentication. Save this now
            — it cannot be retrieved again.
          example: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
  securitySchemes:
    APIKey:
      description: >-
        API key for authentication. Make sure to include the word `apikey`,
        followed by a single space and then your token.

        Example: `apikey 1234$abcdef`
      type: apiKey
      in: header
      name: Authorization

````