RestApiCategories.visualizationAndReports.desc

visualization_and_reports

2023.10

2023.03

2024.10

2024.03

2024.09

2024.08

2024.11

2024.12

You can use the Reports API to create, read, and update reports. This API enables basic tasks such as moving or renaming reports, as well as editorial tasks such as reading, writing, and updating report content.


Reports

Saves the report content. Does not return the stored content. An `ETag` is not required for the initial save, but is required for all subsequent saves. In some situations, where an Accept type header is automatically generated, setting it to '\*/\*' will achieve the same effect as omitting it. See [`Conditional Operations`](https://developer.sas.com/rest-apis/reports-v7/docs/getting-started/usage-notes#conditional-operations).

The representation of a report content in JSON format. Check [`Get Versions`](#/ReportContent/getReportContentVersions) and [`GET /versions/@defaultVersion`](#/ReportContent/getDefaultReportContentVersion) for the set of valid media types and versions as defined by `Business Intelligence Report Definition`.  If not provided, for request the version equivalent to the report content schema is used and for response latest version is used.

Report Content JSON

application/vnd.sas.report.content

The representation of a report content in XML format. Check [`Get Versions`](#/ReportContent/getReportContentVersions) and [`GET /versions/@defaultVersion`](#/ReportContent/getDefaultReportContentVersion) for the set of valid media types and versions as defined by `Business Intelligence Report Definition`. If not provided, for request the version equivalent to the report content schema is used and for response latest version is used. The schema of this XML example is just for the example and therefore is only a very small subset of `Business Intelligence Report Definition`

Report Content XML

SASReport

The `ETag` that was returned from a `GET`, `POST`, `PUT`, or `HEAD` of this resource. If the `ETag` does not match, the update will fail.

If-Match

The value of the `modifiedTimeStamp` of the resource.  If the resource has been updated since this time, the update will fail.

If-Unmodified-Since

reportId

The flag to create copy of all dependent file resources.

copyDependentFiles

A tag that identifies this revision of the resource.

ETag

The last `modifiedTimeStamp` of the resource.

Last-Modified

Error

application/vnd.sas.error

The report or report content does not exist.

An error for report content is found but with mismatched ETag.

The `If-Match` or `If-Unmodified-Since` header did not match the current version of the resource.

The request is missing the required ETag ('If-Match' or 'If-Unmodified-Since') header.

The `If-Match` or `If-Unmodified-Since` was not provided when updating the report content.

Save report content

The list of links to top-level resources and operations available from the root of the API.

Report Collection

The representation of a report. This representation is version 1.  Optional `version=1` parameter is the only `version` parameter that can be included.

Report

The representation of a report. This representation is version 1.  Optional `version=1` parameter is the only one that can be included.

New Report

The summarized representation of a resource. Often used in collection responses when more specific details aren't needed.

Resource Summary

Update Report

Report Version Collection

Report Version

The representation of a report content validation.

Report Content Validation

Report Content Elements Collection

The representation of a report state.  This is version 1 of the representation.

Report State

Report State Collection

The representation of a new report state.

New Report State

The representation of an updated report state.

Update Report State

The representation of a report state content, which has the same schema as report content, in JSON format. Check [`Get Versions`](#/ReportContent/getReportContentVersions) and [`GET /versions/@defaultVersion`](#/ReportContent/getDefaultReportContentVersion) for the set of valid media types and versions as defined by `Business Intelligence Report Definition`.  If not provided, for request the version equivalent to the report content schema is used and for response latest version is used.  The lowest valid version is 3.

The representation of a report state content, which has the same schema as report content, in XML format. Check [`Get Versions`](#/ReportContent/getReportContentVersions) and [`GET /versions/@defaultVersion`](#/ReportContent/getDefaultReportContentVersion) for the set of valid media types and versions as defined by `Business Intelligence Report Definition`. If not provided, for request the version equivalent to the report content schema is used and for response latest version is used. The lowest valid version is 3. The schema of this XML example is just for the example and therefore is only a very small subset of `Business Intelligence Report Definition`

Report State Content XML

Content providers may use this media type and appropriate endpoint to provide dependency information to the transfer service.

Transfer Dependencies

The representation of a report content element version 2.

Report content element

Content providers implementing the Transfer Object Provider contract use this media type to store information about the content to be transfered.

Transfer Object

Indxable representation of SAS type owner's data that searchindex service uses for indexing.

Indexable representation

A relationship describes how two resources are related. The relationship contains a *subject* resource, the related resource, and the relationship type.

Relationship

This is a base schema used to define paginated collections of resources. This base schema is extended by other schemas in APIs by adding an 'items' array property. These extensions define the application/vnd.sas.collection media type (version 2)

Base Collection

The representation of a report content element.

A link to a related operation or resource.

Link

The definition for attribute that needs to be used within indexable representation. Here attribute is name,value Pair

Property

Content providers implementing the Transfer Object Provider contract use this media type to provide connection information for the content to be transfered.

Name	Type	Required	Description
If-Match	string	false	The `ETag` that was returned from a `GET`, `POST`, `PUT`, or `HEAD` of this resource. If the `ETag` does not match, the update will fail.
If-Unmodified-Since	string	false	The value of the `modifiedTimeStamp` of the resource. If the resource has been updated since this time, the update will fail.

Status	Meaning	Description
204	No Content	The report content was stored.	Headers
400	Bad Request	The input report content was not valid.		Schema
404	Not Found	The report or report content does not exist.		Schema
412	Precondition Failed	The `If-Match` or `If-Unmodified-Since` header did not match the current version of the resource.		Schema
428	Precondition Required	The `If-Match` or `If-Unmodified-Since` was not provided when updating the report content.		Schema

Save report content

Request Samples

Response Samples

Path Parameters

Query Parameters

Header Parameters

Request Body

Responses