Skip to content

Get content information
Stable

Request

Returns metadata for a single content item in the enterprise's Content Management library, identified by its content_id. The response includes the same fields as the list endpoint — filename, MIME type, size, tags, description, path, and ownership — but scoped to a single file. Does not return the file's binary content.

Common Use Cases

Verifying a specific file's metadata (type, size, tags, path) before referencing it in a device push operation Confirming a file exists and retrieving its details after upload Checking ownership or modification timestamps for auditing purposes

Best Practices

Use GET /v0/enterprise/{enterprise_id}/content/ with the search parameter to find a content_id if you don't already have it — this endpoint requires knowing the ID in advance This endpoint returns metadata only

Security
esper_cloud_api_apiKey
Path
content_idstring, (uuid)required

A UUID string identifying a content instance.

enterprise_idstringrequired

A UUID string identifying enterprise.

cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v0/enterprise/{enterprise_id}/content/{content_id}/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

successful operation

Bodyapplication/json
idinteger(Id)read-onlyrequired

Unique content Identifier

download_urlstring, (url)(Content download URL)

URL to download the content

namestring(Name)

Name of the content

keystring, [ 1 .. 255 ] characters(Key)
is_dirboolean(Is Directory)
Default:false
kindstring or null, <= 255 characters(Content kind)

The mime type of the content

hashstring(Content Hash)

Hash string of the content

sizestring, <= 255 characters(Content Size)

Size of the content in bytes

pathstring(Path)

Path to the content

permissionsstring(Permissions)

The permssion string for the content

tagsArray of strings(Content tags)

Tags for the content

descriptionstring or null(Content description)

Description for the content

createdstring, (date-time)(Created on)read-only
modifiedstring, (date-time)(Modified on)read-only
enterprisestring, (url)(Enterprise)

URL of the enterprise resource

ownerobject(Owner)

Owner of the content

Response
{
  "id": 0,
  "download_url": "string",
  "name": "string",
  "key": "string",
  "is_dir": false,
  "kind": "string",
  "hash": "string",
  "size": "string",
  "path": "string",
  "permissions": "string",
  "tags": [
    "string"
  ],
  "description": "string",
  "created": "2019-08-24T14:15:22Z",
  "modified": "2019-08-24T14:15:22Z",
  "enterprise": "string",
  "owner": {
    "id": 0,
    "username": "string"
  }
}