Skip to main content
Upload an array of files to Pinata as a folder

​
Usage

import { PinataSDK } from "pinata";

const pinata = new PinataSDK({
  pinataJwt: process.env.PINATA_JWT!,
  pinataGateway: "example-gateway.mypinata.cloud",
});

const file1 = new File(["hello world!"], "hello.txt", { type: "text/plain" })
const file2 = new File(["hello world again!"], "hello2.txt", { type: "text/plain" })
const upload = await pinata.upload.public.fileArray([file1, file2])

​
Returns

type UploadResponse = {
	id: string;
	name: string;
	cid: string;
	size: number;
	created_at: string;
	number_of_files: number;
	mime_type: string;
	group_id: string | null;
	keyvalues: {
		[key: string]: string;
	};
	vectorized: boolean;
	network: string;
};

​
Parameters

​
file

  • Type: File[] object
Accepts an array of File objects in accordance with the W3C File API. 
const file1 = new File([blob1], "hello1.txt", { type: "text/plain" })
const file2 = new File([blob2], "hello2.txt", { type: "text/plain" })
const upload = await pinata.upload.public.fileArray([file1, file2])

​
group (Optional)

  • Type: string
Upload to a specific group by passing in the groupId 
const upload = await pinata.upload.public
  .fileArray([file1, file2])
  .group("b07da1ff-efa4-49af-bdea-9d95d8881103")

​
keyvalues (Optional)

  • Type: Record<string, string>
Add optional keyvalues to file 
const upload = await pinata.upload.public
  .fileArray([file1, file2])
  .keyvalues({
    env: "prod"
  })

​
name (Optional)

  • Type: string
Add optional name to file 
const upload = await pinata.upload.public
  .fileArray([file1, file2])
  .name("folder")

​
key (Optional)

  • Type: string
Upload a file using a secondary API key generated through keys.create() 
const upload = await pinata.upload.public
  .fileArray([file1, file2])
  .key("GENERATED_API_JWT")

​
url (Optional)

  • Type: string
Pass in a presigned upload URL created with createSignedURL 
const upload = await pinata.upload.public
  .fileArray([file1, file2])
  .url(url)
⌘I