What makes Pinata API notable?

1.9K downloads. Trust evidence available

How should Pinata API be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Pinata API

Pinata IPFS API for file storage, groups, gateways, signatures, x402 payments, and file vectorization. Skill: Pinata API Owner: pinata Summary: Pinata IPFS API for file storage, groups, gateways, signatures, x402 payments, and file vectorization. Tags: latest:1.0.10 Version history: v1.0.10 | 2026-04-22T16:52:31.191Z | user No user-facing changes in this release. Transferring ownership to the Pinata org. - Version bumped to 1.0.10. - No file changes detected. v1.0.9 | 2026-02-20T15:31:47.591Z | user - Environment vari

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.9k

Updated

Oct 9, 2026

Version

1.0.10

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.9K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 1.9K downloadsadoption · observed Oct 9, 2026
Latest release: 1.0.10release · observed Apr 22, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s1796rems26khtzmdz8vvf4s9985b2s3:pinata-api

Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-pinata-pinata-api/snapshot"

Documentation

CLAWHUB

71,450 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: pinata-api
description: Pinata IPFS API for file storage, groups, gateways, signatures, x402 payments, and file vectorization.
homepage: https://pinata.cloud
metadata: {"openclaw": {"emoji": "📌", "requires": {"env": ["PINATA_JWT", "PINATA_GATEWAY_URL"]}, "primaryEnv": "PINATA_JWT"}}
---

# Pinata API

Access the Pinata IPFS storage API. Upload files, manage groups, create gateways, add signatures, set up x402 payments, and perform AI-powered vector search.

Repo: https://github.com/PinataCloud/pinata-api-skill

## Authentication

All requests require the header:

```
Authorization: Bearer $PINATA_JWT
```

**Environment Variables:**

- `PINATA_JWT` (required) - Your Pinata API JWT token. Get one at [app.pinata.cloud/developers/api-keys](https://app.pinata.cloud/developers/api-keys)
- `PINATA_GATEWAY_URL` (required) - Your Pinata gateway domain (e.g., `your-gateway.mypinata.cloud`). Find yours at [app.pinata.cloud/gateway](https://app.pinata.cloud/gateway)
- `PINATA_GATEWAY_KEY` (optional) - Gateway key for accessing public IPFS content not tied to your Pinata account. See [Gateway Access Controls](https://docs.pinata.cloud/gateways/gateway-access-controls#gateway-keys)

### Test Authentication

```
GET https://api.pinata.cloud/data/testAuthentication
```

## Base URLs

- **API:** `https://api.pinata.cloud`
- **Uploads:** `https://uploads.pinata.cloud`

## Common Parameters

- `{network}` - IPFS network: `public` (default) or `private`
- Pagination uses `limit` and `pageToken` query parameters

## Files

### Search Files

```
GET https://api.pinata.cloud/v3/files/{network}
```

Query parameters (all optional): `name`, `cid`, `mimeType`, `limit`, `pageToken`

### Get File by ID

```
GET https://api.pinata.cloud/v3/files/{network}/{id}
```

### Update File Metadata

```
PUT https://api.pinata.cloud/v3/files/{network}/{id}
Content-Type: application/json
```

Body:

```json
{
  "name": "new-name",
  "keyvalues": {"key": "value"}
}
```

Both fields are optional.

### Delete File

```
DELETE https://api.pinata.cloud/v3/files/{network}/{id}
```

### Upload File

```
POST https://uploads.pinata.cloud/v3/files
Content-Type: multipart/form-data
```

Form fields:
- `file` (required) - The file to upload
- `network` (optional) - `public` or `private`
- `group_id` (optional) - Group to add the file to
- `keyvalues` (optional) - JSON string of key-value metadata

## Groups

### List Groups

```
GET https://api.pinata.cloud/v3/groups/{network}
```

Query parameters (all optional): `name`, `limit`, `pageToken`

### Create Group

```
POST https://api.pinata.cloud/v3/groups/{network}
Content-Type: application/json
```

Body:

```json
{
  "name": "my-group"
}
```

### Get Group

```
GET https://api.pinata.cloud/v3/groups/{network}/{id}
```

### Update Group

```
PUT https://api.pinata.cloud/v3/groups/{network}/{id}
Content-Type: application/json
```

Body:

```json
{
  "name": "updated-name"
}
```

### Delete Group

```
DELETE https://api.pinata.cloud/v3/g

_meta.json

{
  "ownerId": "kn75pszqsdbzq42x925mcdpc9d812x85",
  "slug": "pinata-api",
  "version": "1.0.10",
  "publishedAt": 1776876751191
}

skill-card.md

## Description:

Pinata IPFS API for file storage, groups, gateways, signatures, x402 payments, and file vectorization.

This skill is ready for commercial/non-commercial use.

## Publisher:

[pinata](https://clawhub.ai/user/pinata)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and agents use this skill to call the Pinata IPFS API for file storage, metadata and group management, gateway links, signed uploads/downloads, x402 payment instructions, and vector search.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill uses a Pinata JWT that can manage Pinata/IPFS resources in the user's account.

Mitigation: Use a scoped Pinata API token where possible and install the skill only when account-level Pinata API access is intended.

Risk: API requests can delete files or groups, create signed links, vectorize private content, or configure x402 payment instructions.

Mitigation: Review agent-proposed requests before execution, especially destructive operations, signed upload or download links, private-content vectorization, and payment-related changes.

## Reference(s):

- [Pinata Skill Page](https://clawhub.ai/pinata/skills/pinata-api)
- [Pinata Documentation](https://docs.pinata.cloud)
- [Pinata API Keys](https://app.pinata.cloud/developers/api-keys)
- [Gateway Setup](https://docs.pinata.cloud/gateways)
- [Gateway Access Controls](https://docs.pinata.cloud/gateways/gateway-access-controls#gateway-keys)
- [x402 Protocol](https://docs.pinata.cloud/x402)
- [Source (GitHub, artifact-listed resource; not server-resolved provenance)](https://github.com/PinataCloud/pinata-api-skill)

## Skill Output:

**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]

**Output Format:** [Markdown with HTTP examples, JSON request bodies, and configuration guidance]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Uses PINATA_JWT and PINATA_GATEWAY_URL environment variables; outputs may include authenticated Pinata API requests for account resources.]

## Skill Version(s):

1.0.10 (source: release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 6h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular