> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pinata

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

![Pinata logo](https://mintcdn.com/composio-preview/gqjBKmmJCINafaiK/images/toolkits/pinata.svg?fit=max\&auto=format\&n=gqjBKmmJCINafaiK\&q=85\&s=aa45d8dfd099dd89e0a4f7ee0ed13056)

* **Category:** content & files
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 9
* **Triggers:** 0
* **Slug:** `PINATA`
* **Version:** 00000000\_00

## Tools

> [accordion] Create Public Group
>
> **Slug:** `PINATA_CREATE_PUBLIC_GROUP`
>
> Create a group for organizing files on the connected account's public IPFS network. The connected Pinata JWT must include org:groups:write.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name for the new group (maximum 50 characters).
>
> **is\_public** `boolean`
>
> Pinata's visibility flag for the group; this does not change the fixed public IPFS network.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Signed Public Upload URL
>
> **Slug:** `PINATA_CREATE_SIGNED_PUBLIC_UPLOAD_URL`
>
> Create 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
>
> **filename** `string` *required*
>
> Filename authorized by the signed upload URL.
>
> **group\_id** `string`
>
> Optional public-network group ID to associate with the uploaded file.
>
> **metadata** `object`
>
> Optional string key-value metadata to attach to the uploaded file; each value may contain at most 250 characters.
>
> **cid\_version** `string ("v0" | "v1" | "unixfs-v1-2025")`
>
> CID format for the eventual upload. Use v1 unless compatibility requires another value.
>
> **max\_file\_size** `integer` *required*
>
> Maximum upload size in bytes permitted by the signed upload URL.
>
> **allow\_mime\_types** `array` *required*
>
> Allowed MIME types for the upload, such as \['text/plain']; at least one is required.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Public Group
>
> **Slug:** `PINATA_DELETE_PUBLIC_GROUP`
>
> Permanently 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
>
> **group\_id** `string` *required*
>
> Pinata ID of the public-network group to permanently delete. Deleting the group does not delete the files it organized.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Public Group
>
> **Slug:** `PINATA_GET_PUBLIC_GROUP`
>
> Return one public-network group by its Pinata group ID. The connected Pinata JWT must include org:groups:read.
>
> #### Input Parameters
>
> **group\_id** `string` *required*
>
> Pinata ID of the public-network group to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Gateways
>
> **Slug:** `PINATA_LIST_GATEWAYS`
>
> Return 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
>
> **page\_size** `integer`
>
> Maximum gateways to return in this page. Omit to use Pinata's default.
>
> **next\_cursor** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Public Files
>
> **Slug:** `PINATA_LIST_PUBLIC_FILES`
>
> Return 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
>
> **cid** `string`
>
> Filter files by IPFS content identifier (CID).
>
> **name** `string`
>
> Filter files by name.
>
> **limit** `integer`
>
> Maximum files to return in this page. Omit to use Pinata's default.
>
> **order** `string ("ASC" | "DESC")`
>
> Sort by creation time in ascending or descending order.
>
> **group\_id** `string`
>
> Filter files by the ID of a public-network group.
>
> **mime\_type** `string`
>
> Filter files by MIME type, such as text/plain or image/png.
>
> **cid\_pending** `boolean`
>
> When true, return only files still waiting for a CID.
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Public Groups
>
> **Slug:** `PINATA_LIST_PUBLIC_GROUPS`
>
> Return 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
>
> **name** `string`
>
> Filter groups by name.
>
> **limit** `integer`
>
> Maximum groups to return in this page. Omit to use Pinata's default.
>
> **is\_public** `boolean`
>
> Filter by Pinata's group visibility flag; this does not change the fixed public IPFS network.
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Upload Metadata
>
> **Slug:** `PINATA_LIST_UPLOAD_METADATA`
>
> List 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
>
> **limit** `integer`
>
> Maximum metadata records to return in this page (1-100).
>
> **reverse** `boolean`
>
> Reverse Pinata's default metadata ordering.
>
> **next\_cursor** `string`
>
> Cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Public Group
>
> **Slug:** `PINATA_UPDATE_PUBLIC_GROUP`
>
> Update the name, visibility flag, or both for one public-network group. The connected Pinata JWT must include org:groups:write.
>
> #### Input Parameters
>
> **name** `string`
>
> New group name (maximum 50 characters). At least one of name or is\_public is required.
>
> **group\_id** `string` *required*
>
> Pinata ID of the public-network group to update.
>
> **is\_public** `boolean`
>
> New value for Pinata's group visibility flag. At least one of name or is\_public is required.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
