Refresh File URLs

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 } 9 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": "icons/3/test.jpg", 12 "refreshed": "https://server.trypinnacle.app/storage/v1/object/sign/icons/3/138/129?token=newtoken3" 13 }, 14 { 15 "original": "invalid/url", 16 "refreshed": "invalid/url" 17 }, 18 { 19 "original": "https://google.com", 20 "refreshed": "https://google.com" 21 } 22 ]

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>

Request

This endpoint expects an object.

urislist of stringsRequired

Array of file URIs to refresh for extended access.

Accepted formats:

Full presigned URLs: https://server.trypinnacle.app/storage/v1/object/sign/...
Short URIs: {BUCKET}/${TEAM_ID}/... (e.g., vault/3/document.pdf)

Invalid or external URLs will be returned unchanged in the response.

Array of file URIs to refresh for extended access. <br> Accepted formats: - **Full presigned URLs**: `https://server.trypinnacle.app/storage/v1/object/sign/...` - **Short URIs**: `{BUCKET}/${TEAM_ID}/...` (e.g., `vault/3/document.pdf`) 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.

Headers

Request

Response

Errors