---
title: "Pinata integration for LuumenAI"
url: "https://www.luumen.ai/integrations/pinata/"
entity: SoftwareIntegration
category: "Knowledge & documentation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Pinata integration for LuumenAI

Inspect public IPFS files, groups, and gateways, then make changes with approval

## What LuumenAI can do with Pinata

LuumenAI connects to Pinata with an API token and exposes 9 tools (5 read-only · 3 write · 1 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 9 tools (5 read-only · 3 write · 1 destructive)
- Plan: available on all plans
- Category: Knowledge & documentation

## About Pinata with LuumenAI

Connect Pinata and your agent can read the state of your public IPFS account directly: which files are pinned, how they are grouped, what the upload service recorded, and which gateways serve them. Changes — creating or renaming a group, issuing a short-lived signed upload URL — are previewed and approved before they run. Luumen authenticates with an API key.

## Example tools

Read-only (5 in total):

- `PINATA_GET_PUBLIC_GROUP` — Return one public-network group by its Pinata group ID.
- `PINATA_LIST_GATEWAYS` — Return one page of gateways owned by the connected Pinata account without changing gateway configuration.
- `PINATA_LIST_PUBLIC_FILES` — Return one page of files on the connected account's public IPFS network, optionally filtered by file attributes.
- `PINATA_LIST_PUBLIC_GROUPS` — Return one page of groups that organize files on the connected account's public IPFS network.
- `PINATA_LIST_UPLOAD_METADATA` — List upload-service records, including upload IDs, filenames, CIDs, sizes, group IDs, and timestamps.

Write and destructive (4 in total, approval required by default):

- `PINATA_CREATE_PUBLIC_GROUP` — Create a group for organizing files on the connected account's public IPFS network.
- `PINATA_CREATE_SIGNED_PUBLIC_UPLOAD_URL` — Create a 60-second signed URL for one size- and MIME-constrained public IPFS upload.
- `PINATA_DELETE_PUBLIC_GROUP` — Permanently delete one public-network group by ID.
- `PINATA_UPDATE_PUBLIC_GROUP` — Update the name, visibility flag, or both for one public-network group.

## Frequently asked questions

### How does LuumenAI connect to Pinata?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Pinata on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 1 action classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Pinata — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/pinata/