Search media-library folders

Lists folders matching a Mongo-style match filter, always constrained to the caller's workspace.

With no match.parentUploadFolderId, only root-level folders are returned. Pass match.parentUploadFolderId to list the children of a specific folder.

On Free, Creator and Team plans each folder carries an isLimited flag — true means the folder is beyond what the plan allows and is shown but not usable — and limited folders are sorted last.

match is passed to the query almost as given. Treat it as an internal search facility, not a stable filter language.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
curl -X POST 'https://apis.elai.io/api/v1/uploads/folders/lookup' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "match": {
    "parentUploadFolderId": "66a1f0c2b7cd13032a9c6100"
  },
  "sort": "NAME_ASCEND"
}'
Body Params
match
object

Additional filter conditions. accountId is always overwritten with the caller's workspace.

string
enum
Defaults to NAME_ASCEND
Allowed:
Responses

locked and the increaseUserLockedRolePrivileges feature flag is off.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json