OMomni
Content

Retrieve content

Changed on

Retrieve paginated list of documents and folders

get/v1/content

Request

  • Base URL
    https://blobsrus.omniapp.co/api
  • URL
    https://blobsrus.omniapp.co/api/v1/content
  • Auth
    HTTP bearer

Query parameters

labelsstring

Comma-separated list of label names to filter by

scope'restricted' | 'organization'

Content scope filter

sortField'favorites' | 'name'

Field to sort by

sortDirection'asc' | 'desc'

Direction for sorting results:

  • asc - Ascending order (A-Z, 0-9)
  • desc - Descending order (Z-A, 9-0)
includestring

Comma-separated list of additional fields to include in the response:

  • _count - Adds count metrics (folders: document and favorite counts; documents: favorite and view counts)
  • labels - Includes associated content labels
folderIdstring uuid

Returns all content in the specified folder. Cannot be used with path.

pathstring

Filter content by path. Cannot be used with folderId. Examples:

  • /folder/subfolder - Returns the folder and any content it contains
  • /folder/* - Returns the folder and the direct children only
  • /folder/** - Returns all folders and content recursively in the path
  • / - Returns all content in the organization
creatorIdstring uuid

UUID of organization membership. Required when scope is restricted.

pageSizeinteger

Number of records per page (1-100)

cursorstring

Pagination cursor from previous response

Response

Paginated content list

recordsobject[]

Changes

  • 43290040f88fRevision changes
    • breaking

      added the pattern ^\s*((_count|labels)\s*)?(,\s*((_count|labels)\s*)?)*$ to the query request parameter include