Pinata for AI agents

Agents read Pinata at once. Changes and sends are held for a person's approval by default.

About Pinata

Manage public IPFS files and groups, inspect gateways and upload metadata, and create constrained signed upload URLs through Pinata's V3 APIs.

What an agent can do in Pinata

Every Pinata action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.

Runs at once (reads)

Looks things up in Pinata without asking first. 5 actions.

  • Get Public GroupReturn one public-network group by its Pinata group ID. The connected Pinata JWT must include org:groups:read.
  • List GatewaysReturn one page of gateways owned by the connected Pinata account without changing gateway configuration. The connected Pinata JWT must include org:gateways:read.
  • List Public FilesReturn one page of files on the connected account's public IPFS network, optionally filtered by file attributes. The connected Pinata JWT must include org:files:read.
  • List Public GroupsReturn one page of groups that organize files on the connected account's public IPFS network. The connected Pinata JWT must include org:groups:read.
  • List Upload MetadataList upload-service records, including upload IDs, filenames, CIDs, sizes, group IDs, and timestamps. Use List Public Files instead to search the public IPFS file inventory.

Held for approval by default (changes and sends)

Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 4 actions.

  • Create Public GroupCreate a group for organizing files on the connected account's public IPFS network. The connected Pinata JWT must include org:groups:write.
  • Create Signed Public Upload URLCreate a 60-second signed URL for one size- and MIME-constrained public IPFS upload. The URL is a secret: use it immediately and never log or persist it. This action does not upload content itself. Th
  • Delete Public GroupPermanently delete one public-network group by ID. This destructive action does not delete the files the group organized. The connected Pinata JWT must include org:groups:write.
  • Update Public GroupUpdate the name, visibility flag, or both for one public-network group. The connected Pinata JWT must include org:groups:write.

Changes wait in Needs you

Changes and sends in Pinata are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

How approvals work

Pinata questions

Can an agent change data in Pinata on its own?

Not by default. Changes and sends in Pinata are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

What can an agent read in Pinata?

This connector lists 5 read actions. Reads run at once, without waiting for approval.

How does Pinata connect?

It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.

Bring Pinata to your agents.