---
title: "POST /reporting/reports/{id}/progress"
method: POST
path: "/reporting/reports/{id}/progress"
tags: ["Reports"]
---

# POST /reporting/reports/{id}/progress

`POST /reporting/reports/{id}/progress`

Update report execution progress. Available only for concrete execution and
while is not in a final state, in other words must be either running or deploying.
**WARNING! The update of the generation progress of a given report
is only available to CloudBlue Connect Reports Runner.
External actors cannot update the generation progress of a report.**.

## Path parameters

- `id` string, required

## Request body

- ReportingReportUpdateProgress — Update report progress. Is used to update progress for a concrete report execution. You need to provide the `progress` data as input.
  - `progress` ReportingReportStatsProgress, required — Report stats. Is used to represent current (`value`) and maximum (`max`) progress of the report
    - `value` integer, required
    - `max` integer, required

## Response `200`

- ReportingReport — Report. Is used to represent a concrete report execution.
  - `id` string
  - `name` string, required
  - `description` string, nullable
  - `revision` integer
  - `template` ReportingReportTemplateReference, required — Report template. Is used to represent template attached to this report
    - `id` string
    - `name` string, required
    - `description` string, required
    - `type` string, required
    - `specs_version` string, required
    - `revision` integer
    - `repository` ReportingReportRepositoryReference, required — Report repository. Is used to represent repository attached to this report
      - `id` string
      - `name` string, nullable
      - `git` ReportingGitInfo, required — Git Info. Is used to represent git repository information
        - `url` string, uri, required
        - `tag` string, required
        - `commit` string, nullable
        - `auth` ReportingGitCredentials — Git Credentials. Is used to represent input object to request git tags. You need to provide `username` and `password` to your git repository as input data.
          - `username` string, nullable
          - `password` string, nullable
    - `entrypoint` string, required
    - `local_id` string, required
  - `parameters` object, nullable
  - `events` object
    - `created` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `updated` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `started` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `terminated` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
  - `report_size` integer, nullable
  - `timeout` boolean
  - `status` 'pending' | 'deploying' | 'running' | 'succeeded' | 'failed'
  - `owner` ReportingAccountReference, required
    - `id` string
    - `name` string, required
  - `failure_output` string, nullable
  - `schedule` ReportingReportScheduleReference, required — ReportSchedule. For scheduled reports, represents a reference to the related schedule object.
    - `id` string
    - `name` string, required
  - `renderer` string
  - `report_file` string
  - `report_extension` string
  - `progress` ReportingReportStatsProgress, required — Report stats. Is used to represent current (`value`) and maximum (`max`) progress of the report
    - `value` integer, required
    - `max` integer, required
  - `timing` ReportingReportTiming — Report timing. Is used to represent `run` and `wait` properties of the report
    - `run` string
    - `wait` string

## Other responses

- `400`

---

[API](https://skmtc.net/cloudblue/apis/cloudblue-connect-api.md) · [All operations](https://skmtc.net/cloudblue/apis/cloudblue-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudblue/cloudblue-connect-api/versions/54fef191d46c/schema)