Refresh File URLs | Pinnacle

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.refresh({ 8 urls: [ 9 "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/test.jpg?token=oldtoken", 10 "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/document.pdf?token=oldtoken2", 11 "invalid/url", 12 "https://google.com", 13 ], 14 }); 15 } 16 main();

1 [ 2 { 3 "original": "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/test.jpg?token=oldtoken", 4 "refreshed": "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/test.jpg?token=newtoken" 5 }, 6 { 7 "original": "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/document.pdf?token=oldtoken2", 8 "refreshed": "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/document.pdf?token=newtoken2" 9 }, 10 { 11 "original": "invalid/url", 12 "refreshed": "invalid/url" 13 }, 14 { 15 "original": "https://google.com", 16 "refreshed": "https://google.com" 17 } 18 ]

Refresh expiring presigned URLs for Pinnacle-hosted files to extend their access time.

This only works for presigned download URLs. At this moment, you cannot refresh a presigned upload URL, generate a new one instead.

Refresh expiring presigned URLs for Pinnacle-hosted files to extend their access time. <Callout type="info"> This only works for presigned download URLs. At this moment, you cannot refresh a presigned upload URL, generate a new one instead. </Callout>

Authentication

PINNACLE-API-KEYstring

API Key authentication via header

Request

This endpoint expects an object.

urlslist of stringsRequired

Array of file URLs to refresh for extended access. Provided URLs must be presigned URLs (i.e. https://server.trypinnacle.app/storage/v1/object/sign/...). Invalid or external URLs will be returned unchanged in the response.

Response

Successfully refreshed file URLs.

originalstring

The original file URI that was provided in the request.

refreshedstring

The new refreshed presigned URL that expires in one hour.

Authentication

Request

Response

Errors