Reports

Update a report schedule

This endpoint allows you to update an existing scheduled report export.

Usage notes

Retrieve the reportId by calling the /v2/reports endpoint.
Retrieve the scheduleId by calling the /v2/reports/{reportId}/schedules endpoint.
To add or update a team recipient, retrieve the teamId by calling the /v2/teams endpoint.

Usage scenarios

Audit schedules: Update schedules to ensure they are being exported at the correct times or to the correct recipients.

patch/v2/reports/{reportId}/schedules/{scheduleId}

Request

Base URL
https://api.sigmacomputing.com
Auth
HTTP bearer

Path parameters

reportIdstring required

Unique identifier of the report.

scheduleIdstring required

Unique identifier of the schedule.

Request body

descriptionstring nullable

Description of the scheduled export

suspensionAction'pause' | 'resume'

Action to take on the schedule. Use pause to pause the schedule and resume to resume the schedule.

Response

The response body.

scheduledNotificationIdstring required

Unique identifier of the scheduled export.

reportIdstring required

Unique identifier of the report.

isSuspendedboolean required

Whether the schedule is currently suspended.

ownerIdstring required

Unique identifier of the user who owns the schedule.

lastUpdatedByUserstring required

Unique identifier of the user who last updated the schedule.

disabledAtstring date-time nullable required

Timestamp when the schedule was disabled, or null if the schedule is active.

disabledBystring nullable required

Unique identifier of the member who disabled the schedule, or null if the schedule is active.

createdBystring required

The identifier of the user who created this object.

updatedBystring required

The identifier of the user or process that last updated this object.

createdAtstring date-time required

When the object was created.

updatedAtstring date-time required

When the object was last updated.

Changes

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