Skip to content

Storage buckets API

Grant: API_STORAGE. BYO also requires a Pro (or Platform) subscription unless that gate is disabled in a given environment.

Issuer, audience, subject, sample IAM trust policy. No body.

Amazon S3:

{
"name": "prod-layers",
"provider": "S3",
"auth_mode": "OIDC",
"bucket_name": "my-bucket",
"key_prefix": "amendable/",
"role_arn": "arn:aws:iam::123456789012:role/amendable-byo-storage",
"is_default": true
}

R2 / MinIO: auth_mode STATIC_KEYS, plus region, access_key_id, secret_access_key, and usually endpoint_url.

  1. Status PENDING_VERIFICATION.

Canary Put/Head/Delete. 200 with status and last_validated_at, or 422 on provider failure (status becomes FAILED).

OIDC region and endpoints stay platform-managed even if you send them.

204, or 422 if repos still depend on it.

Query: limit, offset, storage_bucket_id.