An async' Promise/A+ client library for the Linode API

Usage no npm install needed!

<script type="module">
  import linodeIo from '';


A set of async Linode API wrappers in ES6 & Node JS.

Built on Promises/A+, this asynchronous implementation provides an efficient and modern library for interacting with the Linode API.

API Support

Currently, this library supports:

  • DNS


The entrypoint to the client library is the Linode class, which is a factory that is used to get each relevant service from the API. This saves, amongst other things, having to pass the API key to each module as this is injected for you.

The Linode class is returned upon a require call:

const Linode = require('');

Now that it's imported, you create an instance:

const linode = new Linode(myApiKey);

You can then begin to use the services, e.g. DNS:

const domain = linode.dns();

The rest of this document assumes you've created an instance of Linode called linode.


Each service exposes the relevant API verbs, such as listing, creating or updating. In order to provide efficiency, every function within a service returns a Promise, which can then be used to chain subsequent behaviour. To do so, merely register using then:


or, a more useful example:

domain.findDomain('').then((d) => { console.log(' has DomainID' + d.DOMAINID) });

Note that you should register rejection handlers, e.g. using catch:

// Some time later...
{ [Error: read ECONNRESET] code: 'ECONNRESET', errno: 'ECONNRESET', syscall: 'read' }

Otherwise your actions may fail silently.


Listing domains

const d = linode.dns();
// See your domains listed

Finding a domain

You can get a domain's information to utilise further: