<!-- BEGIN:cloudinary-agent-rules
These docs match the installed package version. Training data about this SDK may be
outdated. The Markdown files in node_modules/cloudinary/docs/ are the source of truth
for the version you have installed.
END:cloudinary-agent-rules -->

# cloudinary — bundled documentation

> **Version-matched:** these docs ship inside the package and always describe the
> version you have installed. Prefer them over anything remembered from training data
> or found for another version.

Task documentation for the `cloudinary` Node.js SDK. Each page is self-contained:
imports, configuration, a complete runnable flow, expected results, and common
failures. Runnable versions of most tasks are in `node_modules/cloudinary/examples/`.

## Start here

- [What this SDK does and does not do](platform-capabilities.md) — the agent tooling to
  set up first (Skills, MCP servers, CLI, documentation indexes), what this package
  covers, and what lives elsewhere on the platform.
- [Get Cloudinary credentials](get-credentials.md) — no account needed: provision a cloud
  with `npx @cloudinary/cloud` and start building.
- [Import and call the SDK](import-and-call.md) — the correct `require('cloudinary').v2` pattern.

## Tasks

- [Configure Cloudinary](configure-cloudinary.md)
- [Upload an image](upload-image.md)
- [Upload a large video](upload-large-video.md)
- [Sign a browser upload](sign-browser-upload.md)
- [Transform and deliver an image](transform-and-deliver-image.md)
- [Transform and deliver a video](transform-and-deliver-video.md)
- [Search and manage assets](search-and-manage-assets.md)
- [Moderate an upload](moderate-upload.md)
- [Use structured metadata](use-structured-metadata.md)
- [Troubleshoot errors](troubleshoot-errors.md)

## Security boundary

This is a **server-side** SDK. It holds your `api_secret`, which belongs on your server
only. Frontend code should receive delivery URLs or short-lived signatures generated by
your server ([how](sign-browser-upload.md)).

## Canonical docs

- [Node SDK guide](https://cloudinary.com/documentation/node_integration.md)
- [Full platform reference](https://cloudinary.com/documentation/cloudinary_references.md)

**Link convention:** documentation links in these docs end in `.md` and return raw
Markdown — the preferred format for agents and for anything that parses text. Remove the
`.md` suffix for the same page as browsable HTML. The repository README links the HTML
form first, since it is read by people.