Cloudinary Upload and Asset API
OpenAPI 3.1 coverage for Cloudinary asset upload and resource-management routes. The Cloud name is account-specific and signatures must be generated server-side; never expose the API secret in clients.
Connect this API to an AI agent Browse all specs
What you can do with Cloudinary Upload and Asset API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /resources/{resource_type}/{type} |
getResourcesByResourceTypeByType | List resources Method: GET Path: /resources/{resource_type}/{type} IMPORTANT: This function has 2 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - resource_type: For example image, video or raw. - type: For example upload or authenticated. Query Parameters: OPTIONAL: - next_cursor: next_cursor parameter. - max_results: max_results parameter. |
| DELETE | /resources/{resource_type}/{type} |
deleteResourcesByResourceTypeByType | Delete resources by public IDs Method: DELETE Path: /resources/{resource_type}/{type} IMPORTANT: This function has 3 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - resource_type: resource_type parameter. - type: type parameter. Request Body: REQUIRED: - body: Request body (application/json) |
| GET | /resources/{resource_type}/{type}/{public_id} |
getResourcesByResourceTypeByTypeByPublicId | Get resource details Method: GET Path: /resources/{resource_type}/{type}/{public_id} IMPORTANT: This function has 3 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - resource_type: resource_type parameter. - type: type parameter. - public_id: public_id parameter. |
| DELETE | /resources/{resource_type}/{type}/{public_id} |
deleteResourcesByResourceTypeByTypeByPublicId | Delete a resource Method: DELETE Path: /resources/{resource_type}/{type}/{public_id} IMPORTANT: This function has 4 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - resource_type: resource_type parameter. - type: type parameter. - public_id: public_id parameter. Request Body: REQUIRED: - body: Request body (application/json) |
| POST | /upload |
postUpload | Upload an asset Method: POST Path: /upload IMPORTANT: This function has 3 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: REQUIRED: - api_key: api_key parameter. - timestamp: timestamp parameter. - signature: signature parameter. |
Usage guide
## Cloudinary Upload and Asset API This listing describes documented production API routes only. Before making requests, read the provider's official documentation and configure the server URL variables where applicable. ### Authentication Create a Cloudinary account and use the cloud name, API key and API secret from the console. Generate upload/admin signatures server-side using the API secret; send `api_key`, `timestamp` and `signature` as documented. Never put the API secret or generated signature logic in a public client. ### Operational guidance Use pagination for collection endpoints, respect provider rate limits, validate identifiers before mutating resources, and follow each provider's terms, consent requirements, and data-retention policies.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Cloudinary Upload and Asset API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.