9 available actions

What your AI agent can do in Pinata

Manage public IPFS files and groups, inspect gateways and upload metadata, and create constrained signed upload URLs through Pinata's V3 APIs. This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.

Common starting points

  • Get Public GroupReturn one public-network group by its Pinata group ID.
  • List GatewaysReturn one page of gateways owned by the connected Pinata account without changing gateway configuration.
  • Create Public GroupCreate a group for organizing files on the connected account's public IPFS network.
  • Create Signed Public Upload URLCreate a 60-second signed URL for one size- and MIME-constrained public IPFS upload.
  • Update Public GroupUpdate the name, visibility flag, or both for one public-network group.
  • Delete Public GroupPermanently delete one public-network group by ID.

Browse all 9 actions by capability

Open a capability to see every supported action and its description.

Find & reviewLook up and review existing recordsView 5 actionsHide actions
  • Get Public GroupReturn one public-network group by its Pinata group ID.
  • List GatewaysReturn one page of gateways owned by the connected Pinata account without changing gateway configuration.
  • List Public FilesReturn one page of files on the connected account's public IPFS network, optionally filtered by file attributes.
  • List Public GroupsReturn one page of groups that organize files on the connected account's public IPFS network.
  • List Upload MetadataList upload-service records, including upload IDs, filenames, CIDs, sizes, group IDs, and timestamps.
Create & communicateCreate records or send supported messagesView 2 actionsHide actions
  • Create Public GroupCreate a group for organizing files on the connected account's public IPFS network.
  • Create Signed Public Upload URLCreate a 60-second signed URL for one size- and MIME-constrained public IPFS upload.
Update & manageChange and manage existing recordsView 1 actionHide actions
  • Update Public GroupUpdate the name, visibility flag, or both for one public-network group.
Remove & cancelRemove records or cancel supported workView 1 actionHide actions
  • Delete Public GroupPermanently delete one public-network group by ID.

Connection record

A connection you can control.

Sign-in
Customer-managed key
Setup
Use a key you create and control. It is stored securely and limited to the work agreed for the role.
Boundaries
Only the approved role and actions.
Off switch
Revoke the connection from your account.

FAQ

Before you connect Pinata

How does the agent connect to Pinata?
With a key you create and control. It is stored securely, permissions are limited to what the agent needs, and you can revoke it at any time.
What can the agent actually do in Pinata?
The page above lists the 9 actions currently available through the Pinata connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.
Is Pinata included in my plan?
Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.
How long until Pinata is ready?
Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.

Bring the workflow together

Ready to put Pinata to work?

Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.

All product names, logos, and brands are property of their respective owners and are used for identification only. ZeroToClaw is not affiliated with or endorsed by Pinata.