Wondering what’s next for npm?Check out our public roadmap! »


3.0.0 • Public • Published

Build status Coverage Status Quality Gate

NPM dependencies Renovate Last commit Last release

NPM downloads License

Mocks-server administration api client

This package contains methods for administrating Mocks Server (using the Admin API plugin under the hood).

Requests to the Mocks Server API are made using cross-fetch, which makes this package compatible with browsers and nodejs environments, but, if you are going to build a browser application, you'll probably prefer to use the @mocks-server/admin-api-client-data-provider package, which uses Data Provider, and works well with Redux, React, etc.


npm install --save @mocks-server/admin-api-client

The UMD build is also available on unpkg:

<script src="https://unpkg.com/@mocks-server/admin-api-paths/dist/index.umd.js"></script>
<script src="https://unpkg.com/@mocks-server/admin-api-client/dist/index.umd.js"></script>

The umd distribution is bundled with the cross-env dependency, but requires the @mocks-server/admin-api-paths dependency to be added separately.


All methods described in the Api (except the config method) return Promises when executed:

import { readAbout, readSettings, updateSettings } from "@mocks-server/admin-api-client";

const example = async () => {
  const { version } = await readAbout();
  console.log(`Current Admin API plugin version is ${version}`);

  const currentSettings = await readSettings();
  console.log("Current Mocks Server settings are", currentSettings);

  await updateSettings({
    mock: "user-super-admin",
    delay: 1000
  console.log("Mock and delay changed");



  • readAbout() - Returns info about the Admin API plugin, such as current version.
  • readSettings() - Returns current Mocks Server settings.
  • updateSettings(settingsObject) - Updates Mocks Server settings. A settings object has to be provided. Read the Mocks Server configuration docs for further info.
  • readAlerts() - Returns array of current alerts.
  • readAlert(alertId) - Returns an specific alert.
  • readMocks() - Returns available mocks.
  • readMock(id) - Returns data of a specific mock.
  • readRoutes() - Returns available routes.
  • readRoute(id) - Returns data of a specific route.
  • readRoutesVariants() - Returns available routes variants.
  • readRouteVariant(id) - Returns data of a specific route variant.
  • readCustomRoutesVariants() - Returns current routes variants manually added to current mock.
  • useRouteVariant(id) - Sets a specific route variant to be used by current mock.
  • restoreRoutesVariants() - Restore routes variants to those defined in current mock.
Legacy methods
  • readBehaviors() - Returns collection of available behaviors.
  • readBehavior(behaviorName) - Returns an specific behavior.
  • readFixtures() - Returns collection of available fixtures.
  • readFixture(fixtureId) - Returns an specific fixture.


By default, the client is configured to request to http://localhost:3100/admin, based in the default options of Mocks Server

You can change both the base url of Mocks Server, and the path of the Admin API plugin using the config method:

import { config } from "@mocks-server/admin-api-client";

  adminApiPath: "/foo-admin",
  baseUrl: "http://my-mocks-server:3000"


Contributors are welcome. Please read the contributing guidelines and code of conduct.


npm i @mocks-server/admin-api-client

DownloadsWeekly Downloads






Unpacked Size

38.5 kB

Total Files


Last publish


  • avatar