List objects

Lists live objects in key order, one page at a time. Pass delimiter "/" to group keys into prefixes, or sort=newest to list the most recent writes first. Role: viewer or higher.

GET/v1/workspaces/{workspaceId}/buckets/{bucketId}/objects

Authentication

Send your Graphon API key with every request. The value is the whole API key that Graphon showed when you created it. See Authentication.

Authorization: Bearer <GRAPHON_API_KEY>

curl \
  --url "https://storage.beta.graphon.sh/v1/workspaces/wspq7ws2np5l8z4/buckets/bktA1b2C3d4E5/objects" \
  --header "Authorization: Bearer $GRAPHON_API_KEY"

Request

Loading your session…

Response

This operation does not return a response body.

Path parameters

workspaceIdstring

The workspace id.

bucketIdstring

The bucket id.

Query parameters

prefixstring (optional)

Return only keys that start with this text.

delimiterstring (optional)

Group keys into prefixes at this character, usually "/".

sortstring (optional)

key (the default) lists in key order. newest lists the most recently written objects first. It takes no delimiter. One of: key, newest.

cursorstring (optional)

The nextCursor from the previous page.

limitstring (optional)

The most items on one page, from 1 to 1000. A prefix counts as one item. The default is 1000.

Was this page helpful?

View as Markdown