Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cloudinary Upload API

Asset upload and management.

Cloudinary Upload API is one of 9 APIs that Cloudinary publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Upload. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a getting-started guide.

This API exposes 6 operations across 6 paths, and defines 4 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.cloudinary.com/v1_1/{cloud_name}.

6 operations 6 paths 4 schemas 6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.cloudinary.com/v1_1
Authentication
HTTP Basic
Resource Areas
1

Authentication & Security 1

Cloudinary Upload API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

  • basicAuth — HTTP Basic auth using API key as username and API secret as password.

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 6 POST. Each is listed below with its method, path, parameters, and response codes.

Upload 6

Asset upload and management.

POST
/{resource_type}/upload
Upload an asset
uploadAsset 1 param body → 200
POST
/{resource_type}/rename
Rename an asset
renameAsset 1 param body → 200
POST
/{resource_type}/destroy
Delete an asset
destroyAsset 1 param body → 200
POST
/{resource_type}/tags
Manage asset tags
manageTags 1 param body → 200
POST
/{resource_type}/context
Update contextual metadata
manageContext 1 param body → 200
POST
/{resource_type}/metadata
Update structured metadata
updateMetadata 1 param body → 200

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are Asset (6 properties), UploadRequest (5 properties). Each schema is shown below with its type and property counts.

GenericResponse
object
GenericRequest
object
Asset
object
6 properties
UploadRequest
object
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cloudinary-upload-api-openapi.yml Raw ↑

Other APIs Cloudinary publishes across the network.

Cloudinary Admin API
Cloudinary Search API
Cloudinary Provisioning API
Cloudinary Permissions API
Cloudinary Transformation URL API
Cloudinary Notifications and Webhooks
Cloudinary Backup API
Cloudinary Transformation API