Report Subscription - Updates a subscription

Updates an existing subscription associated with a report.

put

Authorizations

Path parameters

reportSubscriptionIdstring · uuidRequired

Enter ID of an existing subscription

reportIdstring · uuidRequired

Enter ID of an existing report

Query parameters

versionstringOptional

The requested API version

Default: 1.0

Header parameters

embedfast-user-idstringOptional

Optional User Id

embedfast-user-emailstringOptional

Optional User Email

Body

application/jsontext/jsonapplication/*+json

Class for representing a request to create a new subscription for a report.

subscriptionNamestring | nullableOptional

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the subscriptionName property.

bookmarkStatestring | nullableOptional

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the bookmarkState property.

schedulestring | nullableOptional

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the schedule property.

subscribersstring[] | nullableOptional

A public property of type list of string that has both a getter and a setter method, which allows for getting and setting the value of the subscribers property.

subjectstring | nullableOptional

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the subject property.

contentstring | nullableOptional

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the content property.

isActivebooleanOptional

A public property of type bool that has both a getter and a setter method, which allows for getting and setting the value of the isActive property.

reportPageNamestring | nullableOptional

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the reportPage property.

startDateTimestring · date-timeOptional

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the StartDateTime property.

endDateTimestring · date-timeOptional

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the EndDateTime property.

timeZonestring | nullableOptional

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the TimeZone(IST etc) property.

hasAttachmentbooleanOptional

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the HasAttachment property.

Responses

200

Success: Subscription details successfully updated.

text/plainapplication/jsontext/json

304

Not Modified: The subscription has not been modified.

text/plainapplication/jsontext/json

400

Bad Request: The request could not be processed due to invalid syntax or missing/incorrect parameters.

text/plainapplication/jsontext/json

401

Unauthorized: Invalid credentials or missing/invalid authentication token.

text/plainapplication/jsontext/json

403

Forbidden: Access denied to update the subscription due to insufficient permissions or account restrictions.

text/plainapplication/jsontext/json

404

Not Found: The specified report or subscription does not exist.

text/plainapplication/jsontext/json

500

Internal Server Error: An unexpected error occurred or a server timeout.

text/plainapplication/jsontext/json

put

HTTPcURLJavaScriptPython

PUT /reports/{reportId}/subscriptions/{reportSubscriptionId} HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 562

{
  "subscriptionName": "Monthly Report Subscription",
  "bookmarkState": "Active",
  "schedule": "0 0 1 * *",
  "subscribers": [
    "[e-mail]",
    "[e-mail]"
  ],
  "subject": "Monthly Report Summary",
  "content": "This is the content of the monthly report subscription.",
  "isActive": true,
  "reportPageName": "Sales Dashboard",
  "startDateTime": "2024-09-01T09:00:00",
  "endDateTime": "2024-09-30T18:00:00",
  "timeZone": "(UTC+05:30) Chennai, Kolkata, Mumbai, New Delhi",
  "reportParameter": [
    {
      "name": "Parameter1",
      "value": "Value1"
    },
    {
      "name": "Parameter2",
      "value": "Value2"
    }
  ],
  "hasAttachment": true
}

application/jsontext/jsonapplication/*+json

{
  "message": "Success Message",
  "statusCode": 200
}