Create report

post/reports
Internal-Use Only

Creates a new report and adds it to a folder as a child.

Request Samples

1

Response Samples

1{
2  "id": "f8b66d4b-d67a-4e4e-a66d-b6f06b1820bf",
3  "name": "Sample Report",
4  "description": "Description of a sample report.",
5  "creationTimeStamp": "2019-08-24T14:15:22Z",
6  "createdBy": "user1",
7  "modifiedTimeStamp": "2019-08-24T14:15:22Z",
8  "modifiedBy": "user1",
9  "links": [
10    {
11      "method": "GET",
12      "rel": "self",
13      "href": "/reports/reports/f8b66d4b-d67a-4e4e-a66d-b6f06b1820bf",
14      "uri": "/reports/reports/f8b66d4b-d67a-4e4e-a66d-b6f06b1820bf",
15      "type": "application/vnd.sas.report"
16    },
17    {
18      "method": "GET",
19      "rel": "alternate",
20      "href": "/reports/reports/f8b66d4b-d67a-4e4e-a66d-b6f06b1820bf",
21      "uri": "/reports/reports/f8b66d4b-d67a-4e4e-a66d-b6f06b1820bf",
22      "type": "application/vnd.sas.summary"
23    },
24    {
25      "method": "PUT",
26      "rel": "update",
27      "href": "/reports/reports/f8b66d4b-d67a-4e4e-a66d-b6f06b1820bf",
28      "uri": "/reports/reports/f8b66d4b-d67a-4e4e-a66d-b6f06b1820bf",
29      "type": "application/vnd.sas.report",
30      "responseType": "application/vnd.sas.report"
31    },
32    {
33      "method": "PUT",
34      "rel": "updateContent",
35      "href": "/reports/reports/f8b66d4b-d67a-4e4e-a66d-b6f06b1820bf/content",
36      "uri": "/reports/reports/f8b66d4b-d67a-4e4e-a66d-b6f06b1820bf/content",
37      "type": "application/vnd.sas.report.content",
38      "responseType": "application/vnd.sas.report.content"
39    }
40  ],
41  "imageUris": {
42    "icon": "/reports/icons/report.gif"
43  },
44  "version": 1
45}

Query Parameters

NameTypeRequiredDescription
parentFolderUri
string<uri>
true

The URI of the parent folder of the report.

Request Body

The report to create. A full report can be included, but only the name and description are used to create the new report.

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

Example:
{"name":"TEST New Report","description":"TEST New Description"}
NameTypeRequiredDescription
name
string
false

The localizable report name.

description
string
false

The localizable report description.

Responses

StatusMeaningDescription
201CreatedNew report created. Use the `updateContent` link in the new report to store the report content. `ETag` header is returned. See [`Conditional Operations`](https://developer.sas.com/apis/rest/Topics/#conditional-operations).HeadersSchema
400Bad RequestThe input report is invalid, or the `parentFolderUri` is not a valid folder URI or is not found.Schema
409ConflictA report with the same name is already a member of the folder.Schema