Skip to main content
Pinata logo
  • Category: content & files
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 9
  • Triggers: 0
  • Slug: PINATA
  • Version: 00000000_00

Tools

Slug: PINATA_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.

Input Parameters

string
required
Name for the new group (maximum 50 characters).
boolean
Pinata’s visibility flag for the group; this does not change the fixed public IPFS network.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINATA_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. The connected Pinata JWT must include org:files:write.

Input Parameters

string
required
Filename authorized by the signed upload URL.
string
Optional public-network group ID to associate with the uploaded file.
object
Optional string key-value metadata to attach to the uploaded file; each value may contain at most 250 characters.
string ("v0" | "v1" | "unixfs-v1-2025")
CID format for the eventual upload. Use v1 unless compatibility requires another value.
integer
required
Maximum upload size in bytes permitted by the signed upload URL.
array
required
Allowed MIME types for the upload, such as [‘text/plain’]; at least one is required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINATA_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.

Input Parameters

string
required
Pinata ID of the public-network group to permanently delete. Deleting the group does not delete the files it organized.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINATA_GET_PUBLIC_GROUPReturn one public-network group by its Pinata group ID. The connected Pinata JWT must include org:groups:read.

Input Parameters

string
required
Pinata ID of the public-network group to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINATA_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.

Input Parameters

integer
Maximum gateways to return in this page. Omit to use Pinata’s default.
string
Next one-based page cursor returned by a previous call. Omit for page 1 and pass the returned value back unchanged to continue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINATA_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.

Input Parameters

string
Filter files by IPFS content identifier (CID).
string
Filter files by name.
integer
Maximum files to return in this page. Omit to use Pinata’s default.
string ("ASC" | "DESC")
Sort by creation time in ascending or descending order.
string
Filter files by the ID of a public-network group.
string
Filter files by MIME type, such as text/plain or image/png.
boolean
When true, return only files still waiting for a CID.
string
Opaque cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINATA_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.

Input Parameters

string
Filter groups by name.
integer
Maximum groups to return in this page. Omit to use Pinata’s default.
boolean
Filter by Pinata’s group visibility flag; this does not change the fixed public IPFS network.
string
Opaque cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINATA_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.

Input Parameters

integer
Maximum metadata records to return in this page (1-100).
boolean
Reverse Pinata’s default metadata ordering.
string
Cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PINATA_UPDATE_PUBLIC_GROUPUpdate the name, visibility flag, or both for one public-network group. The connected Pinata JWT must include org:groups:write.

Input Parameters

string
New group name (maximum 50 characters). At least one of name or is_public is required.
string
required
Pinata ID of the public-network group to update.
boolean
New value for Pinata’s group visibility flag. At least one of name or is_public is required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not