node package manager
We need your input. Help make JavaScript better: Take the 2017 JavaScript Ecosystem survey »



npm version

A Node.js API client for Cachet.

Cachet is a beautiful and powerful open source status page system, a free replacement to services such as, and others.


First, install the package using npm:

npm install cachet-api --save

Then, start using the package by importing and configuring it:

var CachetAPI = require('cachet-api');
// Fill in the parameters accordingly 
var cachet = new CachetAPI({
    // Base URL of your installed Cachet status page 
    url: '',
    // Cachet API key (provided within the admin dashboard) 
    apiKey: 'a1b2c3d4e5f6g7h8i9'

Make sure to fill in your Cachet status page url as well as your Cachet admin account's apiKey, which you can find in the Cachet dashboard.

Get Component Info

Use cachet.getComponentById(id) to fetch details about an existing component:

// Prepare a component ID to fetch 
var componentId = 1;
// Get component info by ID 
    .then(function (component) {
        // Log component info 
        console.log('Component', component);
    }).catch(function (err) {
        // Log errors to console 
        console.log('Fatal Error', err);

Publish a Metric Point

Use cachet.publishMetricPoint(point) to publish a new metric point to an existing metric:

// Prepare a metric point to publish (so it shows up on the metric's graph) 
var metricPoint = {
    // Metric ID 
    id: 1,
    // Metric point value 
    value: 3.37,
    // Metric point timestamp (optional, defaults to now) 
    timestamp: Math.round(new Date().getTime() / 1000)
// Publish it so it shows up on the status page 
    .then(function (response) {
        // Log API response 
        console.log('Metric point published at ' +;
    }).catch(function (err) {
        // Log errors to console 
        console.log('Fatal Error', err);

Report an Incident

Use cachet.reportIncident(incident) to report a new status incident:

// Prepare an incident to report 
var incident = {
    // Incident name 
    name: 'Database connectivity issues',
    // Incident description (supports markdown) 
    message: 'We\'re investigating connectivity issues with the main DB.',
    // Incident status ( 
    status: 'Investigating',
    // Whether the incident will be visible to the public or only to logged in users 
    visible: true,
    // Whether to send out e-mail notifications to subscribers regarding this incident 
    notify: true,
    // Component ID affected by this incident (optional) 
    component_id: 1,
    // Component status (required if component_id is specified) ( 
    component_status: 'Partial Outage'
// Report it so it shows up on the status page 
    .then(function (response) {
        // Log API response 
        console.log('New incident reported at ' +;
    }).catch(function (err) {
        // Log errors to console 
        console.log('Fatal Error', err);


Apache 2.0