ActionHero. Action

new Action()

Name Type Description
name string

The name of the Action.

description string

The description of the Action (default

version Number

The version of this Action (default: 1).

outputExample Object

An example response payload (default: {}).

inputs Object

The inputs of the Action (default: {}).

middleware Array

The Middleware specifit to this Action (default: []). Middleware is descibed by the string names of the middleware.

blockedConnectionTypes Array

Are there connections from any servers which cannot use this Action (default: [])?

logLevel string

Under what level should connections to this Action be logged (default 'info')?

matchExtensionMimeType Boolean

If this Action is responding to a web request, and that request has a file extension like *.jpg, should ActionHero set the response headers to match that extension (default: true)?

toDocument Boolean

Should this Action appear in api.documenation.documenation? (default: true)?

Create a new ActionHero Action. The required properties of an action. These can be defined statically ( or as methods which return a value.

const {Action} = require('actionhero')

module.exports = class RandomNumber extends Action {
 constructor () {
   super() = 'randomNumber'
   this.description = 'I am an API method which will generate a random number'
   this.outputExample = {randomNumber: 0.1234}

 async run ({response}) {
   response.randomNumber = Math.random()


(async, static) run(data)


The main "do something" method for this action. It can be async. Usually the goal of this run method is to set properties on data.response. If error is thrown in this method, it will be logged, caught, and appended to data.response.error

Name Type Description
data Object

The data about this connection, response, and params.