Node.js asset administration

While using Cloudinary, all your images, videos, and other raw files are uploaded to your Cloudinary account. You can use our Media Library web interface to browse through and manage your uploaded media assets and generated transformations. In addition, you can use methods from the Upload and Admin APIs, which offer methods for managing, organizing, and creating media assets.

  • Upload API methods can be used as needed.
  • Admin API methods are rate-limited.
    You can view the number of hourly Admin API requests allowed by your account plan in the Account page of your console settings.

On this page:

Upload API

In addition to the upload method, this API includes methods for:

Admin API

A secure API with methods for managing and organizing your media assets, including:

Example

The following Node.js example returns the details of an uploaded image according to its public ID, using the Admin API resource method:

var cloudinary = require('cloudinary');
cloudinary.v2.api.resource('sample', 
  function(error, result){console.log(result)});

Sample output:

{ 
  public_id: 'sample',
  format: 'jpg',
  version: 1371282172,
  resource_type: 'image',
  type: 'upload',
  created_at: '2017-07-01T11:10:57Z',
  bytes: 120264,
  width: 864,
  height: 576,
  url: 'https://res.cloudinary.com/demo/image/upload/v1371282172/sample.jpg',
  secure_url: 'https://.../demo/image/upload/v1371282172/sample.jpg',
  next_cursor: 'c87e7b39f7fdd66ec31985196b455c40',
  derived: 
   [ 
     { transformation: 'c_fit,h_150,w_100',
       format: 'jpg',
       bytes: 5729,
       id: '1892cd020611691462a8dc6616f81881',
       url: 'https://.../image/upload/c_fill,w_100,h_100/v1312461204/sample.jpg',
       secure_url: 'https://.../c_fill,w_100,h_100/v1312461204/sample.jpg' },
     { transformation: 'w_230,h_168,c_fit',
       format: 'jpg',
       bytes: 18116,
       id: '383e22a57167445552a3cdc16f0a0c85',
       url: 'https://.../image/upload/w_230,h_168,c_fit/v1312461204/sample.jpg',
       secure_url: 'https://.../upload/w_230,h_168,c_fit/v1312461204/sample.jpg' } ],
  rate_limit_allowed: 500,
  rate_limit_reset_at: Sun, 07 Jul 2013 18:00:00 GMT,
  rate_limit_remaining: 496 
}