# BucketAccess

Access permissions for a bucket. The role assigned to the access key defines the permissions (read, write, admin) for the associated bucket.

**bucket\_name** string required  
Name of the bucket

**role** string required  
The role defines the permissions for the associated bucket:

- `ReadOnly`: Read-only access to the bucket. Permits read operations like GetObject, HeadObject, ListObjects.
- `Editor`: Read and write access to the bucket. Includes everything in ReadOnly, plus PutObject, DeleteObject, and bucket configuration operations.
- `Admin`: Full access to all buckets in the org, bypasses all permission checks. When used with `bucket_name: "*"`, the access key is treated as a full org admin. The value of `bucket_name` should always be `*` when using this role.

Example:

```json
{
    "bucket_name": "*",
    "role": "Admin"
}
```

**Possible values:** [`ReadOnly`, `Editor`, `Admin`]

BucketAccess

```json
{
  "bucket_name": "string",
  "role": "ReadOnly"
}
```