Refresh File URLs API Reference

Serverhttps://api.pinnacle.sh/

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

Authorization

Pinnacle API key

PINNACLE-API-KEY<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

urlsarray<string>

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.

Each item

Example

"https://pinnacle.sh"

Response Body

`application/json`

Pinnacle client libraries

import { PinnacleClient } from "rcs-js";

const client = new PinnacleClient({
  apiKey: process.env.PINNACLE_API_KEY!,
});

await client.tools.file.refresh({
    urls: ["https://server.trypinnacle.app/storage/v1/object/sign/vault/3/test.jpg?token=oldtoken", "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/document.pdf?token=oldtoken2", "invalid/url", "https://google.com"]
});

Responses

[  {    "original": "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/test.jpg?token=oldtoken",    "refreshed": "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/test.jpg?token=newtoken"  },  {    "original": "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/document.pdf?token=oldtoken2",    "refreshed": "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/document.pdf?token=newtoken2"  },  {    "original": "invalid/url",    "refreshed": "invalid/url"  },  {    "original": "https://google.com",    "refreshed": "https://google.com"  }]

Refresh File URLs

Request body

Authorization

Request Body

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Try asking

Refresh File URLs

AuthorizationCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

400application/json

401application/json

403application/json

500application/json

Authorization

Request Body

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`