LayerVault API client
Last updated 6 years ago by meltingice .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install layervault 
SYNC missed versions from official npm registry.

LayerVault JS Client

Build Status

NodeJS client for accessing the LayerVault API.


The library is available on npm:

npm install layervault


var LayerVault = require('layervault');

// Configure
var config = new LayerVault.Configuration(function () {
  this.oauthKey = 'abc123'
  this.oauthSecret = 'foobar'

  // optional, if you have it
  this.accessToken = 'sloths567'
  this.refreshToken = 'blahblah'

// Create the client
var client = new LayerVault.Client(config);



// If configured without an access token, you will need
// to authenticate and retrieve one. Here's the password flow:
client.auth.withPassword('username', 'password', function (err, tokens) {
  // We are now logged in. The configuration is automatically updated
  // with the access token and refresh token. We can store them somewhere
  // persistent if needed.

Because LayerVault uses OAuth refresh tokens, we need to watch out for their expiration and retrieve new tokens when they do. This is automatically handled internally in the library, and the new tokens are exposed via an event. This event is fired whenever authorization completes, so you can use it instead of providing a callback to withPassword like above.

client.auth.on('authorized', function (tokens) {
  // Store our tokens somewhere persistent.
  console.log(tokens.accessToken, tokens.refreshToken);

Retrieving Data

This API client uses a lightweight resource model to make getting associations very easy.

// We can retrieve information about the logged in user. (err, user) {

  // Get the user's primary organization
  var org = user.organizations[0];

  // Get the first project in the organization
  client.organization(org).project(org.projects[0]).get(function (err, project) {

You can chain together objects to build a query. Responses are parsed to include proper object associations so you can continue to drill down data.

Arguments to the data types can be given as separate arguments (shown below), as path style ("Test/Stuff"), or a combination of both.

client.organization('layervault').folder('Test', 'Stuff').get(function (err, folder) {
  folder.files[0].revisions(function (err, revisions) {
    revisions[0].previews(function (err, urls) {

Uploading a File/Revision

Creating a new file and uploading a new revision are the same process. While it is a multi-step process, the API client takes care of most of the steps for you.

To upload a file, all you need to provide is the path to the file on disk and the mime-type of the file.

client.organization('layervault').file('Test/Stuff', 'NewFile.psd').create({
  localPath: "/path/to/file/on/disk/NewFile.psd",
  contentType: "image/vnd.adobe.photoshop"
}, function (err, resp) {


All asynchronous calls return a promise, which can be used as an alternative to providing a callback.

client.auth.withPassword('username', 'password').then(function (resp) {
  return client.organization('layervault').get();
}).then(function (org) {
  return org.projects[0].files[0].preview({w: 200});
}).then(function (preview) {


  • Allow file uploads to accept a file buffer
  • Implement authorization code OAuth flow



Ryan LeFevre - GitHub, Twitter, Email


Available under the MIT license. See the LICENSE file for more info.

Current Tags

  • 0.1.5                                ...           latest (6 years ago)

5 Versions

  • 0.1.5                                ...           6 years ago
  • 0.1.3                                ...           6 years ago
  • 0.1.2                                ...           6 years ago
  • 0.1.1                                ...           6 years ago
  • 0.1.0                                ...           6 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 1
Dependencies (3)
Dev Dependencies (4)
Dependents (1)

Copyright 2014 - 2016 © |