Create Report Run

<Warning>This is a beta endpoint. Breaking changes may occur without notice, use at your own risk.</Warning>

Create a new report run for the given report ID.

The report parameters depend on the report being executed, see the report documentation for more info.

Reports are generated asynchronously. The returned object will always be marked as running, you will have to periodically poll for status changes.

post/v1/reporting/reports/runs

Request

  • Base URL
    https://app.untetherlabs.com/api
  • URL
    https://app.untetherlabs.com/api/v1/reporting/reports/runs
  • Auth
    HTTP bearer

Request body

reportIdstring required
parametersobject

Example request

{
  "reportId": "payroll-report",
  "parameters": {
    "startDate": "2025-01-01",
    "endDate": "2025-01-31"
  }
}

Response

idstring uuid required
reportIdstring required
createdAtstring required
status'running' | 'completed' | 'failed' required

Example response

{
  "reportId": "payroll-report",
  "createdAt": "2024-11-20T07:43:34+0000",
  "createdBy": {
    "name": "Bruce Wayne"
  },
  "file": {
    "name": "payroll-2025-01-01.csv",
    "mediaType": "text/csv"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.