v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
esper_cloud_api_Content

List content

Returns a paginated list of all files uploaded to the enterprise's Content Management library. Each result includes file metadata such as MIME type, size, tags, description, path, and ownership — but not the file content itself. Use this endpoint to discover content IDs for use in downstream operations such as pushing files to devices.

Query parameters:

search (optional) — Filter results by tags or description; does not search by filename

limit (optional, default: 20) — Number of results to return per page

offset (optional, default: 0) — Index from which to start returning results

Response fields of note (Content schema):

key — The filename or identifier for the content

kind — MIME type of the file (e.g., application/pdf, image/png)

size — File size in bytes

tags — Array of tag strings; searchable via the search parameter

description — Optional description for the file; also searchable via search

path — Path to the content within the library

is_dir — Whether the entry represents a directory rather than a file

owner — User who uploaded the content

Common Use Cases

Discovering content IDs needed to reference files in device push operations

Auditing the enterprise content library for stale, duplicate, or untagged files

Building content browsing or selection UIs in custom management tools

Verifying a file exists and retrieving its metadata before issuing a push command

Best Practices

Use the search parameter to filter by tags or description rather than fetching all content and filtering client-side — note that search does not match on filename (key)

Use descriptive tags at upload time to make content discoverable via this endpoint's search

Paginate with limit and offset for enterprises with large content libraries

get/v0/enterprise/{enterprise_id}/content/

Path parameters

enterprise_idstring required

A UUID string identifying this enterprise.

Query parameters

searchstring

Seach by tags, description

limitinteger

Number of results to return per page.

offsetinteger

The initial index from which to return the results.

Response

successful operation

countinteger required
nextstring url nullable
previousstring url nullable