Logo

Content

APIs to manage files

Find out more about Content management

List content

Get all files in a tenant

SecurityapiKey
Request
path Parameters
enterprise_id
required
string

A UUID string identifying this enterprise.

query Parameters
search
string

Seach by tags, description

limit
integer
Default: 20

Number of results to return per page.

offset
integer
Default: 0

The initial index from which to return the results.

Responses
200

successful operation

401

Authorization information is missing or invalid.

500

Internal server error

get/v0/enterprise/{enterprise_id}/content/
Request samples 
Response samples 
application/json
{
  • "count": 0,
  • "next": "string",
  • "previous": "string",
  • "results": [
    ]
}
Get content information
Get information about a file


SecurityapiKey 
Request 
path Parameters
content_id
required
string <uuid> 
A UUID string identifying a content instance.


 
enterprise_id
required
string
A UUID string identifying enterprise.


 
Responses 
200
successful operation


401
Authorization information is missing or invalid.


404
Not Found.


500
Internal server error


get/v0/enterprise/{enterprise_id}/content/{content_id}/
Request samples 
Response samples 
application/json
{
  • "id": 0,
  • "download_url": "string",
  • "name": "string",
  • "key": "string",
  • "is_dir": false,
  • "kind": "string",
  • "hash": "string",
  • "size": "string",
  • "path": "string",
  • "permissions": "string",
  • "tags": [
    ],
  • "description": "string",
  • "created": "2019-08-24T14:15:22Z",
  • "modified": "2019-08-24T14:15:22Z",
  • "enterprise": "string",
  • "owner": {
    }
}
Delete Content
Delete content.


SecurityapiKey 
Request 
path Parameters
content_id
required
string <uuid> 
A UUID string identifying a content instance.


 
enterprise_id
required
string
A UUID string identifying enterprise.


 
Responses 
204
The resource was deleted successfully.


401
Authorization information is missing or invalid.


403
Forbidden, no permission to perform this action.


404
Not Found.


500
Internal server error


delete/v0/enterprise/{enterprise_id}/content/{content_id}/
Request samples 
Response samples 
application/json
{
  • "errors": [
    ],
  • "message": "string",
  • "status": 0
}
Patch a content instance
SecurityapiKey 
Request 
path Parameters
content_id
required
string <uuid> 
A UUID string identifying a content instance.


 
enterprise_id
required
string
A UUID string identifying enterprise.


 
Request Body schema: */*
optional
tags
Array of strings (Tags) 
Tags for the content


 
description
string (Description) 
Description of the content


 
Responses 
200
successful operation


400
Bad request


401
Authorization information is missing or invalid.


403
Forbidden, no permission to perform this action.


404
Not Found.


415
Unsupported media type.


500
Internal server error


patch/v0/enterprise/{enterprise_id}/content/{content_id}/
Request samples 
Response samples 
application/json
{
  • "id": 0,
  • "download_url": "string",
  • "name": "string",
  • "key": "string",
  • "is_dir": false,
  • "kind": "string",
  • "hash": "string",
  • "size": "string",
  • "path": "string",
  • "permissions": "string",
  • "tags": [
    ],
  • "description": "string",
  • "created": "2019-08-24T14:15:22Z",
  • "modified": "2019-08-24T14:15:22Z",
  • "enterprise": "string",
  • "owner": {
    }
}
Upload new content
Uploaded content to Esper


SecurityapiKey 
Request 
path Parameters
enterprise_id
required
string
A UUID string identifying this enterprise.


 
Request Body schema: multipart/form-data
required
key
required
string <binary> 
Valid file to upload


 
Responses 
200
Successful Operation


400
Bad request


401
Authorization information is missing or invalid.


403
Forbidden, no permission to perform this action.


415
Unsupported media type.


500
Internal server error


post/v0/enterprise/{enterprise_id}/content/upload/
Request samples 
Response samples 
application/json
{
  • "id": 0,
  • "download_url": "string",
  • "name": "string",
  • "key": "string",
  • "is_dir": false,
  • "kind": "string",
  • "hash": "string",
  • "size": "string",
  • "path": "string",
  • "permissions": "string",
  • "tags": [
    ],
  • "description": "string",
  • "created": "2019-08-24T14:15:22Z",
  • "modified": "2019-08-24T14:15:22Z",
  • "enterprise": "string",
  • "owner": {
    }
}
➔ Next to User (Deprecated)