Create multiple annotations

post/annotations

Multi-POST. This operation is used to add multiple annotation that do not exists. All successfully created annotations will be returned in the response body in the same order that they were provided in the request body. For any annotation that failed to be created, the collection returned will contain an application/vnd.sas.error object in place of application/vnd.sas.annotation object.

Request Samples

1

Response Samples

1{
2  "count": 2,
3  "limit": 2,
4  "version": 2,
5  "items": [
6    {
7      "id": "f9bd5124-418f-4326-86cf-b6d98d57778",
8      "name": "Annotation1",
9      "domain": "DomainLabel1",
10      "description": "Description1",
11      "label": "Label1",
12      "creationTimeStamp": "2023-04-10 18:02:07.986000+00:00",
13      "modifiedTimeStamp": "2023-04-10 18:02:07.986000+00:00",
14      "createdBy": "etlguest",
15      "modifiedBy": "etlguest",
16      "links": [
17        {
18          "method": "POST",
19          "rel": "create",
20          "href": "/annotations/annotations",
21          "uri": "/annotations/annotations",
22          "type": "application/vnd.sas.annotation",
23          "responseType": "application/vnd.sas.annotation"
24        },
25        {
26          "method": "GET",
27          "rel": "self",
28          "href": "/annotations/annotations/f9bd5124-418f-4326-86cf-b6d98d57778",
29          "uri": "/annotations/annotations/f9bd5124-418f-4326-86cf-b6d98d57778",
30          "type": "application/vnd.sas.annotation"
31        },
32        {
33          "method": "PUT",
34          "rel": "update",
35          "href": "/annotations/annotations/f9bd5124-418f-4326-86cf-b6d98d57778",
36          "uri": "/annotations/annotations/f9bd5124-418f-4326-86cf-b6d98d57778",
37          "type": "application/vnd.sas.annotation"
38        },
39        {
40          "method": "DELETE",
41          "rel": "delete",
42          "href": "/annotations/annotations/f9bd5124-418f-4326-86cf-b6d98d57778",
43          "uri": "/annotations/annotations/f9bd5124-418f-4326-86cf-b6d98d57778"
44        }
45      ]
46    },
47    {
48      "id": "y8bd5124-418f-4326-86cf-b6d98d57778",
49      "name": "Annotation2",
50      "domain": "DomainLabel2",
51      "description": "Description2",
52      "creationTimeStamp": "2023-04-10 18:02:07.986000+00:00",
53      "modifiedTimeStamp": "2023-04-10 18:02:07.986000+00:00",
54      "createdBy": "etlguest",
55      "modifiedBy": "etlguest",
56      "links": [
57        {
58          "method": "POST",
59          "rel": "create",
60          "href": "/annotations/annotations",
61          "uri": "/annotations/annotations",
62          "type": "application/vnd.sas.annotation",
63          "responseType": "application/vnd.sas.annotation"
64        },
65        {
66          "method": "GET",
67          "rel": "self",
68          "href": "/annotations/annotations/y8bd5124-418f-4326-86cf-b6d98d57778",
69          "uri": "/annotations/annotations/y8bd5124-418f-4326-86cf-b6d98d57778",
70          "type": "application/vnd.sas.annotation"
71        },
72        {
73          "method": "PUT",
74          "rel": "update",
75          "href": "/annotations/annotations/y8bd5124-418f-4326-86cf-b6d98d57778",
76          "uri": "/annotations/annotations/y8bd5124-418f-4326-86cf-b6d98d57778",
77          "type": "application/vnd.sas.annotation"
78        },
79        {
80          "method": "DELETE",
81          "rel": "delete",
82          "href": "/annotations/annotations/y8bd5124-418f-4326-86cf-b6d98d57778",
83          "uri": "/annotations/annotations/y8bd5124-418f-4326-86cf-b6d98d57778"
84        }
85      ]
86    }
87  ]
88}

Request Body

List of annotations to be created.

Collection of annotations to be created.

NameTypeRequiredDescription
items
array [Create Annotation]
false

List of annotations

Responses

StatusMeaningDescription
200OK

At least one annotation was created. If individual resource creation fails, the corresponding item in the response collection will be an application/vnd.sas.error object that describes why/how that operation failed. The httpStatusCode member of the nested error item will indicate the failure (401, 403, etc.).

Schema
400Bad Request

The request was invalid.

Schema