Skip to main content
PUT
Error

Authorizations

x-cdata-authtoken
string
header
required

Path Parameters

Name
string
required

The key Name

Body

application/json

The reports entity to update.

Name
string
required

The report name.

Columns
string

The columns in the report. Required when creating a new report. Available values include one or more of: 'WorkspaceId, ConnectorId, ConnectorType, Year, Quarter, Month, Week, SenderISAId, ReceiverISAId, TransactionSet, AllTransactions, TransactionsSent, TransactionsReceived, TotalProcessingTime, TotalFileSize, Successful, Error, Warning'.

CreatedTime
string<date-time>

The time the report was created.

TimePeriod
string

The time period, such as Last3Months or YearToDate, that the report uses to pull data. Available values are 'All, LastMonth, Last3Months, Last6Months, Last12Months, MonthToDate, QuarterToDate, YearToDate, SinceLastRun, Custom'.

Type
string

The report type. Available values are 'Transactions, Application'.

TimePeriodEnd
string<date-time>

If the TimePeriod is Custom, this is the report end time. For example: 2026-02-11T17:00:00.0000-07:00

Summary
string

Any summary information, such as Total or Average, that should be included in the generated report.

EmailReport
boolean

Whether to send the report via email.

Filters
string

Any filters that should be used for the report, such as ConnectorType=SFTP,FTP;ConnectorId=SFTP1,SFTP2,FTP1,FTP2.

ModifiedTime
string<date-time>

The time the report was last modified.

TimePeriodStart
string<date-time>

If the TimePeriod is Custom, this is the report start time.

IsRunning
string

Whether the report is running.

EndDate
string<date-time>

For any TimePeriod other than Custom, this is the report end date in this format: YYYY-MM-DD. For example: 2026-01-28

CreatedBy
string

The user who created the report.

GroupRows
string

The rows, such as Week or ConnectorType, to group by in the report. Available values include one or more of: 'WorkspaceId, ConnectorCategory, ConnectorId, Year, Quarter, Month, Week, SenderISAId, ReceiverISAId, TransactionSet'.

EmailSubject
string

If EmailReport is True, this is the email subject line.

NextRunTime
string<date-time>

The next time the report is scheduled to run.

Format
string

The report format, such as CSV.

Schedule
string

The cron schedule that controls when the report is run.

StartDate
string<date-time>

For any TimePeriod other than Custom, this is the report start date in this format: YYYY-MM-DD. For example: 2026-01-28

EmailRecipients
string

If EmailReport is True, this is a comma-separated list of email recipients.

Response

EntitySet reports

Name
string
required

The report name.

Columns
string

The columns in the report. Required when creating a new report. Available values include one or more of: 'WorkspaceId, ConnectorId, ConnectorType, Year, Quarter, Month, Week, SenderISAId, ReceiverISAId, TransactionSet, AllTransactions, TransactionsSent, TransactionsReceived, TotalProcessingTime, TotalFileSize, Successful, Error, Warning'.

CreatedTime
string<date-time>

The time the report was created.

TimePeriod
string

The time period, such as Last3Months or YearToDate, that the report uses to pull data. Available values are 'All, LastMonth, Last3Months, Last6Months, Last12Months, MonthToDate, QuarterToDate, YearToDate, SinceLastRun, Custom'.

Type
string

The report type. Available values are 'Transactions, Application'.

TimePeriodEnd
string<date-time>

If the TimePeriod is Custom, this is the report end time. For example: 2026-02-11T17:00:00.0000-07:00

Summary
string

Any summary information, such as Total or Average, that should be included in the generated report.

EmailReport
boolean

Whether to send the report via email.

Filters
string

Any filters that should be used for the report, such as ConnectorType=SFTP,FTP;ConnectorId=SFTP1,SFTP2,FTP1,FTP2.

ModifiedTime
string<date-time>

The time the report was last modified.

TimePeriodStart
string<date-time>

If the TimePeriod is Custom, this is the report start time.

IsRunning
string

Whether the report is running.

EndDate
string<date-time>

For any TimePeriod other than Custom, this is the report end date in this format: YYYY-MM-DD. For example: 2026-01-28

CreatedBy
string

The user who created the report.

GroupRows
string

The rows, such as Week or ConnectorType, to group by in the report. Available values include one or more of: 'WorkspaceId, ConnectorCategory, ConnectorId, Year, Quarter, Month, Week, SenderISAId, ReceiverISAId, TransactionSet'.

EmailSubject
string

If EmailReport is True, this is the email subject line.

NextRunTime
string<date-time>

The next time the report is scheduled to run.

Format
string

The report format, such as CSV.

Schedule
string

The cron schedule that controls when the report is run.

StartDate
string<date-time>

For any TimePeriod other than Custom, this is the report start date in this format: YYYY-MM-DD. For example: 2026-01-28

EmailRecipients
string

If EmailReport is True, this is a comma-separated list of email recipients.