Default routes

⚠️ This page is relevant only if you installed Forest Admin directly on a database (SQL/Mongodb). If you installed in a Rails app, the default routes are managed within your Rails app.
Forest Admin's default routes are generated in the routes folder at installation.
Below we've detailed what the next() statement does. Those snippets can be used when overriding those routes, as explained here.
Create a record
/routes/companies.js
...
​
const {
  PermissionMiddlewareCreator,
  RecordCreator,
} = require('forest-express-sequelize');
const { companies } = require('../models');
​
const permissionMiddlewareCreator = new PermissionMiddlewareCreator('companies');
​
...
​
// Create a Company - Check out our documentation for more details: https://docs.forestadmin.com/documentation/v/v6/reference-guide/routes/default-routes#create-a-record
router.post('/companies', permissionMiddlewareCreator.create(), (request, response, next) => {
  const { body, query, user } = request;
  const recordCreator = new RecordCreator(companies, user, query);
​
  recordCreator.deserialize(body)
    .then(recordToCreate => recordCreator.create(recordToCreate))
    .then(record => recordCreator.serialize(record))
    .then(recordSerialized => response.send(recordSerialized))
    .catch(next);
});
​
...
Update a record
/routes/companies.js
...
​
const {
  PermissionMiddlewareCreator,
  RecordUpdater,
} = require('forest-express-sequelize');
const { companies } = require('../models');
​
const permissionMiddlewareCreator = new PermissionMiddlewareCreator('companies');
​
...
​
// Update a Company - Check out our documentation for more details: https://docs.forestadmin.com/documentation/v/v6/reference-guide/routes/default-routes#update-a-record
router.put('/companies/:recordId', permissionMiddlewareCreator.update(), (request, response, next) => {
  const { body, params, query, user } = request;
  const recordUpdater = new RecordUpdater(companies, user, query);
​
  recordUpdater.deserialize(body)
    .then(recordToUpdate => recordUpdater.update(recordToUpdate, params.recordId))
    .then(record => recordUpdater.serialize(record))
    .then(recordSerialized => response.send(recordSerialized))
    .catch(next);
});
​
...
Note that the update of belongsTo fields is managed by another route.
Delete a record
/routes/companies.js
...
​
const {
  PermissionMiddlewareCreator,
  RecordRemover,
} = require('forest-express-sequelize');
const { companies } = require('../models');
​
const permissionMiddlewareCreator = new PermissionMiddlewareCreator('companies');
​
...
​
// Delete a Company - Check out our documentation for more details: https://docs.forestadmin.com/documentation/v/v6/reference-guide/routes/default-routes#delete-a-record
router.delete('/companies/:recordId', permissionMiddlewareCreator.delete(), (request, response, next) => {
  const { params, query, user } = request;
  const recordRemover = new RecordRemover(companies, user, query);
​
  recordRemover.remove(params.recordId)
    .then(() => response.status(204).send())
    .catch(next);
});
​
...
Get a list of records
/routes/companies.js
...
​
const {
  PermissionMiddlewareCreator,
  RecordsGetter,
} = require('forest-express-sequelize');
const { companies } = require('../models');
​
const permissionMiddlewareCreator = new PermissionMiddlewareCreator('companies');
​
...
​
// Get a list of Companies - Check out our documentation for more details: https://docs.forestadmin.com/documentation/v/v6/reference-guide/routes/default-routes#get-a-list-of-records
router.get('/companies', permissionMiddlewareCreator.list(), (request, response, next) => {
  const { query, user } = request;
  const recordsGetter = new RecordsGetter(companies, user, query);
​
  recordsGetter.getAll()
    .then(records => recordsGetter.serialize(records))
    .then(recordsSerialized => response.send(recordsSerialized))
    .catch(next);
});
​
...
Get a number of records
/routes/companies.js
...
​
const {
  PermissionMiddlewareCreator,
  RecordsCounter,
} = require('forest-express-sequelize');
const { companies } = require('../models');
​
const permissionMiddlewareCreator = new PermissionMiddlewareCreator('companies');
​
...
​
// Get a number of Companies - Check out our documentation for more details: https://docs.forestadmin.com/documentation/v/v6/reference-guide/routes/default-routes#get-a-number-of-records
router.get('/companies/count', permissionMiddlewareCreator.list(), (request, response, next) => {
  const { query, user } = request;
  const recordsCounter = new RecordsCounter(companies, user, query);
  
  recordsCounter.count(request.query)
    .then(count => response.send({ count }))
    .catch(next);
});
​
...
Get a record
/routes/companies.js
...
​
const {
  PermissionMiddlewareCreator,
  RecordGetter,
} = require('forest-express-sequelize');
const { companies } = require('../models');
​
const permissionMiddlewareCreator = new PermissionMiddlewareCreator('companies');
​
...
​
// Get a Company - Check out our documentation for more details: https://docs.forestadmin.com/documentation/v/v6/reference-guide/routes/default-routes#get-a-record
router.get('/companies/:recordId', permissionMiddlewareCreator.details(), (request, response, next) => {
  const { params, query, user } = request;
  const recordGetter = new RecordGetter(companies, user, query);
​
  recordGetter.get(params.recordId)
    .then(record => recordGetter.serialize(record))
    .then(recordSerialized => response.send(recordSerialized))
    .catch(next);
});
​
Export a list of records
/routes/companies.js
...
​
const {
  PermissionMiddlewareCreator,
  RecordsExporter,
} = require('forest-express-sequelize');
const { companies } = require('../models');
​
const permissionMiddlewareCreator = new PermissionMiddlewareCreator('companies');
​
...
​
// Export a list of Companies - Check out our documentation for more details: https://docs.forestadmin.com/documentation/v/v6/reference-guide/routes/default-routes#export-a-list-of-records
router.get('/companies.csv', permissionMiddlewareCreator.export(), (request, response, next) => {
  const { query, user } = request;
  const recordsExporter = new RecordsExporter(companies, user, query);
​
  recordsExporter
    .streamExport(response)
    .catch(next);
});
Delete a list of records
/routes/companies.js
...
​
const {
  PermissionMiddlewareCreator,
  RecordsRemover,
} = require('forest-express-sequelize');
const { companies } = require('../models');
​
const permissionMiddlewareCreator = new PermissionMiddlewareCreator('companies');
​
...
​
// Delete a list of Companies - Check out our documentation for more details: https://docs.forestadmin.com/documentation/v/v6/reference-guide/routes/default-routes#delete-a-record
router.delete('/companies', permissionMiddlewareCreator.delete(), (request, response, next) => {
  const { query, user } = request;
  
  const recordsGetter = new RecordsGetter(companies, user, query);
  const recordsRemover = new RecordsRemover(companies, user, query);
​
  recordsGetter.getIdsFromRequest(request)
    .then((ids) => recordsRemover.remove(ids))
    .then(() => response.status(204).send())
    .catch(next);
});
Other available routes
Some other routes exist but are not generated automatically because it's less likely that you'll need to extend or override them.
Here is the list:
Relationship routes
GET /forest/{modelName}/{id}/relationships/{hasManyRelationName}
⟶ List has many relationships
GET /forest/{modelName}/{id}/relationships/{hasManyRelationName}/count
⟶ Count has many relationships
PUT /forest/{modelName}/{id}/relationships/{belongsToRelationName}
⟶ Update a belongs to field
POST /forest/{modelName}/{id}/relationships/{hasManyRelationName}
⟶ Add existing records to has many relationship
GET /forest/{modelName}/{id}/relationships/{hasManyRelationName}.csv
⟶ Export all has many relationships
PUT /forest/{modelName}/{id}/relationships/{embeddedRelationName}/{index}
⟶ Update an embedded document (inside a list)
DELETE /forest/{modelName}/{id}/relationships/{hasManyRelationName}
⟶ Dissociate records from relations
Action routes
POST /forest/actions/{actionNameDasherized}/values
⟶ Get the default values for this action
Reference Guide - Previous
Routes
Extend a route
Last updated 1 month ago