PinataCloud · mintlify · Jun 30, 2026
diff --git a/account-management/api-keys.mdx b/account-management/api-keys.mdx
@@ -1,5 +1,6 @@
 ---
-title: "API Keys"
+title: "API keys"
+description: "Create, scope, and revoke Pinata API keys from the dashboard, then authenticate requests to the Files API and legacy IPFS API with a JWT."
 slug: "api-keys"
 icon: "key"
 ---

diff --git a/account-management/billing.mdx b/account-management/billing.mdx
@@ -1,5 +1,6 @@
 ---
-title: "Billing"
+title: "Billing and usage"
+description: "Upgrade your Pinata plan, monitor monthly storage and gateway bandwidth usage, and update payment methods from the billing dashboard."
 slug: "billing"
 icon: "money-bill"
 excerpt: "https://app.pinata.cloud/billing"

diff --git a/account-management/limits.mdx b/account-management/limits.mdx
@@ -1,5 +1,6 @@
 ---
-title: "Limits"
+title: "Pinata rate limits and plan limits"
+description: "Reference for Pinata API rate limits, gateway request caps, and storage allowances across Free, Picnic, Fiesta, and Enterprise plans."
 icon: "gauge"
 ---
 

diff --git a/account-management/webhooks.mdx b/account-management/webhooks.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Webhooks"
-description: "Subscribe to Pinata API events using Webhooks"
+description: "Subscribe a server endpoint to Pinata events like uploads and deletes so your app reacts to file activity in real time using webhooks."
 icon: "webhook"
 ---
 

diff --git a/account-management/workspaces.mdx b/account-management/workspaces.mdx
@@ -1,5 +1,6 @@
 ---
-title: "Workspaces"
+title: "Workspaces and team collaboration"
+description: "Invite teammates to a shared Pinata workspace, manage seats on Picnic and Fiesta plans, and collaborate on uploads, gateways, and groups."
 slug: "workspaces"
 icon: "user-group"
 excerpt: ""

diff --git a/agents/api.mdx b/agents/api.mdx
@@ -1,7 +1,7 @@
 ---
-title: "HTTP API"
+title: "Pinata Agents HTTP API reference"
 sidebarTitle: "HTTP API"
-description: "Authenticate, manage agents, and talk to gateways over HTTP"
+description: "Authenticate, manage AI agents, run commands, and talk to gateways over the Pinata Agents HTTP API with examples for every endpoint."
 icon: "plug"
 ---
 

diff --git a/agents/channels.mdx b/agents/channels.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Channels"
-description: "Let people talk to your agent on Telegram, Slack, or Discord"
+title: "Agent channels: Telegram, Slack, Discord"
+description: "Connect your Pinata agent to Telegram, Slack, or Discord so users can chat with it directly from the messaging apps they already use."
 icon: "comments"
 ---
 

diff --git a/agents/chat.mdx b/agents/chat.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Chat"
-description: "Talk to your agent through the web interface"
+title: "Chat with your Pinata agent"
+description: "Talk to your hosted Pinata agent through the web chat interface, share context, attach files, and review the agent's actions in one place."
 icon: "message"
 ---
 

diff --git a/agents/concepts.mdx b/agents/concepts.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Concepts"
-description: "Terms, file layout, and how the pieces fit together"
+title: "Pinata Agents concepts and architecture"
+description: "Learn the terminology, file layout, runtime model, and architecture behind Pinata Agents so you can reason about how the pieces fit together."
 icon: "compass"
 ---
 

diff --git a/agents/console.mdx b/agents/console.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Console"
-description: "A real terminal inside your agent's container"
+title: "Agent console: terminal access"
+description: "Open a real interactive terminal inside your Pinata agent's container to inspect files, run commands, and debug issues in real time."
 icon: "terminal"
 ---
 

diff --git a/agents/devtools.mdx b/agents/devtools.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Danger"
-description: "Full agent inventory, plus restart and delete"
+title: "Agent inventory, restart, and delete"
+description: "Use the Danger panel to view your full Pinata agent inventory, restart misbehaving agents, and permanently delete agents you no longer need."
 icon: "triangle-exclamation"
 ---
 

diff --git a/agents/errors.mdx b/agents/errors.mdx
@@ -1,7 +1,7 @@
 ---
-title: "Error Reference"
+title: "Pinata Agents API error reference"
 sidebarTitle: "Errors"
-description: "Look up an API error code and how to resolve it"
+description: "Look up any Pinata Agents API error code, understand what it means, and follow the steps required to resolve the issue and unblock your agent."
 icon: "circle-exclamation"
 ---
 

diff --git a/agents/issues.mdx b/agents/issues.mdx
@@ -1,7 +1,7 @@
 ---
-title: "Issues & Boards"
+title: "Agent issues and kanban boards"
 sidebarTitle: "Issues"
-description: "Assign work to agents on a kanban board, review the diff, ship it"
+description: "Assign work to Pinata agents on a kanban board, review the diffs they produce, request changes, and ship completed pull requests to your repo."
 icon: "table-columns"
 ---
 

diff --git a/agents/logs.mdx b/agents/logs.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Logs"
-description: "Stream your agent engine's output in real time"
+title: "Stream Pinata agent engine logs"
+description: "Stream the live output from your Pinata agent's engine, follow tool calls and model responses, and debug runs as they happen in real time."
 icon: "scroll"
 ---
 

diff --git a/agents/manifest.mdx b/agents/manifest.mdx
@@ -1,7 +1,7 @@
 ---
-title: "Manifest Reference"
+title: "Pinata agent manifest.json reference"
 sidebarTitle: "Manifest"
-description: "Every field in manifest.json, the source of truth for an agent's configuration"
+description: "Reference for every field in manifest.json, the source of truth for a Pinata agent's models, skills, secrets, routes, and runtime configuration."
 icon: "file-code"
 ---
 

diff --git a/agents/models.mdx b/agents/models.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Models"
-description: "Pick which AI models this agent can use"
+title: "Choose AI models for your Pinata agent"
+description: "Pick which large language models your Pinata agent can call, mix providers, and control which model handles chat, tools, and background tasks."
 icon: "microchip"
 ---
 

diff --git a/agents/overview.mdx b/agents/overview.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Overview"
-description: "Hosted AI agents that can run code, manage files, and connect to other services"
+title: "Pinata Agents overview"
+description: "Pinata Agents are hosted AI agents that run code, manage files, call external services, and integrate with chat platforms, all from one dashboard."
 icon: "lobster"
 ---
 

diff --git a/agents/routes.mdx b/agents/routes.mdx
@@ -1,7 +1,7 @@
 ---
-title: "Domains & Routes"
+title: "Agent domains and HTTP routes"
 sidebarTitle: "Routes"
-description: "Expose web services from inside your agent to the internet"
+description: "Expose web services running inside your Pinata agent to the internet using custom domains and HTTP routes, complete with TLS and auth options."
 icon: "network-wired"
 ---
 

diff --git a/agents/secrets.mdx b/agents/secrets.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Secrets"
-description: "Where API keys and credentials live"
+title: "Manage agent secrets and API keys"
+description: "Store API keys, tokens, and credentials your Pinata agent needs to call external services, scoped per agent and injected at runtime safely."
 icon: "key"
 ---
 

diff --git a/agents/skills.mdx b/agents/skills.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Skills"
-description: "Reusable capability packages you can attach to an agent"
+title: "Agent skills: reusable capabilities"
+description: "Skills are reusable capability packages you attach to a Pinata agent to add new tools, integrations, and behavior without rewriting the manifest."
 icon: "wand-magic-sparkles"
 ---
 

diff --git a/agents/snapshots.mdx b/agents/snapshots.mdx
@@ -1,7 +1,7 @@
 ---
-title: "Files & Snapshots"
+title: "Agent files and workspace snapshots"
 sidebarTitle: "Files"
-description: "Browse, version, and edit your agent's workspace"
+description: "Browse, version, and edit your Pinata agent's workspace from the dashboard, then roll back to any earlier snapshot when something goes wrong."
 icon: "folder-open"
 ---
 

diff --git a/agents/tasks.mdx b/agents/tasks.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Tasks"
-description: "Run prompts on a schedule"
+title: "Schedule recurring tasks for an agent"
+description: "Run prompts against your Pinata agent on a schedule using cron expressions so it can monitor sources, send reports, and perform routine work."
 icon: "clock"
 ---
 

diff --git a/agents/templates/creating.mdx b/agents/templates/creating.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Creating Templates"
-description: "Share your agent configuration as a template"
+title: "Create and publish an agent template"
+description: "Package and share your Pinata agent configuration as a reusable template so other developers can deploy preconfigured agents in one click."
 icon: "hammer"
 ---
 

diff --git a/agents/templates/overview.mdx b/agents/templates/overview.mdx
@@ -1,7 +1,7 @@
 ---
-title: "Templates"
+title: "Agent templates: one-click deploys"
 sidebarTitle: "Overview"
-description: "Deploy pre-configured agents in one click"
+description: "Deploy preconfigured Pinata agents in a single click, browse community templates, and use them as starting points for your own AI agents."
 icon: "grid-2"
 ---
 

diff --git a/agents/troubleshooting.mdx b/agents/troubleshooting.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Troubleshooting"
-description: "What to check when your agent isn't behaving"
+title: "Troubleshoot a misbehaving Pinata agent"
+description: "Diagnostic checklist for fixing a Pinata agent that won't start, ignores instructions, fails tool calls, or burns through context unexpectedly."
 icon: "wrench"
 ---
 

diff --git a/api-reference/endpoint/ipfs/add-cids-to-group.mdx b/api-reference/endpoint/ipfs/add-cids-to-group.mdx
@@ -1,3 +1,4 @@
 ---
+description: "Add one or more IPFS CIDs to an existing group on Pinata so you can organize and query pins together through the legacy IPFS API endpoints."
 openapi: put /groups/{id}/cids
 ---
diff --git a/api-reference/endpoint/ipfs/add-swap.mdx b/api-reference/endpoint/ipfs/add-swap.mdx
@@ -1,3 +1,4 @@
 ---
+description: "Create a Hot Swap mapping on the legacy IPFS API so requests for one CID are silently served the content of a different, updated CID instead."
 openapi: put /ipfs/swap/{cid}
 ---
diff --git a/api-reference/endpoint/ipfs/create-group.mdx b/api-reference/endpoint/ipfs/create-group.mdx
@@ -1,3 +1,4 @@
 ---
+description: "Create a new IPFS group on Pinata's legacy API. Groups let you organize pinned CIDs so you can manage and filter them by a single name."
 openapi: post /groups
 ---
diff --git a/api-reference/endpoint/ipfs/delete-group.mdx b/api-reference/endpoint/ipfs/delete-group.mdx
@@ -1,3 +1,4 @@
 ---
+description: "Delete an existing IPFS group on Pinata's legacy API. Pinned CIDs that were members of the group are not unpinned by this operation."
 openapi: delete /groups/{id}
 ---
diff --git a/api-reference/endpoint/ipfs/get-a-group.mdx b/api-reference/endpoint/ipfs/get-a-group.mdx
@@ -1,3 +1,4 @@
 ---
+description: "Fetch metadata about a single IPFS group on Pinata's legacy API, including its name, ID, creation timestamp, and last-updated timestamp."
 openapi: get /groups/{id}
 ---
diff --git a/api-reference/endpoint/ipfs/get-swap-history.mdx b/api-reference/endpoint/ipfs/get-swap-history.mdx
@@ -1,3 +1,4 @@
 ---
+description: "Return every Hot Swap mapping that has ever been registered against a given IPFS CID using Pinata's legacy IPFS API hot swap endpoints."
 openapi: get /ipfs/swap/{cid}
 ---
diff --git a/api-reference/endpoint/ipfs/list-groups.mdx b/api-reference/endpoint/ipfs/list-groups.mdx
@@ -1,3 +1,4 @@
 ---
+description: "List the IPFS groups on your Pinata account using the legacy IPFS API, with pagination and name filters to find specific organized pin sets."
 openapi: get /groups
 ---
diff --git a/api-reference/endpoint/ipfs/remove-cids-from-a-group.mdx b/api-reference/endpoint/ipfs/remove-cids-from-a-group.mdx
@@ -1,3 +1,4 @@
 ---
+description: "Remove one or more IPFS CIDs from a group on Pinata's legacy API. The underlying pins remain on your account and are not unpinned by this call."
 openapi: delete /groups/{id}/cids
 ---
diff --git a/api-reference/endpoint/ipfs/remove-swap.mdx b/api-reference/endpoint/ipfs/remove-swap.mdx
@@ -1,3 +1,4 @@
 ---
+description: "Delete an existing Hot Swap mapping on Pinata's legacy IPFS API so requests for the original CID resume serving its original content again."
 openapi: delete /ipfs/swap/{cid}
 ---
diff --git a/api-reference/endpoint/ipfs/revoke-api-key.mdx b/api-reference/endpoint/ipfs/revoke-api-key.mdx
@@ -1,3 +1,4 @@
 ---
+description: "Revoke an existing Pinata legacy IPFS API key by its key value so it can no longer be used to authenticate requests against the legacy API."
 openapi: put /users/revokeApiKey
 ---
diff --git a/api-reference/endpoint/ipfs/update-file-metadata.mdx b/api-reference/endpoint/ipfs/update-file-metadata.mdx
@@ -1,3 +1,4 @@
 ---
+description: "Update the name and key-value metadata stored for a pinned IPFS CID on Pinata's legacy IPFS API. The underlying pinned content stays untouched."
 openapi: put /pinning/hashMetadata
 ---
diff --git a/api-reference/endpoint/ipfs/update-group.mdx b/api-reference/endpoint/ipfs/update-group.mdx
@@ -1,3 +1,4 @@
 ---
+description: "Update the name of an existing IPFS group on Pinata's legacy IPFS API. The group ID and its member CID list are preserved by this operation."
 openapi: put /groups/{id}
 ---
diff --git a/api-reference/introduction.mdx b/api-reference/introduction.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Introduction"
-description: "Getting started with the Pinata API"
+title: "Pinata API introduction and authentication"
+description: "Start with the Pinata API: authenticate with a JWT, pick between the v3 Files API and IPFS API, and find endpoints for uploads and gateways."
 ---
 
 Welcome to the Pinata API Reference! Before you can do anything in the API, you'll need some API Keys.

diff --git a/api-reference/pinning-service-api.mdx b/api-reference/pinning-service-api.mdx
@@ -1,5 +1,6 @@
 ---
-title: "Pinning Service API"
+title: "Pinning Service API compatibility"
+description: "Connect a local IPFS node to Pinata using the standardized IPFS Pinning Services API spec, with authentication and supported endpoints."
 slug: "pinning-service-api"
 excerpt: ""
 hidden: false

diff --git a/events/hackutd.mdx b/events/hackutd.mdx
@@ -1,6 +1,6 @@
 ---
 title: "HackUTD 2024"
-description: "Everything you need to start hacking with Pinata"
+description: "HackUTD 2024 resource hub for hackers building with Pinata: API keys, IPFS uploads, gateways, sample projects, and prize-track requirements."
 'og:image': "https://dweb.mypinata.cloud/files/bafkreibd7kj7qviao4nx67kvcqhm7gx2mfd5ntemrlsofpbgxlfnbnlg3u?img-format=webp"
 ---
 

diff --git a/events/midwest-blockathon.mdx b/events/midwest-blockathon.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Midwest Blockathon"
-description: "Everything you need to start hacking with Pinata"
+description: "Midwest Blockathon resources for building with Pinata: free API keys, IPFS upload guides, NFT examples, and Web3 storage starter projects."
 'og:image': "https://dweb.mypinata.cloud/ipfs/bafybeiddzixjmwioazvyokgd4kjep45tuvosgeizenekk2ifrcznqsfb5m"
 ---
 

diff --git a/events/midwest-blockchain-conference.mdx b/events/midwest-blockchain-conference.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Midwest Blockchain Conference"
-description: "Everything you need to start hacking with Pinata"
+description: "Midwest Blockchain Conference workshop resources for Pinata, IPFS uploads, Dedicated Gateways, NFTs, and getting started with Web3 storage."
 ---
 
 ![MBC Graphic Large.png](/images/MBCGraphicLarge.png)

diff --git a/events/ugahacks.mdx b/events/ugahacks.mdx
@@ -1,6 +1,6 @@
 ---
 title: "UGA Hacks"
-description: "Everything you need to start hacking with Pinata"
+description: "UGA Hacks resource page for hackers using Pinata: claim free API keys, upload to IPFS, serve files through gateways, and find starter templates."
 'og:image': "https://dweb.mypinata.cloud/ipfs/bafybeic2xw7xptzy53rtsksecjdzmygliwlqalqkaipq4wwap4kchxg47y"
 ---
 

diff --git a/files/deleting-files.mdx b/files/deleting-files.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Deleting Files"
+description: "Delete files from Pinata permanently using the SDK delete method, the Files API, or the dashboard to remove single files or files in bulk."
 icon: "trash"
 ---
 

diff --git a/files/file-groups.mdx b/files/file-groups.mdx
@@ -1,5 +1,6 @@
 ---
-title: "Groups"
+title: "Organize uploads with file groups"
+description: "Use Pinata groups to organize your uploads through the app, SDK, or API, add and remove files, and keep track of what each set of CIDs is for."
 icon: "ball-pile"
 ---
 

diff --git a/files/hot-swaps.mdx b/files/hot-swaps.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Hot Swaps"
-description: "Use the Hot Swaps plugin to make one CID map to another"
+description: "Map one IPFS CID to another with the Pinata Hot Swaps plugin so you can update content served from a stable CID without breaking existing links."
 ---
 
 The Hot Swaps plugin can be used to "redirect" a CID to another CID. This can be useful when you need to replace content without updaing the CID hash. What makes this unique from just replacing content is that every swap is recorded and is available as a history. Combine that with the content addressable nature of CIDs and you get a version history of content.

diff --git a/files/key-values.mdx b/files/key-values.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Key-Values"
+description: "Attach up to ten custom key-value pairs to any Pinata upload so you can tag, query, and update files with metadata that fits your app's needs."
 icon: "database"
 ---
 

diff --git a/files/listing-files.mdx b/files/listing-files.mdx
@@ -1,5 +1,6 @@
 ---
-title: "List & Query Files"
+title: "List and query files on Pinata"
+description: "Query files uploaded to Pinata by name, key-value tags, group, date, and more using the SDK or Files API to power dashboards and search."
 icon: "list"
 ---
 

diff --git a/files/mpp/overview.mdx b/files/mpp/overview.mdx
@@ -1,6 +1,6 @@
 ---
 title: "MPP Server"
-description: "Account-free IPFS uploads and downloads using crypto payments via the Machine Payments Protocol"
+description: "The MPP Server enables account-free IPFS uploads and downloads using crypto payments via the Machine Payments Protocol on Cloudflare Workers."
 ---
 
 Pinata's MPP Server enables account-free file uploads and downloads to IPFS using crypto payments. No API key or Pinata account required — just pay with USDC on Tempo and get your files stored on IPFS.