# Pinata integration

> IPFS file storage and delivery: upload and pin public or private files, manage groups, gateways, signed links, API keys and x402 payments, plus the hosted Agents API.

- Authentication: apiKey

## Tools (269)

- **Add blocker**: Mark `:issueId` as blocked by `blockingIssueId`.
- **Add checklist item**: Add checklist item.
- **Add CIDs to Group (Legacy)**: Add CIDs to Group.
- **Add CID to Payment Instruction**: Associates a CID with a payment instruction.
- **Add comment**: Add a threaded comment to an issue.
- **Add cron job**: Create a new cron job.
- **Add File To Group**: Add File To Group.
- **Add secrets to agent**: Attach one or more user secrets to an existing agent.
- **Add Signature to CId**: Add Signature to CId.
- **Add skills to agent**: Attach one or more skills from the library to an existing agent.
- **Add Swap**: Add Swap.
- **Approve a device**: Approve a specific device pairing request by ID.
- **Approve all pending devices**: Approve all pending device pairing requests.
- **Approve issue**: Mark a review issue as done, keeping the agent workspace changes.
- **Approve issue and merge PR**: Run the approve flow (creates the PR if missing, marks the issue done) then merge the PR.
- **Archive an issue**: Move an issue into the archive (status becomes `archived`).
- **Archive submission**: Soft-delete a template submission by setting its status to `archived`.
- **Assign issue to its agent**: Move a backlog issue into the assigned queue.
- **Begin GitHub OAuth**: Returns the GitHub authorize URL the SPA should navigate to.
- **Browse ClawHub skills**: Browse community-published skills on ClawHub.
- **Cancel an in-flight issue**: Cancel an `assigned` (queued) or `running` issue, freeing the agent job, and move it back to the backlog so the user can edit and re-queue it.
- **Cancel Request**: Cancel Request.
- **Check for openclaw updates**: Check the currently installed openclaw version and the latest available version from npm.
- **Check for skill updates**: Check all attached skills for available version updates.
- **Check repo access for connected GitHub integrations**: Reports whether the workspace's connected GitHub account(s) can pull, push, or admin a specific repo, using the non-mutating GET /repos endpoint.
- **Clear review request**: Remove the requested reviewer without changing the issue's status.
- **Clone a GitHub repo into the agent workspace**: Clones `https://github.com/{owner}/{repo}` into the agent's workspace directory using the workspace owner's stored GitHub OAuth token.
- **Close a preview port**: Tear down the issue's preview port forward and clear the issue's preview columns.
- **Close a pull request without merging**: Close a pull request without merging.
- **Comment on a pull request**: Comment on a pull request.
- **Configure a channel**: Configure a channel.
- **Configure multiple channels at once**: Configures all provided channels in a single operation with one Pinclaw update and one restart, avoiding race conditions when multiple channels are configured together.
- **Create agent**: Create a new agent with optional skills and secrets.
- **Create a model chat**: Create a new BYOK test-chat for a model (sequentially titled, capped per user).
- **Create an API key**: Create a Pinata API key.
- **Create API Key**: Create API Key.
- **Create a template from an agent**: Snapshot one of your running agents and publish it as a marketplace template.
- **Create board**: Create a new board.
- **Create Custom Domain for Gateway**: Create Custom Domain for Gateway.
- **Create Download Link**: Create Download Link.
- **Create Gateway**: Create Gateway.
- **Create Gateway Host Origin Restriction**: Create Gateway Host Origin Restriction.
- **Create Gateway IP Address Restriction**: Create Gateway IP Address Restriction.
- **Create Gateway Key Restriction**: Create Gateway Key Restriction.
- **Create Group**: Create Group.
- **Create Group (Legacy)**: Create Group.
- **Create issue**: Create a new issue in the backlog column.
- **Create issue PR**: Open a pull request for the issue's pushed branch with an optional title and description.
- **Create Payment Instruction**: Creates a new payment instruction.
- **Create secret**: Create a new encrypted secret for the authenticated user.
- **Create Signed Upload URL**: Create Signed Upload URL.
- **Create skill**: Register a new skill in the library.
- **Create skill version**: Upload a new version for an existing skill.
- **Create snapshot**: Manually create a snapshot of the agent workspace.
- **Data Usage (Legacy)**: Retrieve your current data usage for your Pinata account.
- **Delete agent**: Delete this agent and destroy its container.
- **Delete a model chat**: Soft-delete a chat (history is preserved; a new chat for the model can be created later).
- **Delete attachment**: Remove an attachment from a `backlog` issue.
- **Delete board**: Soft-delete a board and reassign its issues to the next active board.
- **Delete checklist item**: Delete checklist item.
- **Delete comment**: Delete your own comment.
- **Delete File by ID**: Delete File by ID.
- **Delete File (Unpin) (Legacy)**: Delete a file by CID.
- **Delete File Vectors**: Delete File Vectors.
- **Delete Gateway**: Delete Gateway.
- **Delete Gateway Custom Domain**: Delete Gateway Custom Domain.
- **Delete Group**: Delete Group.
- **Delete Group (Legacy)**: Delete Group.
- **Delete issue**: Permanently delete an issue.
- **Delete issue template**: Delete issue template.
- **Delete Payment Instruction**: Deletes a payment instruction (soft delete).
- **Delete secret**: Delete a secret.
- **Delete skill**: Remove a skill from the library.
- **Disable a model**: Remove a model from the account-wide enabled set.
- **Disable Pinata LLM**: Revokes the Pinata LLM key and removes all associated secrets.
- **Disconnect all GitHub integrations (legacy)**: Disconnect all GitHub integrations (legacy).
- **Disconnect a single GitHub integration**: Disconnect a single GitHub integration.
- **Duplicate issue**: Create a new backlog issue with the same title, prompt, agent, repo, tags, and attachments.
- **Edit comment**: Edit your own comment.
- **Edit issue**: Edit prompt / preview URL override / agent / repo (backlog only); rename title or change human assignee at any status.
- **Enable a model**: Enable a model account-wide for the per-agent picker (idempotent — re-enabling refreshes the label).
- **Enable Pinata LLM**: Generates an Ed25519 key pair.
- **Execute command**: Execute a shell command in the agent container and return the output.
- **Gateway Custom Domain Details**: Gateway Custom Domain Details.
- **Gateway Details**: Gateway Details.
- **Gateway Domain Available**: Gateway Domain Available.
- **Generate Pinata API Key (Legacy)**: Create a Pinata API key.
- **Get agent details**: Get agent details and process status.
- **Get agent identity**: Returns this agent's identity and owning user info.
- **Get agent logs**: Read the latest 100 lines from the agent log files inside the container.
- **Get agent snapshots**: Get the latest workspace snapshots (up to 10 entries).
- **Get a Group (Legacy)**: Get a Group.
- **Get a model chat**: A chat with its replayed transcript.
- **Get a pull request**: Get a pull request.
- **Get available agent versions**: Get the list of available agent image versions, the compatibility matrix, and the current version state of this agent.
- **Get channel statuses**: Get channel statuses.
- **Get ClawHub skill**: Get a single ClawHub skill by its slug.
- **Get cron job run history**: Retrieve run history for a cron job.
- **Get domain verification challenge**: Returns the TXT record name and value that must be added to DNS before the domain can be registered.
- **Get File by ID**: Get File by ID.
- **Get gateway token**: Returns the gateway token and WebSocket URL for direct pinclaw connections.
- **Get Group**: Get Group.
- **Get issue**: Get a single issue by id.
- **Get issue PR state + comments**: Refresh the PR state from GitHub (so externally-merged PRs reflect correctly) and return the merged comment thread (issue + review + inline).
- **Get Marketplace Plugin Details**: Get Marketplace Plugin Details.
- **Get Payment Instruction**: Retrieves a specific payment instruction by ID.
- **Get Pinata LLM status**: Returns whether Pinata LLM is enabled for the authenticated user.
- **Get platform token**: Exchange the gateway token for a short-lived (1h) platform JWT.
- **Get port forwarding rules**: Returns all path-based port forwarding rules configured for this agent.
- **Get run log**: Fetch recent cron run entries for a running issue.
- **Get Signature for a CID**: Get Signature for a CID.
- **Get Swap History**: Get Swap History.
- **Get sync status**: Check storage configuration and last sync timestamp.
- **Get template by ID**: Get a published template by its internal ID.
- **Get template by slug**: Get a template by its URL-friendly slug.
- **GitHub connection status**: GitHub connection status.
- **Install ClawHub skill**: Install a ClawHub skill into your personal skills library.
- **Install Gateway Plugin**: Install Gateway Plugin.
- **Issue activity timeline**: Return user_activity rows scoped to this issue, newest first.
- **Issue cost summary**: Aggregated agent spend (USD + tokens) across the authenticated user's issues, optionally scoped to one board.
- **List agents**: List all agents for the authenticated user.
- **List API keys**: List the workspace's Pinata API keys.
- **List API Keys**: List API Keys.
- **List API Keys (Legacy)**: List all API keys for your account.
- **List a pull request's comments**: List a pull request's comments.
- **List attached skills**: List all skills currently attached to this agent.
- **List attachments**: List every file attached to this issue.
- **List available engines**: List available agent engines.
- **List blockers**: Return both upstream blockers (`dependsOn`) and downstream dependents (`blocks`) for the issue.
- **List boards**: List the user's boards.
- **List checklist items**: List checklist items.
- **List CIDs for Payment Instruction**: Returns a paginated list of CIDs associated with a payment instruction.
- **List comments**: Return every comment on this issue, oldest first.
- **List connected GitHub integrations**: List connected GitHub integrations.
- **List cron jobs**: List all cron jobs for this agent.
- **List custom domains**: Returns all domain mappings for this agent, including auto-generated subdomains and custom domains.
- **List devices**: List pending and paired devices for this agent.
- **List directory contents**: List the immediate children of a directory inside the agent container.
- **List enabled models**: The account's models enabled for the per-agent model picker.
- **List Files**: List Files.
- **List Files (Legacy)**: List all the files on your Pinata account.
- **List Gateway Plugins**: List Gateway Plugins.
- **List Gateways**: List Gateways.
- **List GitHub repositories across connected integrations**: Returns the most recently-updated repositories visible to each connected GitHub integration, merged and de-duplicated by full name.
- **List Groups**: List Groups.
- **List Groups (Legacy)**: List Groups.
- **List Installed Plugins for Gateway**: List Installed Plugins for Gateway.
- **List issues**: List all issues for the authenticated user.
- **List Marketplace Plugins**: List Marketplace Plugins.
- **List model chats**: The user's saved BYOK test-chats, most-recently-active first.
- **List Payment Instructions**: Returns a paginated list of payment instructions.
- **List Pin By CID Jobs (Legacy)**: List all currently running pinByHash jobs.
- **List Plugins Installed on Gateway**: List Installed Plugins for Gateway.
- **List provider catalogs**: Connected BYOK providers and their model catalogs (live + cached when a key is present or for OpenRouter, else the curated subset).
- **List queued revisions**: Pending follow-up revisions parked while the agent works, oldest first (drain order).
- **List repo branches**: List branches for a public GitHub/GitLab repository.
- **List repo branches and tags**: List branches and tags for a public GitHub/GitLab repository.
- **List run history**: List persisted snapshots of prior agent runs for this issue (one per past revision).
- **List saved repositories**: Return the repositories this user has saved for quick selection on new issues.
- **List saved templates**: List saved templates.
- **List secrets**: List all secrets for the authenticated user.
- **List skills**: List all available skills in the library.
- **List skill versions**: List all versions of a skill, newest first.
- **List tag colors**: Return the map of { tagLower → color } for the calling user.
- **List templates**: List published pre-built agent templates from ecosystem partners.
- **List the workspace owner's GitHub repositories**: Returns the 100 most recently-updated repositories the connected GitHub user can see.
- **List tool-call timeline**: Return every tool the agent invoked during the issue run, in emission order.
- **Mark ready for review**: Snapshot the agent workspace and move the issue into the Review column.
- **Merge a pull request**: Merge a pull request.
- **Merge issue PR**: Merge the pull request of an issue that already has one (typically a `done` issue whose PR was left open).
- **Model overview**: Joined, model-centric overview: one entry per model the user has adopted (enabled for the picker and/or has test-chats), merging both facets keyed by (provider, modelId).
- **Move self-driven issue**: Move a self-driven issue (one with no agent assigned) into a different column.
- **Nudge dispatcher**: Run the dispatcher for every agent that owns at least one assigned issue.
- **Open a pull request**: Opens a PR on `{owner}/{repo}` from `head` into `base` (base defaults to the repo default branch).
- **Pin by CID**: Pin by CID.
- **Pin By CID (Legacy)**: Upload a file already on the IPFS network to Pinata.
- **Pin File to IPFS (Legacy)**: Upload a file to Pinata to be pinned to IPFS.
- **Pin JSON (Legacy)**: Uploads a JSON object to Pinata and pins it to IPFS.
- **Preview a template draft from an agent**: Derive an editable template draft from one of your agents (engine, snapshot, included skills, required-secret names, routes, scripts, tasks, and suggested marketplace copy) without writing anything.
- **Pull, fetch, or push a cloned GitHub repo**: Pull, fetch, or push a cloned GitHub repo.
- **Query File Vectors**: Query File Vectors.
- **Query Pin Requests**: Query Pin Requests.
- **Read agent file**: Read a file from the agent container and return its binary contents with the appropriate content type.
- **Read openclaw config**: Read the raw openclaw.json configuration file from the agent container.
- **Re-check issue diff**: Recompute a finished issue's Files-Changed diff from its branch worktree and rewrite the stored result, without re-running the agent.
- **Register a preview port**: Called by the agent (via the @pinata/platform skill) once its dev server is bound to a port.
- **Register custom domain**: Register a new subdomain or custom domain for this agent.
- **Reject issue**: Revert the agent workspace to the pre-run snapshot and mark the issue rejected.
- **Remove a channel**: Remove a channel.
- **Remove a queued revision**: Drop a queued revision before it is drained.
- **Remove a saved repository**: Remove a saved repository.
- **Remove blocker**: Drop the edge `:issueId → :blockingIssueId`.
- **Remove CID from Payment Instruction**: Removes a CID association from a payment instruction.
- **Remove CIDs from a Group (Legacy)**: Remove CIDs from a Group.
- **Remove cron job**: Delete a cron job.
- **Remove custom domain**: Remove a custom domain mapping and release the subdomain or custom domain for reuse.
- **Remove File From Group**: Remove File From Group.
- **Remove secret from agent**: Detach a secret from this agent.
- **Remove Signature from CID**: Remove Signature from CID.
- **Remove skill from agent**: Detach a skill from this agent and remove its files from the agent workspace.
- **Remove Swap**: Remove Swap.
- **Rename a model chat**: Rename a model chat.
- **Rename a saved repository**: Update a saved repository's friendly label.
- **Reopen a done issue**: Reopen a `done` agent-driven issue — the inverse of approve.
- **Reorder checklist items**: Set the new position of every checklist item in one call.
- **Reorder issue**: Reorder a issue within its column (backlog only).
- **Repair failed deployment scripts**: Dispatch an agent turn that diagnoses and fixes the failed build/start step (editing code/config/deps as needed), then re-runs the lifecycle scripts.
- **Report a local run**: Write the result of a locally-run turn (diff, summary, cost, branch/PR) onto a self-driven issue (one with no agent assigned), and — unless `moveToReview` is false — move it running/assigned → review.
- **Request review from a human**: Tag a workspace member as the requested reviewer.
- **Reset to snapshot**: Reset the agent workspace to a specific snapshot by its CID.
- **Resolve a merge conflict**: Re-dispatch the issue's agent to merge the base branch into its branch, resolve the conflicts that blocked the PR, and push so the PR becomes mergeable.
- **Restart agent gateway**: Restart the agent pod.
- **Restore archived issue**: Move a `failed`, `rejected`, or `archived` issue back to the backlog so it can be edited and re-queued.
- **Retry issue**: Re-run a `review` issue as a fresh attempt of its original request — no follow-up prompt, no "build on prior work" framing.
- **Retry manifest scripts**: Re-read manifest.json and launch the build/start lifecycle scripts in the background.
- **Re-validate a saved secret**: Re-probe a saved AI-provider key against the provider to report whether it still works (valid / invalid / error).
- **Revise issue**: Schedule a follow-up agent run on top of the current result.
- **Revoke an API key**: Revoke an API key.
- **Revoke API Key**: Revoke API Key.
- **Revoke API Key (Legacy)**: Revoke API Key.
- **Revoke Gateway Key**: Revoke Gateway Key.
- **Revoke Host Origin Restriction**: Revoke Host Origin Restriction.
- **Revoke IP Address Restricton**: Revoke IP Address Restricton.
- **Rotate gateway token**: Generates a new gateway token for the agent, updates the database, and syncs to the container.
- **Run cron job now**: Trigger a cron job to run immediately.
- **Save a repository**: Register a git URL for the user.
- **Save issue template**: Save issue template.
- **Search repo branches and tags**: Search branches and tags by name.
- **Send a chat turn (SSE)**: Stream one BYOK turn as Server-Sent Events.
- **Set tag color**: Assign a color to a tag, or pass `color: null` to clear the assignment so the tag renders with the neutral default chip.
- **Set the agent default model**: Set the agent's default model.
- **Set the default GitHub integration**: Mark a connection as the workspace default.
- **Snapshot the current workspace diff**: Compute the current `git diff` inside the issue worktree (committed against the base + uncommitted with untracked files marked intent-to-add).
- **Start issue branch**: Create a feature branch on origin for a repo-backed issue WITHOUT running the agent — a pure GitHub API operation.
- **Start the project dev server behind a forwarded port**: Resolve the dev-server start command for the forwarded port (the mapping's stored command, a user-edited `command`, or a fresh extraction from the project files), run it in the container — always freeing the port first so re-runs are idempotent — and return the command, its output, the server log ta
- **Start the project dev server for the issue preview**: Resolve the issue's dev-server start command (the stored one, a user-edited `command`, or a fresh extraction from the worktree's project files), run it in the agent container — always freeing the preview port first so re-runs are idempotent — and return the command, its full output, the server log t
- **Stream the running agent turn**: Server-sent events for a running issue's current agent turn.
- **Submit template**: Submit a new template from a public git repository.
- **Test Authentication (Legacy)**: Test your API keys and your ability to connect to the Pinata API.
- **Time Interval Gateway Analytics**: Time Interval Gateway Analytics.
- **Toggle cron job**: Enable or disable a cron job.
- **Top Gateway Analytics**: Top Gateway Analytics.
- **Uninstall Gateway Plugin**: Uninstall Gateway Plugin.
- **Update agent metadata**: Update this agent's name, description, vibe, or emoji.
- **Update board**: Patch a board.
- **Update checklist item**: Update checklist item.
- **Update cron job**: Update an existing cron job.
- **Update custom domain**: Update an existing custom domain mapping.
- **Update File**: Update File.
- **Update File Metadata (Legacy)**: Update File Metadata.
- **Update Group**: Update Group.
- **Update Group (Legacy)**: Update Group.
- **Update hub skill**: Re-download the latest version of an installed ClawHub skill and create a new version record.
- **Update openclaw**: Update openclaw to the latest version or a specific tag/version.
- **Update Payment Instruction**: Updates an existing payment instruction.
- **Update port forwarding rules**: Replace all port forwarding rules for this agent (max 10).
- **Update secret**: Update the encrypted value of an existing secret.
- **Update skill version on agent**: Update an attached skill to a specific version, or the latest version if no versionId is provided.
- **Update submission**: Re-validate and update an existing template submission from its git repo.
- **Update tags**: Replace the issue's tag list.
- **Upload a File**: Upload a File.
- **Upload attachment**: Attach a file to a `backlog` issue.
- **Upload file to agent workspace**: Writes a file under `<workspace>/uploads/` in the agent container and returns its absolute path.
- **Upsert a checklist item by text (interactive markdown checkbox sync)**: Match an existing item by normalized text and update its done state; or insert a new item if no match exists.
- **Validate git repo**: Validate a public git repository for template submission.
- **Validate openclaw config**: Run `openclaw config validate` against the provided config JSON.
- **Vectorize a File**: Vectorize a File.
- **Verify domain**: Two-phase verification for custom domains.
- **Write openclaw config**: Write the openclaw.json configuration file.

Connect Pinata in General Input: https://www.generalinput.com/apps/pinata