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.

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/rest-apis/reports-v7/docs/getting-started/usage-notes#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