Containers

Containers are logical storage boundaries — similar to Azure Blob containers or S3 buckets. Where and how they are physically stored is fully managed by the platform.

Endpoints

Method	Path	Description	Permission
GET	/api/v1/containers	List your containers	containers.read
GET	/api/v1/containers/{container}	Get one container	containers.read
GET	/api/v1/storage/usage	Quota and usage for your storage account	containers.read

Container creation is handled by the platform administrator during onboarding. Contact your administrator to add containers.

Naming rules

Lowercase letters, numbers, and hyphens only
3–63 characters
Must begin and end with a letter or number
Unique inside your storage account

Good examples: legal-documents, contracts, invoices, application-data, archive.

Example

curl https://storage.devd.org/api/v1/containers \
  -H "X-API-Key: sk_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "containers": [
      {
        "id": "container_9dKf2mQp71Ws04Xz",
        "name": "contracts",
        "status": "active",
        "readOnly": false,
        "quotaBytes": null,
        "usedBytes": 10485760,
        "fileCount": 12,
        "createdAt": "2026-07-01T09:00:00.000Z"
      }
    ]
  },
  "requestId": "req_..."
}

Usage

curl https://storage.devd.org/api/v1/storage/usage \
  -H "X-API-Key: sk_live_YOUR_KEY"

{
  "success": true,
  "data": {
    "usage": {
      "quotaBytes": 10737418240,
      "usedBytes": 10485760,
      "remainingBytes": 10726932480,
      "fileCount": 12,
      "containerCount": 2
    }
  },
  "requestId": "req_..."
}