PermuteDocs
Go to Permute

Datasets · datasetsDownload

Download a file dataset

Returns a 15-minute signed download URL for the original uploaded file.

GET/v1/datasets/{datasetId}/download
betaapiKeyworkspace

When to use

Retrieve the original bytes uploaded for a file dataset.

For agents

The returned URL expires after 15 minutes. Fetch it promptly and do not persist it as a durable link.

Example

typescript
import { PermuteClient } from '@permute/sdk';

const orgClient = new PermuteClient({
  apiKey: process.env.PERMUTE_API_KEY!,
});

const client = orgClient.withWorkspace(process.env.PERMUTE_WORKSPACE_ID!);

const result = await client.datasets.download('data_quickbooks123');

Response

json
{
  "data": {
    "url": "https://datasets.example.com/signed-download"
  }
}