ironOauthToken - This is the oauth token of the project to which matching tasks will be queued. This can also be set as an environment variable named 'IRON_TOKEN'. See the comments in the iron-scheduler.worker file. If passed in the payload it will override the environment variable.

ironProjectId - This is the project id of the project to which matching tasks will be queued. This can also be set as an environment variable named 'IRON_PROJECT_ID'. See the comments in the iron-scheduler.worker file. If passed in the payload it will override the environment variable.

name - This value is used only by Iron Scheduler for logging out information on what it did to help you track what got queued. Required.

schedule - Whenever Iron Scheduler runs it uses this value to decide whether or not to queue the scheduled task. This value is a regular expression that is matched against the Date object UTC string. This page is extremely helpful in contructing regex strings that give you the matches you want. Don't forget to escape the backslashes when you put it into the JSON. Required.

expires - A date UTC string specifying until when Iron Scheduler should attempt to schedule this scheduled task. Optional.

number - When the schedule matches, this value specifies how many of the specified tasks to queue up. Required.

interval - When the schedule matches, this value specifies how long of an interval (in seconds) there should be between each of the tasks that will be queued. So for example, if number is 3 and interval is 20, Iron Schedule will queue three tasks, the first one with a delay of 0, the second with a delay of 20 and the third with a delay of 40. Optional.

task - Details of the actual task to queue. Required.

code_name - The name of the task to queue. Must match the name that's in ironio. Required.

payload OR payloadSecret - The payload to pass to the task that will be queued. Using payloadSecret will filter the entire payload from the HUD view showing runs of Iron Scheduler. It has no other effect. Required.

The logger is a winston logger, and is optional. If omitted you'll get console and file logging through a winston console logger; see the config.js file for details.
The scheduledTasks parameter is an array of tasks in the same format as in the example payload above.

Current Limitations / Future Work

If a scheduled task is expired Iron Scheduler currently bombs (on purpose). Not sure what the correct logic should be.

If interval is omitted or set to 0 then it is treated as 1. This means that if number is greater than 1, the queued tasks won't be scheduled to be perfectly concurrent; rather each will have a delay of (n-1) seconds.

Right now each queued task is its own API call, but the ironio API supports queueing multiple tasks in one call.