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.
Showing all 9 actions.
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 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 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 action
- Update Public GroupUpdate the name, visibility flag, or both for one public-network group.
Remove & cancelRemove records or cancel supported workView 1 action
- 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.