Files and folders
List a bucket path, create folders, rename entries, change visibility, and search across a workspace without changing an asset's revision identity.
GET/api/assets/{bucket_id}/objects
200 OKList the folders and files immediately inside a bucket path.
Required scopeassets:read
Query parameters
NameTypeDescription
prefixstringFolder path such as campaign/launch/. Omit it for the bucket root.
include_db_metabooleanIncludes database metadata such as visibility, asset ID, scan state, and revision data. Default true.
rev_onlybooleanReturns only the listing revision token for lightweight refresh checks.
GET/api/assets/_search
200 OKSearch buckets or files in the current workspace.
Required scopeassets:read
Query parameters
NameTypeDescription
qstringrequiredSearch text.
scopebucket | orgSearch one bucket or the full workspace. Default org.
bucket_iduuidRequired when scope is bucket.
limitintegerMaximum results to return.
POST/api/assets/{bucket_id}/folders?path={path}
200 OKCreate a folder marker at a normalized path.
Required scopeassets:write
curl -X POST \
"https://api.steadylink.io/api/assets/$BUCKET_ID/folders?path=campaign/launch" \
-H "X-API-Key: $STEADYLINK_API_KEY"
POST/api/assets/{bucket_id}/objects/rename
200 OKRename or move an indexed file while preserving its stable asset and revisions.
Required scopeassets:write
Query parameters
NameTypeDescription
from_keystringrequiredCurrent bucket-relative key.
to_keystringrequiredNew bucket-relative key. Existing destinations return 409.
POST/api/assets/{bucket_id}/objects/visibility
200 OKSet a file to public, private, or inherit the bucket default.
Required scopeassets:write
Query parameters
NameTypeDescription
keystringrequiredBucket-relative file key.
visibilitypublic | private | inheritrequiredNew visibility mode.