file

org:files:write

Upload a single file to Pinata

Usage

import { PinataSDK } from "pinata";

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

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

Local Files

If you need to upload files from a local file source you can use fs to feed a file into a blob, then turn that blob into a File.

const { PinataSDK } = require("pinata")
const fs = require("fs")
const { Blob } = require("buffer")

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

const blob = new Blob([fs.readFileSync("./hello-world.txt")]);
const file = new File([blob], "hello-world.txt", { type: "text/plain"})
const upload = await pinata.upload.public.file(file);

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 a File object in accordance with the W3C File API.

const blob = new Blob(["hello world!"], { type: "text/plain" })
const file = new File([blob], "hello.txt", { type: "text/plain" })
const upload = await pinata.upload.public.file(file)

In most environments you can also pass a Blob here as well.

const blob = new Blob(["hello world!"], { type: "text/plain" })
const upload = await pinata.upload.public.file(blob)

group (Optional)

• Type: string

Upload to a specific group by passing in the groupId

const upload = await pinata.upload.public
  .file(file)
  .group("b07da1ff-efa4-49af-bdea-9d95d8881103")

keyvalues (Optional)

• Type: Record<string, string>

Add optional keyvalues to file

const upload = await pinata.upload.public
  .file(file)
  .keyvalues({
    env: "prod"
  })

name (Optional)

• Type: string

Add optional name to file

const upload = await pinata.upload.public
  .file(file)
  .name("hello.txt")

url (Optional)

• Type: string

Pass in a presigned upload URL created with createSignedURL

const upload = await pinata.upload.public
  .file(file)
  .url(url)

key (Optional)

• Type: string

Upload a file using a secondary API key generated through keys.create()

const upload = await pinata.upload.public
  .file(file)
  .key("GENERATED_API_JWT")

car (Optional)

• Type: boolean

Upload a file as a raw CAR file

const upload = await pinata.upload.public
  .file(file)
  .car()

expires (Optional)

• Type: number

Set an expiration date for the file using a Unix timestamp. The timestamp must be in the future. Once the expiration time is reached, the file will be automatically deleted.

const upload = await pinata.upload.public
  .file(file)
  .expires(1735689600)