Buckets

curl -sS -X POST "https://k3.dev.dodil.io/admin/buckets" \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "kb-prod",
    "description": "Production knowledge base",
    "storageQuotaBytes": "0",
    "accessMode": "BUCKET_ACCESS_MODE_PRIVATE"
  }'

rpc CreateBucket(CreateBucketRequest) returns (Bucket);
 
message CreateBucketRequest {
  string name = 1;
  string description = 2;
  int64 storage_quota_bytes = 3;              // 0 = unlimited
  BucketAccessMode access_mode = 4;           // default PRIVATE
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "name": "kb-prod",
    "description": "Production knowledge base",
    "storage_quota_bytes": "0",
    "access_mode": "BUCKET_ACCESS_MODE_PRIVATE"
  }' \
  $K3_GRPC \
  dodil.k3.storage.v1.StorageService/CreateBucket

curl -sS "https://k3.dev.dodil.io/admin/buckets/kb-prod" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc GetBucket(GetBucketRequest) returns (Bucket);
 
message GetBucketRequest { string name = 1; }

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "name": "kb-prod"
  }' \
  $K3_GRPC \
  dodil.k3.storage.v1.StorageService/GetBucket

curl -sS "https://k3.dev.dodil.io/admin/buckets?page_size=20&search=prod" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc ListBuckets(ListBucketsRequest) returns (ListBucketsResponse);
 
message ListBucketsRequest {
  dodil.k3.common.v1.PaginationRequest pagination = 1;
  string search = 2;                          // case-insensitive name/desc filter
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "pagination": { "page_size": 20 },
    "search": "prod"
  }' \
  $K3_GRPC \
  dodil.k3.storage.v1.StorageService/ListBuckets

{
  "buckets": [
    {
      "name": "kb-prod",
      "description": "Production knowledge base",
      "storageQuotaBytes": "0",
      "accessMode": "BUCKET_ACCESS_MODE_PRIVATE",
      "storageUsedBytes": "12483920",
      "objectCount": "1247"
    }
  ],
  "pagination": { "nextPageToken": "", "totalCount": "1" }
}

message ListBucketsResponse {
  repeated Bucket buckets = 1;
  dodil.k3.common.v1.PaginationResponse pagination = 2;
}

curl -sS -X PATCH "https://k3.dev.dodil.io/admin/buckets/kb-prod" \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Renamed",
    "accessMode": "BUCKET_ACCESS_MODE_PUBLIC"
  }'

rpc UpdateBucket(UpdateBucketRequest) returns (Bucket);
 
message UpdateBucketRequest {
  string name = 1;
  optional string description = 2;
  optional int64 storage_quota_bytes = 3;
  optional BucketAccessMode access_mode = 4;
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "name": "kb-prod",
    "description": "Renamed",
    "access_mode": "BUCKET_ACCESS_MODE_PUBLIC"
  }' \
  $K3_GRPC \
  dodil.k3.storage.v1.StorageService/UpdateBucket

curl -sS -X DELETE "https://k3.dev.dodil.io/admin/buckets/kb-prod" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc DeleteBucket(DeleteBucketRequest) returns (DeleteBucketResponse);
 
message DeleteBucketRequest { string name = 1; }

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "name": "kb-prod"
  }' \
  $K3_GRPC \
  dodil.k3.storage.v1.StorageService/DeleteBucket