Contents

PATCH [/instances/$INSTANCE]/private/reports/$REPORT_ID#

This is used to update a scheduled report.

Required permission: reports-write

Request:

The request body must be a ReportPatchRequest.

Response:

204 No content:

The report has successfully modified.

400 Bad Request:

The report ID parameter or request body is malformed. Returned with TALER_EC_GENERIC_PARAMETER_MALFORMED.

404 Not found:

The report or instance is unknown to the backend. Returned with TALER_EC_MERCHANT_GENERIC_REPORT_UNKNOWN.

500 Internal Server Error:

The server experienced an internal failure. Returned with TALER_EC_GENERIC_DB_STORE_FAILED.

Details:

interface ReportPatchRequest {

  // Description of the report. Possibly included
  // in the report message.
  description: string;

  // Merchant backend configuration section specifying
  // the program to use to transmit the report
  program_section: string;

  // Mime-type to request from the data source.
  mime_type: string;

  // URL under the instance to request the data from.
  // Must start with '/'. The base URL and the instance
  // prefix will be prefixed to the given data source.
  data_source: string;

  // Address where the report program should send
  // the report.
  target_address: string;

  // Report frequency
  report_frequency: RelativeTime;

  // Report frequency shift. Defaults to zero if missing.
  report_frequency_shift?: RelativeTime;

}