← Back to Skills Marketplace
953
Downloads
1
Stars
2
Active Installs
10
Versions
Install in OpenClaw
/install pinata-api
Description
Pinata IPFS API for file storage, groups, gateways, signatures, x402 payments, and file vectorization.
Usage Guidance
This skill is an instruction-only mapping of the official Pinata HTTP API and is internally consistent with that purpose. Before installing: (1) ensure you provide a properly scoped PINATA_JWT (keep it secret and limit its permissions if possible); (2) confirm your PINATA_GATEWAY_URL is correct; (3) if you need gateway key functionality, supply PINATA_GATEWAY_KEY (SKILL.md mentions it but metadata doesn't); (4) be aware the agent will make network calls using your JWT, so only install if you trust the agent environment and the skill’s origin (the skill source is listed as unknown though the homepage and sample repo point to Pinata). If you want tighter safety, create a JWT with minimal permissions for this skill rather than using a highly privileged account token.
Capability Analysis
Type: OpenClaw Skill
Name: pinata-api
Version: 1.0.10
The pinata-api skill bundle is a legitimate integration for the Pinata IPFS service. It provides documentation and instructions for the OpenClaw agent to interact with official Pinata API endpoints (api.pinata.cloud and uploads.pinata.cloud) for file storage, group management, and x402 payments. The required environment variables (PINATA_JWT and PINATA_GATEWAY_URL) are standard for this service, and there is no evidence of data exfiltration, malicious execution, or prompt injection.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description describe Pinata API access and the skill only requires a Pinata JWT and gateway URL — exactly what's needed to call the documented endpoints.
Instruction Scope
SKILL.md contains straightforward HTTP request examples for uploading, pinning, groups, signatures, gateways, and x402 payments. It references an optional PINATA_GATEWAY_KEY env var (for gateway access control) that is not listed in the required env metadata — this is a minor documentation mismatch but not scope creep. The instructions do not ask the agent to read unrelated files or system state.
Install Mechanism
No install spec and no code files; instruction-only skills are low-risk because nothing is written to disk by the skill itself.
Credentials
Required env vars (PINATA_JWT, PINATA_GATEWAY_URL) are proportionate to the claimed functionality. The SKILL.md also mentions an optional PINATA_GATEWAY_KEY, but that optional var is not included in the metadata requires.env list — this should be reconciled. No unrelated credentials are requested.
Persistence & Privilege
always is false and the skill does not request persistent system-wide changes. The skill can be invoked autonomously (platform default), which is expected for an integration skill; no additional privileges are requested.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pinata-api - After installation, invoke the skill by name or use
/pinata-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.10
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
- Environment variable names updated: `GATEWAY_URL` → `PINATA_GATEWAY_URL`, `GATEWAY_KEY` → `PINATA_GATEWAY_KEY` throughout the documentation and metadata.
- References in sample URLs, usage instructions, and notes now consistently use `PINATA_GATEWAY_URL`.
- No changes to endpoints or API functionality. Documentation only.
v1.0.8
- Documentation has been restructured and streamlined for clarity.
- Descriptions and API examples have been reformatted for readability, using concise HTTP request formats.
- Minor change to the description: "AI-powered vector search" updated to "file vectorization."
- Added summary tables for request bodies, required and optional parameters.
- Section and endpoint headers have been standardized.
- No functional or behavioral changes to the API.
v1.0.7
No user-facing changes. Documentation formatting and example environment variable usage have been updated for clarity. No file or functional changes detected in this version.
v1.0.6
- Major cleanup: removed all source files and configuration files from the skill.
- SKILL.md documentation overhauled and converted to a new, frontmatter-based format.
v1.0.5
- Added repository link to the documentation.
- No functional or API changes.
- No user-facing updates except for documentation improvement.
v1.0.4
- Updated environment variable requirements: `GATEWAY_URL` is now required, and new optional `GATEWAY_KEY` added for accessing public IPFS content not tied to your Pinata account.
- Documentation now references Pinata's Gateway Access Controls for public gateway key usage.
v1.0.2
- Added package.json to the project to define dependencies and metadata.
v1.0.1
- Initial release of the Pinata API skill.
- Provides functions for file management, groups, gateway operations, digital signatures, payments, and AI-powered vector search on Pinata's IPFS services.
- Requires `PINATA_JWT` environment variable for authentication.
- Supports advanced actions such as signed uploads, payment instructions, and semantic search via vector embeddings.
v1.0.0
Pinata IPFS API skill for file storage, groups, gateways, and more
Metadata
Frequently Asked Questions
What is Pinata API?
Pinata IPFS API for file storage, groups, gateways, signatures, x402 payments, and file vectorization. It is an AI Agent Skill for Claude Code / OpenClaw, with 953 downloads so far.
How do I install Pinata API?
Run "/install pinata-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Pinata API free?
Yes, Pinata API is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Pinata API support?
Pinata API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Pinata API?
It is built and maintained by Pinata (@pinata); the current version is v1.0.10.
More Skills