Connect Pinata to Your AI Agent

Use AI with Pinata to inspect public or private file metadata, organize groups and track public CID pin requests.

12 tools API key

Try a Pinata Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Pinata

Review File Metadata

List files on a chosen network and read a selected file record.

/oo Pinata: List files on [network] matching name [name], then get file [ID] and summarize its metadata.

Track a Public CID Pin

Request pinning an existing CID and inspect request state.

/oo Pinata: Pin public CID [CID] with name [name], then query pin requests for that CID.

Organize File Groups

Create a group and add a specified file on the selected network.

/oo Pinata: Create group [name] on [network] and add file [ID] to the new group.

Start Working with Pinata

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Pinata

    Provide a Pinata JWT from its API key settings.

    Connect Pinata →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • Pinata access to the intended network and file groups.
  • Choose public or private network for file and group actions. Pin-by-CID applies to an existing public IPFS CID and should be tracked through pin requests.

Pinata Tools

Use AI with Pinata to inspect public or private file metadata, organize groups and track public CID pin requests.

Review File Metadata

List files on a chosen network and read a selected file record.

Track a Public CID Pin

Request pinning an existing CID and inspect request state.

Organize File Groups

Create a group and add a specified file on the selected network.

12 tools

List Files

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

pinata.list_files

Get File

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

pinata.get_file

Update File

Update a Pinata file name or key-value metadata.

pinata.update_file

Delete File

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

pinata.delete_file

Pin By Cid

Ask Pinata to pin an existing public IPFS CID.

pinata.pin_by_cid

Query Pin Requests

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

pinata.query_pin_requests

List Groups

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

pinata.list_groups

Get Group

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

pinata.get_group

Create Group

Create a Pinata file group on the public or private IPFS network.

pinata.create_group

Update Group

Update a Pinata group name or public visibility setting.

pinata.update_group

Add File To Group

Add a Pinata file to a Pinata group.

pinata.add_file_to_group

Remove File From Group

Remove a Pinata file from a Pinata group.

pinata.remove_file_from_group

Frequently Asked Questions

Does pin_by_cid accept a private network file?

It pins an existing public IPFS CID. File and group operations separately require a public or private network selection.

Can I change a file’s name?

Yes. update_file changes a file name or key-value metadata on the selected network.

What should I specify in my request?

Choose public or private network for file and group actions. Pin-by-CID applies to an existing public IPFS CID and should be tracked through pin requests.

Connect Pinata

About Pinata ↗