Pinata

Pinata integration (Developer Tools, Storage). Imported from open-connector.

API key9 toolshttps://api.pinata.cloud

GET

pinata_list_files

List Pinata files from the public or private IPFS network with optional filters.

/files/{network}

10 parameters

Param	Type	Required	Description
network	string	required	The Pinata IPFS network to target.
name	string	optional	Filter files by name.
group	string	optional	Filter files by group ID. Use the string null to show files outside groups.
mimeType	string	optional	Filter files by MIME type.
cid	string	optional	Filter files by CID.
cidPending	boolean	optional	Return only files that are still waiting for a CID.
metadata	object	optional	Pinata key-value metadata. Values are sent as strings.
limit	integer	optional	Limit the number of results returned by Pinata.
order	string	optional	Sort results by creation date.
pageToken	string	optional	Pagination token returned by a previous Pinata response.

GET

pinata_get_file

Get one Pinata file by ID from the public or private IPFS network.

/files/{network}/{id}

2 parameters

Param	Type	Required	Description
network	string	required	The Pinata IPFS network to target.
id	string	required	The Pinata file or group identifier.

PUT

pinata_update_file

Update a Pinata file name or key-value metadata.

/files/{network}/{id}

4 parameters

Param	Type	Required	Description
network	string	required	The Pinata IPFS network to target.
id	string	required	The Pinata file or group identifier.
name	string	optional	The updated file name.
keyvalues	object	optional	Pinata key-value metadata. Values are sent as strings.

DELETE

pinata_delete_file

Delete one Pinata file by ID from the public or private IPFS network.

/files/{network}/{id}

2 parameters

Param	Type	Required	Description
network	string	required	The Pinata IPFS network to target.
id	string	required	The Pinata file or group identifier.

GET

pinata_query_pin_requests

Query Pinata pin-by-CID requests with optional filters and pagination.

/files/public/pin_by_cid

5 parameters

Param	Type	Required	Description
order	string	optional	Sort results by queue time.
status	string	optional	Filter pin requests by Pinata status.
cid	string	optional	Filter pin requests by CID.
limit	integer	optional	Limit the number of results returned by Pinata.
pageToken	string	optional	Pagination token returned by a previous Pinata response.

GET

pinata_list_groups

List Pinata file groups from the public or private IPFS network.

/groups/{network}

5 parameters

Param	Type	Required	Description
network	string	required	The Pinata IPFS network to target.
name	string	optional	Filter groups by name.
isPublic	boolean	optional	Filter groups by public visibility.
limit	integer	optional	Limit the number of groups returned by Pinata.
pageToken	string	optional	Pagination token returned by a previous Pinata response.

GET

pinata_get_group

Get one Pinata group by ID from the public or private IPFS network.

/groups/{network}/{groupId}

3 parameters

Param	Type	Required	Description
network	string	required	The Pinata IPFS network to target.
id	string	optional	The Pinata file or group identifier.
groupId	string	required	Path parameter: groupId

PUT

pinata_add_file_to_group

Add a Pinata file to a Pinata group.

/groups/{network}/{groupId}

3 parameters

Param	Type	Required	Description
network	string	required	The Pinata IPFS network to target.
groupId	string	required	The Pinata file or group identifier.
fileId	string	optional	The Pinata file or group identifier.

DELETE

pinata_remove_file_from_group

Remove a Pinata file from a Pinata group.

/groups/{network}/{groupId}

3 parameters

Param	Type	Required	Description
network	string	required	The Pinata IPFS network to target.
groupId	string	required	The Pinata file or group identifier.
fileId	string	optional	The Pinata file or group identifier.