Skip to content

@eduardoboucas eduardoboucas released this Oct 28, 2019 · 4 commits to develop since this release


  • #512: add runHooks parameter to model methods
  • #570: allow customisation of page size in search results
  • #573: add endpoints for creating, managing and deleting collections
  • #578: add super user access type
  • #583: add access keys
  • #586: add media public URL
  • #592: add email address to client records
  • #593: add pagination URLs to metadata block
  • #596: add password reset mechanism


  • #566: store collection schemas in database
  • #567: remove version from collection endpoint URLs
  • #579: abort app start when token key is not defined
  • #584: respect ACL's fields object when creating and updating documents
  • #588: change status code of batch search endpoint to 202
  • #589: update syntax of Model constructor
  • #590: remove query.useVersionFilter config property


  • #551: show validation errors of pre-composed documents
  • #563: objects not accepted as values on Boolean filters
  • #568: wrong page count in search metadata block
  • #572: use correct validation error for missing required fields
  • #576: updating or deleting documents fails on collections with versioning enabled when using @dadi/api-filestore
  • #581: API hangs when filter contains variable starting with $
  • #587: fix batch search index endpoint


1. Collection URLs

The structure of collection endpoint URLs has changed from /:version/:database/:name to /:property/:name. In practice, this means that consumers must update the URLs being used to reach API collections by removing the first node (version).

The database property was renamed to property, as it more accurately describes the fact that multiple applications can run on a single API instance, which does not necessarily mean the same separation in terms of databases.

Consumers using API wrapper must upgrade their package to version 4.

2. Model constructor signature

The signature of the Model export has changed. Rather than accepting the name of the collection as a String, it now expects an object with property and name keys, indicating the name of the property (previously called database) and the name of the collection, respectively.

const {Model} = require('@dadi/api')

// Version 5 and prior

// Version 6
Model({property: 'library', name: 'books'}).find({})

3. Require auth key

It is now mandatory to supply a key for signing tokens via the auth.tokenKey configuration properly. It can be a string of any length, as long as it's kept secret.

Failing to provide this configuration property will make API throw a fatal error on startup.

Assets 2
You can’t perform that action at this time.