Skip to content

Class: FilesResource

Files Core

.delete(fileId): Promise<BaseOkay> Since1.0.0

DELETE /files/{file_id} No API Docs
Deletes a file

Parameters

NameTypeDescription
fileIdnumberFile identifier

Returns

Promise<BaseOkay>

BaseDelete Delete response

Throws

If file ID is invalid

Example

javascript
await rest.files.delete(14);

.get(fileId): Promise<File> Since1.0.0

GET /files/{file_id} No API Docs
Gets a file by identifier

Parameters

NameTypeDescription
fileIdnumberFile identifier

Returns

Promise<File>

File object

Throws

If file ID is invalid

Example

javascript
const file = await rest.files.get(23);

.getAll(page?): Promise<File[]> Since1.0.0

GET /files No API Docs
Gets all files

Parameters

NameTypeDescription
page?numberPage number (optional)

Returns

Promise<File[]>

Array of File objects

Throws

If page number is invalid

Example

javascript
const files = await rest.files.getAll();
const nextPage = await rest.files.getAll(1);

.upload(file, filename?): Promise<File> Since1.0.0

POST /files No API Docs
Uploads a file from Blob, File, Buffer, or file path (Node.js only)

Parameters

NameTypeDescription
filestring | Blob | Buffer<ArrayBufferLike>File, Blob, Buffer, or file path (string)
filename?stringCustom filename (required for Buffer/Blob, optional for path)

Returns

Promise<File>

File Uploaded file

Throws

If input is invalid

Example

javascript
// Browser: Upload File from input
const fileInput = document.querySelector('input[type="file"]');
const file = await rest.files.upload(fileInput.files[0]);

// Browser: Upload Blob
const blob = new Blob(['content'], { type: 'text/plain' });
const file = await rest.files.upload(blob, 'document.txt');

// Node.js: Upload Buffer
const buffer = Buffer.from('content');
const file = await rest.files.upload(buffer, 'document.txt');

// Node.js: Upload from file path
const file = await rest.files.upload('./document.pdf');