FilesService

Upload and manage files.

Methods

Method	Description
upload(file, options?)	Upload a file
get(id)	Get file metadata
delete(id)	Delete a file

upload()

Upload a file to the server.

import fs from 'fs';

// From file path
const buffer = fs.readFileSync('./logo.png');
const blob = new Blob([buffer], { type: 'image/png' });

const file = await client.files.upload(blob, {
  title: 'Company Logo',
  description: 'Main brand logo'
});

console.log('File ID:', file.id);
console.log('URL:', `https://api.wallethero.app/assets/${file.id}`);

get()

Get file metadata.

const file = await client.files.get('file-uuid');

console.log('Filename:', file.filename_download);
console.log('Size:', file.filesize);
console.log('Type:', file.type);
console.log('Dimensions:', `${file.width}x${file.height}`);

delete()

Delete a file.

await client.files.delete('file-uuid');

File URL

Access uploaded files via:

https://api.wallethero.app/assets/{file-id}

With transformations:

https://api.wallethero.app/assets/{file-id}?width=200&height=200&fit=cover