tools > file

Refresh File URLs

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>
post/tools/files/refresh

Request

  • Base URL: https://api.pinnacle.sh
  • URL: https://api.pinnacle.sh/tools/files/refresh
  • Auth: API key in header PINNACLE-API-KEY

Request body

urlsstring[] required

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 required

The original file URI that was provided in the request.

refreshedstring required

The new refreshed presigned URL that expires in one hour.

Changes

No recorded changes to this operation across all 1 revision of this API.