Work with ClearLake objects - ECS Cloud Services API

Object keys

Object keys are strings relative to a bucket. Forward slashes create folder-like organization:

avatars/user-123.png

Keys are case-sensitive. Keep keys stable and predictable because the exact key is required for metadata, download, and delete requests.

List objects

GET /clearlake/buckets/:name/objects requires clearlake:read and returns:

{
  "objects": [
    {
      "key": "avatars/user-123.png",
      "file_name": "ACCOUNT_ID/user-uploads/avatars/user-123.png",
      "file_id": "file-id",
      "size": 245678,
      "content_type": "image/png"
    }
  ]
}

Get object metadata

GET /clearlake/buckets/:name/objects/* requires clearlake:read. Replace the wildcard with the complete object key. The response contains key, file_name, file_id, size, and content_type.

Delete an object

DELETE /clearlake/buckets/:name/objects/* requires clearlake:delete and returns 204 No Content. Deleting an object is permanent.

Troubleshooting

Symptom	What to check
Object is not found	Use the exact case-sensitive object key.
Metadata does not match	List the bucket and compare the returned `key` exactly.
Delete is denied	Confirm the key has `clearlake:delete`.