Skip to main content
PUT
/
scheduled-reports
/
{report_id}
Update scheduled report
curl --request PUT \
  --url https://api.qonversion.io/v4/scheduled-reports/{report_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "report_name": "<string>",
  "send_at": "<string>",
  "included_range_days": 1,
  "status": "draft",
  "environment": "sandbox",
  "destinations": [
    {
      "type": "target_integration",
      "id": "int-wh-01",
      "label": "Webhooks: Release alerts"
    }
  ]
}
'
{
  "object": "scheduled_report",
  "id": "wbRlfw1x",
  "url": "/v4/scheduled-reports/wbRlfw1x",
  "report_name": "Daily Revenue",
  "send_at": "09:00",
  "included_range_days": 1,
  "status": "active",
  "environment": "production",
  "runs": 14,
  "destinations": [
    {
      "type": "target_integration",
      "id": "int-wh-01",
      "label": "Webhooks: Release alerts"
    }
  ],
  "created_at": "2026-04-23T11:44:36Z",
  "updated_at": "2026-04-23T11:44:36Z"
}

Documentation Index

Fetch the complete documentation index at: https://documentation.qonversion.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication using the project Secret Key (prefixed with sk_, or test_sk_ for sandbox). All v4 public endpoints require the Secret Key — see Authentication. Never expose the Secret Key in client-side code.

Path Parameters

​
report_id
string
required
Maximum string length: 64
Pattern: ^[a-zA-Z0-9._-]+$

Body

application/json

Partial update — omit any field to keep its current value. At least one field must be supplied; an empty body returns 400 invalid_data.

​
report_name
string
Required string length: 1 - 255
​
send_at
string
​
included_range_days
enum<integer>
Available options:
1,
3,
7
​
status
enum<string>
Available options:
draft,
active
​
environment
enum<string>
Available options:
sandbox,
production
​
destinations
object[]
Minimum array length: 1

Response

Updated scheduled report.

A scheduled report configuration. Delivers an analytics snapshot to the listed destinations once per day at send_at UTC, covering the prior included_range_days days of data.

​
object
string
required
Example:

"scheduled_report"

​
id
string
required

Report identifier.

Example:

"wbRlfw1x"

​
url
string
required
Example:

"/v4/scheduled-reports/wbRlfw1x"

​
report_name
string
required

Human-readable name, 1-255 chars.

Example:

"Daily Revenue"

​
send_at
string
required

UTC time-of-day for the daily delivery, HH:MM format, aligned to 30-minute slots. Valid values range from "00:00" to "23:30".

Example:

"09:00"

​
included_range_days
enum<integer>
required

Coverage window in whole days — one of 1, 3, 7.

Available options:
1,
3,
7
Example:

1

​
status
enum<string>
required

draft — paused, no deliveries. active — enqueued for delivery at each send_at.

Available options:
draft,
active
Example:

"active"

​
environment
enum<string>
required
Available options:
sandbox,
production
Example:

"production"

​
runs
integer
required

Number of deliveries completed so far.

Example:

14

​
destinations
object[]
required
​
created_at
string<date-time>
required
Example:

"2026-04-23T11:44:36Z"

​
updated_at
string<date-time>
required
Example:

"2026-04-23T11:44:36Z"