POST /api/report_templates/:id/schedule_report
Schedule generating of a report

The reports are generated asynchronously. If mail_to is not given, action returns an url to get resulting report from (see report_data).

Examples

POST /api/report_templates/:id/schedule_report/
200
{
  "job_id": UNIQUE-REPORT-GENERATING-JOB-UUID
  "data_url": "/api/v2/report_templates/1/report_data/UNIQUE-REPORT-GENERATING-JOB-UUID"
}

Params

Param name Description
location_id
optional

Set the current location context for the request

Validations:

  • Integer
organization_id
optional

Set the current organization context for the request

Validations:

  • Integer
id
required

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, ‘‘, ‘-’ with no leading or trailing space..
input_values
optional

Hash of input values where key is the name of input, value is the value for this input

Validations:

  • Hash
gzip
optional

Compress the report using gzip

Validations:

  • Must be one of: true, false, 1, 0.
mail_to
optional

If set, scheduled report will be delivered via e-mail. Use ‘,’ to separate multiple email addresses.

Validations:

  • String
generate_at
optional

UTC time to generate report at

Validations:

  • String
report_format
optional

Report format, defaults to ‘csv’

Validations:

  • Must be one of: csv, json, yaml, html.