Upload File

Generate presigned URLs that let you upload files directly to our storage and allow your users to download them securely.

Request

This endpoint expects an object.

contentTypestringRequired

MIME type of your file.

Supported file types:

Audio: mp3, mp4, mpeg, ogg, aac, webm, wav, 3gpp, amr
Video: mp4, mpeg, quicktime, webm, 3gpp, H.264, m4v
Image: jpeg, png, gif, bmp, tiff, webp
Documents: pdf, csv, rtf, calendar, vcard

MIME type of your file. <br> Supported file types: - Audio: mp3, mp4, mpeg, ogg, aac, webm, wav, 3gpp, amr - Video: mp4, mpeg, quicktime, webm, 3gpp, H.264, m4v - Image: jpeg, png, gif, bmp, tiff, webp - Documents: pdf, csv, rtf, calendar, vcard

sizeintegerRequired>=1

Size of your file in bytes. Should be less than 100 MB.

namestringOptional

Name of your file.

optionsobjectOptional

Additional configurations for your file.

Response

Successfully uploaded the file.

uploadUrlstring

Presigned URL for uploading your file to storage.

downloadUrlstring

Presigned URL for downloading your file.

metadataobject

1	import { PinnacleClient } from "rcs-js";
2
3	async function main() {
4	const client = new PinnacleClient({
5	environment: "https://api.pinnacle.sh",
6	});
7	await client.tools.file.upload({});
8	}
9	main();

1	{
2	"uploadUrl": "https://server.trypinnacle.app/storage/v2/object/upload/sign/vault/3/test.jpg?token=example",
3	"downloadUrl": "https://server.trypinnacle.app/storage/v2/object/sign/vault/3/test.jpg?token=example",
4	"metadata": {
5	"fileName": "test.jpg",
6	"contentType": "image/jpeg",
7	"expiresAt": "2025-08-30T12:00:00.000Z"
8	}
9	}

Headers

Request

Response

Errors