solarwinds-itsm-api-definitions 0.0.4 → 0.0.5
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/definitions/common/components.json +122 -0
- data/lib/definitions/common/examples/incident.json +115 -0
- data/lib/definitions/common/schemas/incident.json +84 -13
- data/lib/definitions/openapi.json +10 -3
- data/lib/definitions/paths/incidents/incident_by_id.json +39 -18
- data/lib/definitions/paths/incidents/incidents.json +41 -0
- data/lib/resolved_schema/resolved_schema.json +1 -1
- metadata +7 -5
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 8681638e9f605dcbd140964d4e6dec0c72e7a3b89b6f5eefbacd76b46e31949f
|
|
4
|
+
data.tar.gz: e43a3f1befd2cb7778ba597f88d276206339cc0d22dc39abff4b047ba6097fcb
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: af5f5afc4396eeee4c73daf90c037dee0d99efa6dd2d2c84236a14a941c781fde12f28850544aa4c727de4ec9ccf3a5b414e6407a952410e25353884f41390fd
|
|
7
|
+
data.tar.gz: 564d64cf7b1fa69f6e898622861d1d5bd7020ff9436a13293957749911ba4f5ad3643465e50eea118f6afaac226c7c26f2ec8633f9c93cc532d80c7463df1ad9
|
|
@@ -40,6 +40,128 @@
|
|
|
40
40
|
}
|
|
41
41
|
},
|
|
42
42
|
{ "enum": ["nil", "", null] }]
|
|
43
|
+
},
|
|
44
|
+
"id": {
|
|
45
|
+
"readOnly": true,
|
|
46
|
+
"oneOf": [{ "type": "string" }, { "type": "integer" }]
|
|
47
|
+
},
|
|
48
|
+
"custom_field": {
|
|
49
|
+
"type": "object",
|
|
50
|
+
"oneOf": [{
|
|
51
|
+
"type": "object",
|
|
52
|
+
"required": ["name", "value"],
|
|
53
|
+
"properties": {
|
|
54
|
+
"name": { "type": "string" },
|
|
55
|
+
"value": { "type": "string" }
|
|
56
|
+
}
|
|
57
|
+
}]
|
|
58
|
+
},
|
|
59
|
+
"custom_field_value": {
|
|
60
|
+
"type": "array",
|
|
61
|
+
"items": {
|
|
62
|
+
"allOf": [{ "$ref": "../common/components.json#/components/schemas/custom_field" }]
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
"custom_field_values": {
|
|
66
|
+
"type": "object",
|
|
67
|
+
"oneOf": [{
|
|
68
|
+
"type": "object",
|
|
69
|
+
"required": ["custom_field_value"],
|
|
70
|
+
"properties": {
|
|
71
|
+
"custom_field_value": { "$ref": "../common/components.json#/components/schemas/custom_field_value" }
|
|
72
|
+
}
|
|
73
|
+
}]
|
|
74
|
+
},
|
|
75
|
+
"category_subcategory": {
|
|
76
|
+
"type": "object",
|
|
77
|
+
"properties": {
|
|
78
|
+
"id": { "$ref": "../common/components.json#/components/schemas/id" },
|
|
79
|
+
"name": { "type": "string" },
|
|
80
|
+
"default_tags": { "type": "string" },
|
|
81
|
+
"parent_id": { "$ref": "../common/components.json#/components/schemas/id" },
|
|
82
|
+
"default_assignee_id": { "$ref": "../common/components.json#/components/schemas/id" }
|
|
83
|
+
}
|
|
84
|
+
},
|
|
85
|
+
"avatar": {
|
|
86
|
+
"type": "object",
|
|
87
|
+
"properties": {
|
|
88
|
+
"type": { "type": "string" },
|
|
89
|
+
"color": { "type": "string" },
|
|
90
|
+
"initials": {
|
|
91
|
+
"type": "string",
|
|
92
|
+
"minLength": 2,
|
|
93
|
+
"maxLength": 2
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
},
|
|
97
|
+
"requester_assignee_details": {
|
|
98
|
+
"type": "object",
|
|
99
|
+
"properties": {
|
|
100
|
+
"group_id": { "oneOf": [{ "type": "string" }, { "type": "integer" }] },
|
|
101
|
+
"is_user": { "oneOf": [{ "type": "string" }, { "type": "boolean" }] },
|
|
102
|
+
"id": { "$ref": "../common/components.json#/components/schemas/id" },
|
|
103
|
+
"name": { "type": "string" },
|
|
104
|
+
"email": { "type": "string" },
|
|
105
|
+
"avatar": { "$ref": "../common/components.json#/components/schemas/avatar" }
|
|
106
|
+
}
|
|
107
|
+
},
|
|
108
|
+
"site_response": {
|
|
109
|
+
"type": "object",
|
|
110
|
+
"properties": {
|
|
111
|
+
"id": { "$ref": "../common/components.json#/components/schemas/id" },
|
|
112
|
+
"name": { "type": "string" },
|
|
113
|
+
"description": { "type": "string" },
|
|
114
|
+
"location": { "type": "string" },
|
|
115
|
+
"timezone": { "type": "string" }
|
|
116
|
+
}
|
|
117
|
+
},
|
|
118
|
+
"department_response": {
|
|
119
|
+
"type": "object",
|
|
120
|
+
"properties": {
|
|
121
|
+
"id": { "$ref": "../common/components.json#/components/schemas/id" },
|
|
122
|
+
"name": { "type": "string" },
|
|
123
|
+
"description": { "type": "string" },
|
|
124
|
+
"default_assignee_id": { "$ref": "../common/components.json#/components/schemas/id" }
|
|
125
|
+
}
|
|
126
|
+
},
|
|
127
|
+
"ids_array": {
|
|
128
|
+
"type": "array",
|
|
129
|
+
"items": {
|
|
130
|
+
"$ref": "../common/components.json#/components/schemas/association_by_id"
|
|
131
|
+
}
|
|
132
|
+
},
|
|
133
|
+
"numbers_array": {
|
|
134
|
+
"type": "array",
|
|
135
|
+
"items": {
|
|
136
|
+
"type": "object",
|
|
137
|
+
"properties": {
|
|
138
|
+
"number": {
|
|
139
|
+
"oneOf": [{ "type": "string" }, { "type": "integer" }]
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
},
|
|
144
|
+
"incidents_attachments": {
|
|
145
|
+
"type": "object",
|
|
146
|
+
"properties": {
|
|
147
|
+
"incident": { "$ref": "../common/components.json#/components/schemas/numbers_array" }
|
|
148
|
+
}
|
|
149
|
+
},
|
|
150
|
+
"solutions_attachments": {
|
|
151
|
+
"type": "object",
|
|
152
|
+
"properties": {
|
|
153
|
+
"solution": { "$ref": "../common/components.json#/components/schemas/numbers_array" }
|
|
154
|
+
}
|
|
155
|
+
},
|
|
156
|
+
"response_attachments": {
|
|
157
|
+
"type": "array",
|
|
158
|
+
"items": {
|
|
159
|
+
"type": "object",
|
|
160
|
+
"properties": {
|
|
161
|
+
"id": { "$ref": "../common/components.json#/components/schemas/association_by_id" },
|
|
162
|
+
"href": { "type": "string" }
|
|
163
|
+
}
|
|
164
|
+
}
|
|
43
165
|
}
|
|
44
166
|
}
|
|
45
167
|
}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
{
|
|
2
|
+
"examples": {
|
|
3
|
+
"request": {
|
|
4
|
+
"json": {
|
|
5
|
+
"incident": {
|
|
6
|
+
"name": "IncidentName",
|
|
7
|
+
"site_id": 0,
|
|
8
|
+
"department_id": 0,
|
|
9
|
+
"description": "DESCRIPTION",
|
|
10
|
+
"state_id": 0,
|
|
11
|
+
"assignee": { "email": "EMAIL" },
|
|
12
|
+
"requester": { "email": "EMAIL" },
|
|
13
|
+
"priority": "PRIORITY",
|
|
14
|
+
"category": { "name": "CATEGORY" },
|
|
15
|
+
"subcategory": { "name": "SUBCATEGORY" },
|
|
16
|
+
"due_at": "Dec 11,2022",
|
|
17
|
+
"add_to_tag_list": "tag1, tag2, tag3",
|
|
18
|
+
"custom_fields_values": {
|
|
19
|
+
"custom_fields_value": [
|
|
20
|
+
{ "name": "field name", "value": "content" }
|
|
21
|
+
]
|
|
22
|
+
},
|
|
23
|
+
"incidents": { "incident": [{ "number": "123" }] },
|
|
24
|
+
"problems": [{ "number": "123" }],
|
|
25
|
+
"changes": [{ "number": "123" }],
|
|
26
|
+
"solutions": { "solution": [{ "number" :"123" }]},
|
|
27
|
+
"releases": [{ "number": "123" }],
|
|
28
|
+
"configuration_item_ids":["123"]
|
|
29
|
+
}
|
|
30
|
+
},
|
|
31
|
+
"xml": {
|
|
32
|
+
"description": "shouldn't work due to bug in openApi - https://github.com/springdoc/springdoc-openapi/issues/719",
|
|
33
|
+
"xml": "<root><incident><site><name>NAME</name></site><department_id>0</department_id><description>DESCRIPTION</description><state>NAME</state><assignee><email>EMAIL</email></assignee></incident></root>"
|
|
34
|
+
}
|
|
35
|
+
},
|
|
36
|
+
"response": {
|
|
37
|
+
"json": {
|
|
38
|
+
"incident": {
|
|
39
|
+
"id": "0000",
|
|
40
|
+
"number": "0001",
|
|
41
|
+
"name": "IncidentName",
|
|
42
|
+
"description": "DESCRIPTION",
|
|
43
|
+
"state": "NAME",
|
|
44
|
+
"site": {
|
|
45
|
+
"id": "0",
|
|
46
|
+
"name": "SITE",
|
|
47
|
+
"location": "AUS",
|
|
48
|
+
"description": "",
|
|
49
|
+
"time_zone": ""
|
|
50
|
+
},
|
|
51
|
+
"department": {
|
|
52
|
+
"id": "0",
|
|
53
|
+
"name": "DEP",
|
|
54
|
+
"description": "",
|
|
55
|
+
"default_assignee_id": "00009"
|
|
56
|
+
},
|
|
57
|
+
"category": {
|
|
58
|
+
"id": "categoryId",
|
|
59
|
+
"name": "CATEGORY",
|
|
60
|
+
"default_tags": "tagA, tagB",
|
|
61
|
+
"parent_id": "null",
|
|
62
|
+
"default_assignee_id": "1234"
|
|
63
|
+
},
|
|
64
|
+
"priority": "PRIORITY",
|
|
65
|
+
"assignee": {
|
|
66
|
+
"group_id": "00002",
|
|
67
|
+
"is_user": "true",
|
|
68
|
+
"id": "00003",
|
|
69
|
+
"name": "user name",
|
|
70
|
+
"email": "EMAIL",
|
|
71
|
+
"avatar": {
|
|
72
|
+
"type": "initials",
|
|
73
|
+
"color": "#fd4165",
|
|
74
|
+
"initials": "AA"
|
|
75
|
+
}
|
|
76
|
+
},
|
|
77
|
+
"requester": {
|
|
78
|
+
"group_id": "00002",
|
|
79
|
+
"is_user": "true",
|
|
80
|
+
"id": "00003",
|
|
81
|
+
"name": "user name",
|
|
82
|
+
"email": "EMAIL",
|
|
83
|
+
"avatar": {
|
|
84
|
+
"type": "initials",
|
|
85
|
+
"color": "#fd4165",
|
|
86
|
+
"initials": "AA"
|
|
87
|
+
}
|
|
88
|
+
},
|
|
89
|
+
"custom_fields_values": [
|
|
90
|
+
{
|
|
91
|
+
"id": "1223",
|
|
92
|
+
"custom_field_id": "0004",
|
|
93
|
+
"name": "field name",
|
|
94
|
+
"value": "content",
|
|
95
|
+
"options": "",
|
|
96
|
+
"type_name": "Text"
|
|
97
|
+
}
|
|
98
|
+
],
|
|
99
|
+
"due_at": "2022-12-11T00:00:00.000+01:00",
|
|
100
|
+
"origin": "api",
|
|
101
|
+
"incidents": [{ "id": "123", "href": "https://mydomain.com/incidents/123"}],
|
|
102
|
+
"problems": [{ "id": "123", "href": "https://mydomain.com/problems/123"}],
|
|
103
|
+
"changes": [{ "id": "123", "href": "https://mydomain.com/changes/123"}],
|
|
104
|
+
"solutions": [{ "id": "123", "href": "https://mydomain.com/solutions/123"}],
|
|
105
|
+
"releases": [{ "id": "123", "href": "https://mydomain.com/releases/123"}],
|
|
106
|
+
"configuration_items": [{ "id": "123", "href": "https://mydomain.com/configuration_items/123"}]
|
|
107
|
+
}
|
|
108
|
+
},
|
|
109
|
+
"xml": {
|
|
110
|
+
"description": "shouldn't work due to bug in openApi - https://github.com/springdoc/springdoc-openapi/issues/719",
|
|
111
|
+
"xml": "<root><incident><site><name>NAME</name></site><department_id>0</department_id><description>DESCRIPTION</description><state>NAME</state><assignee><email>EMAIL</email></assignee></incident></root>"
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
}
|
|
@@ -2,21 +2,92 @@
|
|
|
2
2
|
"components": {
|
|
3
3
|
"schemas": {
|
|
4
4
|
"incident": {
|
|
5
|
-
"
|
|
6
|
-
|
|
7
|
-
"
|
|
8
|
-
"
|
|
9
|
-
|
|
10
|
-
"
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
5
|
+
"request": {
|
|
6
|
+
"type": "object",
|
|
7
|
+
"properties": {
|
|
8
|
+
"incident": {
|
|
9
|
+
"type": "object",
|
|
10
|
+
"properties": {
|
|
11
|
+
"name": { "$ref": "../components.json#/components/schemas/association_by_name" },
|
|
12
|
+
"site_id": { "$ref": "../components.json#/components/schemas/association_by_id" },
|
|
13
|
+
"department_id": { "$ref": "../components.json#/components/schemas/association_by_id" },
|
|
14
|
+
"description": { "type": "string" },
|
|
15
|
+
"state_id": { "$ref": "../components.json#/components/schemas/association_by_id" },
|
|
16
|
+
"assignee": { "$ref": "../components.json#/components/schemas/association_by_email" },
|
|
17
|
+
"assignee_id": { "$ref": "../components.json#/components/schemas/association_by_id" },
|
|
18
|
+
"priority": { "$ref": "../components.json#/components/schemas/association_by_id" },
|
|
19
|
+
"requester": { "$ref": "../components.json#/components/schemas/association_by_email" },
|
|
20
|
+
"category": { "$ref": "../components.json#/components/schemas/association_by_name" },
|
|
21
|
+
"subcategory": { "$ref": "../components.json#/components/schemas/association_by_name" },
|
|
22
|
+
"due_at": { "type": "string" },
|
|
23
|
+
"add_to_tag_list": { "type": "string" },
|
|
24
|
+
"custom_field_values": { "$ref": "../components.json#/components/schemas/custom_field_values" },
|
|
25
|
+
"incidents": { "$ref": "../components.json#/components/schemas/incidents_attachments" },
|
|
26
|
+
"solutions": { "$ref": "../components.json#/components/schemas/solutions_attachments" },
|
|
27
|
+
"changes": { "$ref": "../components.json#/components/schemas/numbers_array" },
|
|
28
|
+
"problems": { "$ref": "../components.json#/components/schemas/numbers_array" },
|
|
29
|
+
"releases": { "$ref": "../components.json#/components/schemas/numbers_array" },
|
|
30
|
+
"configuration_item_ids": { "$ref": "../components.json#/components/schemas/ids_array" }
|
|
31
|
+
}
|
|
18
32
|
}
|
|
19
33
|
}
|
|
34
|
+
},
|
|
35
|
+
"response": {
|
|
36
|
+
"type": "object",
|
|
37
|
+
"properties": {
|
|
38
|
+
"incident": {
|
|
39
|
+
"type": "object",
|
|
40
|
+
"properties": {
|
|
41
|
+
"id": { "$ref": "../components.json#/components/schemas/id" },
|
|
42
|
+
"name": { "$ref": "../components.json#/components/schemas/association_by_name" },
|
|
43
|
+
"description": { "type": "string" },
|
|
44
|
+
"site": { "$ref": "../components.json#/components/schemas/site_response" },
|
|
45
|
+
"department": { "$ref": "../components.json#/components/schemas/department_response" },
|
|
46
|
+
"state": { "type": "string" },
|
|
47
|
+
"priority": { "type": "string" },
|
|
48
|
+
"assignee": { "$ref": "../components.json#/components/schemas/requester_assignee_details" },
|
|
49
|
+
"requester": { "$ref": "../components.json#/components/schemas/requester_assignee_details" },
|
|
50
|
+
"category": { "$ref": "../components.json#/components/schemas/category_subcategory" },
|
|
51
|
+
"subcategory": { "$ref": "../components.json#/components/schemas/category_subcategory" },
|
|
52
|
+
"due_at": { "type": "string" },
|
|
53
|
+
"custom_field_values": { "$ref": "../components.json#/components/schemas/custom_field_values" },
|
|
54
|
+
"created_by": { "$ref": "../components.json#/components/schemas/requester_assignee_details" },
|
|
55
|
+
"origin": { "type": "string" },
|
|
56
|
+
"incidents": { "$ref": "../components.json#/components/schemas/response_attachments" },
|
|
57
|
+
"solutions": { "$ref": "../components.json#/components/schemas/response_attachments" },
|
|
58
|
+
"changes": { "$ref": "../components.json#/components/schemas/response_attachments" },
|
|
59
|
+
"problems": { "$ref": "../components.json#/components/schemas/response_attachments" },
|
|
60
|
+
"releases": { "$ref": "../components.json#/components/schemas/response_attachments" },
|
|
61
|
+
"configuration_item_ids": { "$ref": "../components.json#/components/schemas/response_attachments" }
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
},
|
|
67
|
+
"incidents": {
|
|
68
|
+
"description": "List of incidents",
|
|
69
|
+
"type": "array",
|
|
70
|
+
"items": {
|
|
71
|
+
"allOf": [{ "$ref": "../../common/schemas/incident.json#/components/schemas/incident/response" }]
|
|
72
|
+
}
|
|
73
|
+
},
|
|
74
|
+
|
|
75
|
+
"incident_request_content": {
|
|
76
|
+
"application/json": {
|
|
77
|
+
"schema": { "$ref": "../../common/schemas/incident.json#/components/schemas/incident/request" },
|
|
78
|
+
"example": { "$ref": "../../common/examples/incident.json#/examples/request/json" }
|
|
79
|
+
}
|
|
80
|
+
},
|
|
81
|
+
"many_incidents_content": {
|
|
82
|
+
"application/json": {
|
|
83
|
+
"schema": { "$ref": "../../common/schemas/incident.json#/components/schemas/incidents" },
|
|
84
|
+
"example": [{ "$ref": "../../common/examples/incident.json#/examples/response/json" }]
|
|
85
|
+
}
|
|
86
|
+
},
|
|
87
|
+
"incident_response_content": {
|
|
88
|
+
"application/json": {
|
|
89
|
+
"schema": { "$ref": "../../common/schemas/incident.json#/components/schemas/incident/response" },
|
|
90
|
+
"example": { "$ref": "../../common/examples/incident.json#/examples/response/json" }
|
|
20
91
|
}
|
|
21
92
|
}
|
|
22
93
|
}
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"info": {
|
|
4
4
|
"title": "SolarWinds ITSM API",
|
|
5
5
|
"description": "All SolarWinds ITSM API definitions",
|
|
6
|
-
"version": "0.0.
|
|
6
|
+
"version": "0.0.5",
|
|
7
7
|
"contact": {
|
|
8
8
|
"name": "API Support",
|
|
9
9
|
"url": "samanage.com/support",
|
|
@@ -15,6 +15,13 @@
|
|
|
15
15
|
{ "url": "https://apieu.samanage.com" }
|
|
16
16
|
],
|
|
17
17
|
"paths": {
|
|
18
|
-
"/incidents/{id}": { "$ref": "paths/incidents/incident_by_id.json" }
|
|
19
|
-
|
|
18
|
+
"/incidents/{id}": { "$ref": "paths/incidents/incident_by_id.json" },
|
|
19
|
+
"/incidents": { "$ref": "paths/incidents/incidents.json" }
|
|
20
|
+
},
|
|
21
|
+
"tags": [
|
|
22
|
+
{
|
|
23
|
+
"name": "Incident",
|
|
24
|
+
"description": "Incident operations"
|
|
25
|
+
}
|
|
26
|
+
]
|
|
20
27
|
}
|
|
@@ -2,18 +2,25 @@
|
|
|
2
2
|
"get": {
|
|
3
3
|
"operationId": "getIncidentById",
|
|
4
4
|
"description": "Get incident",
|
|
5
|
+
"tags": ["Incident"],
|
|
5
6
|
"parameters": [
|
|
6
7
|
{ "$ref": "../../common/components.json#/components/parameters/token_param" },
|
|
7
8
|
{ "$ref": "../../common/components.json#/components/parameters/id_param" }
|
|
8
9
|
],
|
|
9
10
|
"responses": {
|
|
10
|
-
"200": {
|
|
11
|
-
|
|
11
|
+
"200": {
|
|
12
|
+
"description": "Object was returned correctly",
|
|
13
|
+
"content": { "$ref": "../../common/schemas/incident.json#/components/schemas/incident_response_content" }
|
|
14
|
+
},
|
|
15
|
+
"400": { "description": "Bad request" },
|
|
16
|
+
"404": { "description": "Not found" },
|
|
17
|
+
"500": { "description": "Internal Server Error" }
|
|
12
18
|
}
|
|
13
19
|
},
|
|
14
20
|
"put": {
|
|
15
21
|
"operationId": "updateIncidentById",
|
|
16
22
|
"description": "Update incident with specified fields",
|
|
23
|
+
"tags": ["Incident"],
|
|
17
24
|
"parameters": [
|
|
18
25
|
{ "$ref": "../../common/components.json#/components/parameters/token_param" },
|
|
19
26
|
{ "$ref": "../../common/components.json#/components/parameters/id_param" }
|
|
@@ -21,24 +28,38 @@
|
|
|
21
28
|
"requestBody": {
|
|
22
29
|
"required": true,
|
|
23
30
|
"description": "Incident fields to update",
|
|
24
|
-
"content": {
|
|
25
|
-
"application/json": {
|
|
26
|
-
"schema": { "$ref": "../../common/schemas/incident.json#/components/schemas/incident" },
|
|
27
|
-
"example": {
|
|
28
|
-
"value": "{\"incident\":{\"site\":{\"name\":\"SITE NAME\"},\"department_id\":DEPARTMENT-ID,\"description\":\"SOME DESCRIPTION\",\"state\":\"STATE NAME\",\"assignee\":{\"email\":\"EMAIL\"}}}"
|
|
29
|
-
}
|
|
30
|
-
},
|
|
31
|
-
"application/xml": {
|
|
32
|
-
"schema": { "$ref": "../../common/schemas/incident.json#/components/schemas/incident" },
|
|
33
|
-
"example": {
|
|
34
|
-
"value": "<incident><site><name>SITE NAME</name></site><department_id>DEPARTMENT-ID</department_id><description>SOME DESCRIPTION</description><state>STATE NAME</state><assignee><email>EMAIL</email></assignee></incident>"
|
|
35
|
-
}
|
|
36
|
-
}
|
|
37
|
-
}
|
|
31
|
+
"content": { "$ref": "../../common/schemas/incident.json#/components/schemas/incident_request_content" }
|
|
38
32
|
},
|
|
39
33
|
"responses": {
|
|
40
|
-
"200": {
|
|
41
|
-
|
|
34
|
+
"200": {
|
|
35
|
+
"description": "Object was updated correctly",
|
|
36
|
+
"content": { "$ref": "../../common/schemas/incident.json#/components/schemas/incident_response_content" }
|
|
37
|
+
},
|
|
38
|
+
"400": { "description": "Bad request" },
|
|
39
|
+
"404": { "description": "Not found" },
|
|
40
|
+
"500": { "description": "Internal Server Error" }
|
|
41
|
+
}
|
|
42
|
+
},
|
|
43
|
+
"delete": {
|
|
44
|
+
"operationId": "deleteIncidentById",
|
|
45
|
+
"description": "Delete incident",
|
|
46
|
+
"tags": ["Incident"],
|
|
47
|
+
"parameters": [
|
|
48
|
+
{ "$ref": "../../common/components.json#/components/parameters/token_param" },
|
|
49
|
+
{ "$ref": "../../common/components.json#/components/parameters/id_param" }
|
|
50
|
+
],
|
|
51
|
+
"responses": {
|
|
52
|
+
"200": {
|
|
53
|
+
"description": "Object was returned correctly",
|
|
54
|
+
"content": {
|
|
55
|
+
"application/json": {
|
|
56
|
+
"example": { "deleted_ids": ["00005"] }
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
},
|
|
60
|
+
"400": { "description": "Bad request" },
|
|
61
|
+
"404": { "description": "Not found" },
|
|
62
|
+
"500": { "description": "Internal Server Error" }
|
|
42
63
|
}
|
|
43
64
|
}
|
|
44
65
|
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
{
|
|
2
|
+
"get": {
|
|
3
|
+
"operationId": "getIncidents",
|
|
4
|
+
"description": "List of incidents",
|
|
5
|
+
"tags": ["Incident"],
|
|
6
|
+
"parameters": [
|
|
7
|
+
{ "$ref": "../../common/components.json#/components/parameters/token_param" }
|
|
8
|
+
],
|
|
9
|
+
"responses": {
|
|
10
|
+
"200": {
|
|
11
|
+
"description": "Object was returned correctly",
|
|
12
|
+
"content": { "$ref": "../../common/schemas/incident.json#/components/schemas/many_incidents_content" }
|
|
13
|
+
},
|
|
14
|
+
"400": { "description": "Bad request" },
|
|
15
|
+
"404": { "description": "Not found" },
|
|
16
|
+
"500": { "description": "Server error" }
|
|
17
|
+
}
|
|
18
|
+
},
|
|
19
|
+
"post": {
|
|
20
|
+
"operationId": "createIncident",
|
|
21
|
+
"description": "Create new incident",
|
|
22
|
+
"tags": ["Incident"],
|
|
23
|
+
"parameters": [
|
|
24
|
+
{ "$ref": "../../common/components.json#/components/parameters/token_param" }
|
|
25
|
+
],
|
|
26
|
+
"requestBody": {
|
|
27
|
+
"required": true,
|
|
28
|
+
"description": "Incident fields to fill",
|
|
29
|
+
"content": { "$ref": "../../common/schemas/incident.json#/components/schemas/incident_request_content" }
|
|
30
|
+
},
|
|
31
|
+
"responses": {
|
|
32
|
+
"200": {
|
|
33
|
+
"description": "Object created and returned correctly",
|
|
34
|
+
"content": { "$ref": "../../common/schemas/incident.json#/components/schemas/incident_response_content" }
|
|
35
|
+
},
|
|
36
|
+
"400": { "description": "Bad request" },
|
|
37
|
+
"500": { "description": "Server error" }
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"openapi":"3.0.1","info":{"title":"SolarWinds ITSM API","description":"All SolarWinds ITSM API definitions","version":"0.0.4","contact":{"name":"API Support","url":"samanage.com/support","email":"support@samanage.com"}},"servers":[{"url":"https://api.samanage.com"},{"url":"https://apieu.samanage.com"}],"paths":{"/incidents/{id}":{"get":{"operationId":"getIncidentById","description":"Get incident","parameters":[{"name":"X-Samanage-Authorization","in":"header","schema":{"type":"string"},"example":"Bearer TOKEN"},{"name":"id","in":"path","schema":{"oneOf":[{"type":"string"},{"type":"integer"}]},"required":true,"description":"Numeric ID of the object to get or update"}],"responses":{"200":{"description":"Object was returned correctly"},"404":{"description":"Not found"}}},"put":{"operationId":"updateIncidentById","description":"Update incident with specified fields","parameters":[{"name":"X-Samanage-Authorization","in":"header","schema":{"type":"string"},"example":"Bearer TOKEN"},{"name":"id","in":"path","schema":{"oneOf":[{"type":"string"},{"type":"integer"}]},"required":true,"description":"Numeric ID of the object to get or update"}],"requestBody":{"required":true,"description":"Incident fields to update","content":{"application/json":{"schema":{"type":"object","properties":{"incident":{"type":"object","properties":{"site":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"site_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"department":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"department_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"description":{"type":"string"},"state":{"oneOf":[{"type":"string"},{"type":"integer"}]},"assignee":{"type":"object","oneOf":[{"type":"object","required":["email"],"properties":{"email":{"type":"string"}}},{"enum":["nil","",null]}]},"assignee_id":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}}},"example":{"value":"{\"incident\":{\"site\":{\"name\":\"SITE NAME\"},\"department_id\":DEPARTMENT-ID,\"description\":\"SOME DESCRIPTION\",\"state\":\"STATE NAME\",\"assignee\":{\"email\":\"EMAIL\"}}}"}},"application/xml":{"schema":{"type":"object","properties":{"incident":{"type":"object","properties":{"site":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"site_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"department":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"department_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"description":{"type":"string"},"state":{"oneOf":[{"type":"string"},{"type":"integer"}]},"assignee":{"type":"object","oneOf":[{"type":"object","required":["email"],"properties":{"email":{"type":"string"}}},{"enum":["nil","",null]}]},"assignee_id":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}}},"example":{"value":"<incident><site><name>SITE NAME</name></site><department_id>DEPARTMENT-ID</department_id><description>SOME DESCRIPTION</description><state>STATE NAME</state><assignee><email>EMAIL</email></assignee></incident>"}}}},"responses":{"200":{"description":"Object was updated correctly"},"404":{"description":"Not found"}}}}}}
|
|
1
|
+
{"openapi":"3.0.1","info":{"title":"SolarWinds ITSM API","description":"All SolarWinds ITSM API definitions","version":"0.0.5","contact":{"name":"API Support","url":"samanage.com/support","email":"support@samanage.com"}},"servers":[{"url":"https://api.samanage.com"},{"url":"https://apieu.samanage.com"}],"paths":{"/incidents/{id}":{"get":{"operationId":"getIncidentById","description":"Get incident","tags":["Incident"],"parameters":[{"name":"X-Samanage-Authorization","in":"header","schema":{"type":"string"},"example":"Bearer TOKEN"},{"name":"id","in":"path","schema":{"oneOf":[{"type":"string"},{"type":"integer"}]},"required":true,"description":"Numeric ID of the object to get or update"}],"responses":{"200":{"description":"Object was returned correctly","content":{"application/json":{"schema":{"type":"object","properties":{"incident":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"description":{"type":"string"},"site":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"description":{"type":"string"},"location":{"type":"string"},"timezone":{"type":"string"}}},"department":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"description":{"type":"string"},"default_assignee_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]}}},"state":{"type":"string"},"priority":{"type":"string"},"assignee":{"type":"object","properties":{"group_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"is_user":{"oneOf":[{"type":"string"},{"type":"boolean"}]},"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"email":{"type":"string"},"avatar":{"type":"object","properties":{"type":{"type":"string"},"color":{"type":"string"},"initials":{"type":"string","minLength":2,"maxLength":2}}}}},"requester":{"type":"object","properties":{"group_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"is_user":{"oneOf":[{"type":"string"},{"type":"boolean"}]},"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"email":{"type":"string"},"avatar":{"type":"object","properties":{"type":{"type":"string"},"color":{"type":"string"},"initials":{"type":"string","minLength":2,"maxLength":2}}}}},"category":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"default_tags":{"type":"string"},"parent_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"default_assignee_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]}}},"subcategory":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"default_tags":{"type":"string"},"parent_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"default_assignee_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]}}},"due_at":{"type":"string"},"custom_field_values":{"type":"object","oneOf":[{"type":"object","required":["custom_field_value"],"properties":{"custom_field_value":{"type":"array","items":{"allOf":[{"type":"object","oneOf":[{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}]}]}}}}]},"created_by":{"type":"object","properties":{"group_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"is_user":{"oneOf":[{"type":"string"},{"type":"boolean"}]},"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"email":{"type":"string"},"avatar":{"type":"object","properties":{"type":{"type":"string"},"color":{"type":"string"},"initials":{"type":"string","minLength":2,"maxLength":2}}}}},"origin":{"type":"string"},"incidents":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"solutions":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"changes":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"problems":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"releases":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"configuration_item_ids":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}}}}}},"example":{"incident":{"id":"0000","number":"0001","name":"IncidentName","description":"DESCRIPTION","state":"NAME","site":{"id":"0","name":"SITE","location":"AUS","description":"","time_zone":""},"department":{"id":"0","name":"DEP","description":"","default_assignee_id":"00009"},"category":{"id":"categoryId","name":"CATEGORY","default_tags":"tagA, tagB","parent_id":"null","default_assignee_id":"1234"},"priority":"PRIORITY","assignee":{"group_id":"00002","is_user":"true","id":"00003","name":"user name","email":"EMAIL","avatar":{"type":"initials","color":"#fd4165","initials":"AA"}},"requester":{"group_id":"00002","is_user":"true","id":"00003","name":"user name","email":"EMAIL","avatar":{"type":"initials","color":"#fd4165","initials":"AA"}},"custom_fields_values":[{"id":"1223","custom_field_id":"0004","name":"field name","value":"content","options":"","type_name":"Text"}],"due_at":"2022-12-11T00:00:00.000+01:00","origin":"api","incidents":[{"id":"123","href":"https://mydomain.com/incidents/123"}],"problems":[{"id":"123","href":"https://mydomain.com/problems/123"}],"changes":[{"id":"123","href":"https://mydomain.com/changes/123"}],"solutions":[{"id":"123","href":"https://mydomain.com/solutions/123"}],"releases":[{"id":"123","href":"https://mydomain.com/releases/123"}],"configuration_items":[{"id":"123","href":"https://mydomain.com/configuration_items/123"}]}}}}},"400":{"description":"Bad request"},"404":{"description":"Not found"},"500":{"description":"Internal Server Error"}}},"put":{"operationId":"updateIncidentById","description":"Update incident with specified fields","tags":["Incident"],"parameters":[{"name":"X-Samanage-Authorization","in":"header","schema":{"type":"string"},"example":"Bearer TOKEN"},{"name":"id","in":"path","schema":{"oneOf":[{"type":"string"},{"type":"integer"}]},"required":true,"description":"Numeric ID of the object to get or update"}],"requestBody":{"required":true,"description":"Incident fields to update","content":{"application/json":{"schema":{"type":"object","properties":{"incident":{"type":"object","properties":{"name":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"site_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"department_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"description":{"type":"string"},"state_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"assignee":{"type":"object","oneOf":[{"type":"object","required":["email"],"properties":{"email":{"type":"string"}}},{"enum":["nil","",null]}]},"assignee_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"priority":{"oneOf":[{"type":"string"},{"type":"integer"}]},"requester":{"type":"object","oneOf":[{"type":"object","required":["email"],"properties":{"email":{"type":"string"}}},{"enum":["nil","",null]}]},"category":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"subcategory":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"due_at":{"type":"string"},"add_to_tag_list":{"type":"string"},"custom_field_values":{"type":"object","oneOf":[{"type":"object","required":["custom_field_value"],"properties":{"custom_field_value":{"type":"array","items":{"allOf":[{"type":"object","oneOf":[{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}]}]}}}}]},"incidents":{"type":"object","properties":{"incident":{"type":"array","items":{"type":"object","properties":{"number":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}}}},"solutions":{"type":"object","properties":{"solution":{"type":"array","items":{"type":"object","properties":{"number":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}}}},"changes":{"type":"array","items":{"type":"object","properties":{"number":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}},"problems":{"type":"array","items":{"type":"object","properties":{"number":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}},"releases":{"type":"array","items":{"type":"object","properties":{"number":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}},"configuration_item_ids":{"type":"array","items":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}}}},"example":{"incident":{"name":"IncidentName","site_id":0,"department_id":0,"description":"DESCRIPTION","state_id":0,"assignee":{"email":"EMAIL"},"requester":{"email":"EMAIL"},"priority":"PRIORITY","category":{"name":"CATEGORY"},"subcategory":{"name":"SUBCATEGORY"},"due_at":"Dec 11,2022","add_to_tag_list":"tag1, tag2, tag3","custom_fields_values":{"custom_fields_value":[{"name":"field name","value":"content"}]},"incidents":{"incident":[{"number":"123"}]},"problems":[{"number":"123"}],"changes":[{"number":"123"}],"solutions":{"solution":[{"number":"123"}]},"releases":[{"number":"123"}],"configuration_item_ids":["123"]}}}}},"responses":{"200":{"description":"Object was updated correctly","content":{"application/json":{"schema":{"type":"object","properties":{"incident":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"description":{"type":"string"},"site":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"description":{"type":"string"},"location":{"type":"string"},"timezone":{"type":"string"}}},"department":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"description":{"type":"string"},"default_assignee_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]}}},"state":{"type":"string"},"priority":{"type":"string"},"assignee":{"type":"object","properties":{"group_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"is_user":{"oneOf":[{"type":"string"},{"type":"boolean"}]},"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"email":{"type":"string"},"avatar":{"type":"object","properties":{"type":{"type":"string"},"color":{"type":"string"},"initials":{"type":"string","minLength":2,"maxLength":2}}}}},"requester":{"type":"object","properties":{"group_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"is_user":{"oneOf":[{"type":"string"},{"type":"boolean"}]},"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"email":{"type":"string"},"avatar":{"type":"object","properties":{"type":{"type":"string"},"color":{"type":"string"},"initials":{"type":"string","minLength":2,"maxLength":2}}}}},"category":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"default_tags":{"type":"string"},"parent_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"default_assignee_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]}}},"subcategory":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"default_tags":{"type":"string"},"parent_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"default_assignee_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]}}},"due_at":{"type":"string"},"custom_field_values":{"type":"object","oneOf":[{"type":"object","required":["custom_field_value"],"properties":{"custom_field_value":{"type":"array","items":{"allOf":[{"type":"object","oneOf":[{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}]}]}}}}]},"created_by":{"type":"object","properties":{"group_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"is_user":{"oneOf":[{"type":"string"},{"type":"boolean"}]},"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"email":{"type":"string"},"avatar":{"type":"object","properties":{"type":{"type":"string"},"color":{"type":"string"},"initials":{"type":"string","minLength":2,"maxLength":2}}}}},"origin":{"type":"string"},"incidents":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"solutions":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"changes":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"problems":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"releases":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"configuration_item_ids":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}}}}}},"example":{"incident":{"id":"0000","number":"0001","name":"IncidentName","description":"DESCRIPTION","state":"NAME","site":{"id":"0","name":"SITE","location":"AUS","description":"","time_zone":""},"department":{"id":"0","name":"DEP","description":"","default_assignee_id":"00009"},"category":{"id":"categoryId","name":"CATEGORY","default_tags":"tagA, tagB","parent_id":"null","default_assignee_id":"1234"},"priority":"PRIORITY","assignee":{"group_id":"00002","is_user":"true","id":"00003","name":"user name","email":"EMAIL","avatar":{"type":"initials","color":"#fd4165","initials":"AA"}},"requester":{"group_id":"00002","is_user":"true","id":"00003","name":"user name","email":"EMAIL","avatar":{"type":"initials","color":"#fd4165","initials":"AA"}},"custom_fields_values":[{"id":"1223","custom_field_id":"0004","name":"field name","value":"content","options":"","type_name":"Text"}],"due_at":"2022-12-11T00:00:00.000+01:00","origin":"api","incidents":[{"id":"123","href":"https://mydomain.com/incidents/123"}],"problems":[{"id":"123","href":"https://mydomain.com/problems/123"}],"changes":[{"id":"123","href":"https://mydomain.com/changes/123"}],"solutions":[{"id":"123","href":"https://mydomain.com/solutions/123"}],"releases":[{"id":"123","href":"https://mydomain.com/releases/123"}],"configuration_items":[{"id":"123","href":"https://mydomain.com/configuration_items/123"}]}}}}},"400":{"description":"Bad request"},"404":{"description":"Not found"},"500":{"description":"Internal Server Error"}}},"delete":{"operationId":"deleteIncidentById","description":"Delete incident","tags":["Incident"],"parameters":[{"name":"X-Samanage-Authorization","in":"header","schema":{"type":"string"},"example":"Bearer TOKEN"},{"name":"id","in":"path","schema":{"oneOf":[{"type":"string"},{"type":"integer"}]},"required":true,"description":"Numeric ID of the object to get or update"}],"responses":{"200":{"description":"Object was returned correctly","content":{"application/json":{"example":{"deleted_ids":["00005"]}}}},"400":{"description":"Bad request"},"404":{"description":"Not found"},"500":{"description":"Internal Server Error"}}}},"/incidents":{"get":{"operationId":"getIncidents","description":"List of incidents","tags":["Incident"],"parameters":[{"name":"X-Samanage-Authorization","in":"header","schema":{"type":"string"},"example":"Bearer TOKEN"}],"responses":{"200":{"description":"Object was returned correctly","content":{"application/json":{"schema":{"description":"List of incidents","type":"array","items":{"allOf":[{"type":"object","properties":{"incident":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"description":{"type":"string"},"site":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"description":{"type":"string"},"location":{"type":"string"},"timezone":{"type":"string"}}},"department":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"description":{"type":"string"},"default_assignee_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]}}},"state":{"type":"string"},"priority":{"type":"string"},"assignee":{"type":"object","properties":{"group_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"is_user":{"oneOf":[{"type":"string"},{"type":"boolean"}]},"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"email":{"type":"string"},"avatar":{"type":"object","properties":{"type":{"type":"string"},"color":{"type":"string"},"initials":{"type":"string","minLength":2,"maxLength":2}}}}},"requester":{"type":"object","properties":{"group_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"is_user":{"oneOf":[{"type":"string"},{"type":"boolean"}]},"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"email":{"type":"string"},"avatar":{"type":"object","properties":{"type":{"type":"string"},"color":{"type":"string"},"initials":{"type":"string","minLength":2,"maxLength":2}}}}},"category":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"default_tags":{"type":"string"},"parent_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"default_assignee_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]}}},"subcategory":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"default_tags":{"type":"string"},"parent_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"default_assignee_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]}}},"due_at":{"type":"string"},"custom_field_values":{"type":"object","oneOf":[{"type":"object","required":["custom_field_value"],"properties":{"custom_field_value":{"type":"array","items":{"allOf":[{"type":"object","oneOf":[{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}]}]}}}}]},"created_by":{"type":"object","properties":{"group_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"is_user":{"oneOf":[{"type":"string"},{"type":"boolean"}]},"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"email":{"type":"string"},"avatar":{"type":"object","properties":{"type":{"type":"string"},"color":{"type":"string"},"initials":{"type":"string","minLength":2,"maxLength":2}}}}},"origin":{"type":"string"},"incidents":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"solutions":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"changes":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"problems":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"releases":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"configuration_item_ids":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}}}}}}]}},"example":[{"incident":{"id":"0000","number":"0001","name":"IncidentName","description":"DESCRIPTION","state":"NAME","site":{"id":"0","name":"SITE","location":"AUS","description":"","time_zone":""},"department":{"id":"0","name":"DEP","description":"","default_assignee_id":"00009"},"category":{"id":"categoryId","name":"CATEGORY","default_tags":"tagA, tagB","parent_id":"null","default_assignee_id":"1234"},"priority":"PRIORITY","assignee":{"group_id":"00002","is_user":"true","id":"00003","name":"user name","email":"EMAIL","avatar":{"type":"initials","color":"#fd4165","initials":"AA"}},"requester":{"group_id":"00002","is_user":"true","id":"00003","name":"user name","email":"EMAIL","avatar":{"type":"initials","color":"#fd4165","initials":"AA"}},"custom_fields_values":[{"id":"1223","custom_field_id":"0004","name":"field name","value":"content","options":"","type_name":"Text"}],"due_at":"2022-12-11T00:00:00.000+01:00","origin":"api","incidents":[{"id":"123","href":"https://mydomain.com/incidents/123"}],"problems":[{"id":"123","href":"https://mydomain.com/problems/123"}],"changes":[{"id":"123","href":"https://mydomain.com/changes/123"}],"solutions":[{"id":"123","href":"https://mydomain.com/solutions/123"}],"releases":[{"id":"123","href":"https://mydomain.com/releases/123"}],"configuration_items":[{"id":"123","href":"https://mydomain.com/configuration_items/123"}]}}]}}},"400":{"description":"Bad request"},"404":{"description":"Not found"},"500":{"description":"Server error"}}},"post":{"operationId":"createIncident","description":"Create new incident","tags":["Incident"],"parameters":[{"name":"X-Samanage-Authorization","in":"header","schema":{"type":"string"},"example":"Bearer TOKEN"}],"requestBody":{"required":true,"description":"Incident fields to fill","content":{"application/json":{"schema":{"type":"object","properties":{"incident":{"type":"object","properties":{"name":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"site_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"department_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"description":{"type":"string"},"state_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"assignee":{"type":"object","oneOf":[{"type":"object","required":["email"],"properties":{"email":{"type":"string"}}},{"enum":["nil","",null]}]},"assignee_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"priority":{"oneOf":[{"type":"string"},{"type":"integer"}]},"requester":{"type":"object","oneOf":[{"type":"object","required":["email"],"properties":{"email":{"type":"string"}}},{"enum":["nil","",null]}]},"category":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"subcategory":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"due_at":{"type":"string"},"add_to_tag_list":{"type":"string"},"custom_field_values":{"type":"object","oneOf":[{"type":"object","required":["custom_field_value"],"properties":{"custom_field_value":{"type":"array","items":{"allOf":[{"type":"object","oneOf":[{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}]}]}}}}]},"incidents":{"type":"object","properties":{"incident":{"type":"array","items":{"type":"object","properties":{"number":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}}}},"solutions":{"type":"object","properties":{"solution":{"type":"array","items":{"type":"object","properties":{"number":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}}}},"changes":{"type":"array","items":{"type":"object","properties":{"number":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}},"problems":{"type":"array","items":{"type":"object","properties":{"number":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}},"releases":{"type":"array","items":{"type":"object","properties":{"number":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}},"configuration_item_ids":{"type":"array","items":{"oneOf":[{"type":"string"},{"type":"integer"}]}}}}}},"example":{"incident":{"name":"IncidentName","site_id":0,"department_id":0,"description":"DESCRIPTION","state_id":0,"assignee":{"email":"EMAIL"},"requester":{"email":"EMAIL"},"priority":"PRIORITY","category":{"name":"CATEGORY"},"subcategory":{"name":"SUBCATEGORY"},"due_at":"Dec 11,2022","add_to_tag_list":"tag1, tag2, tag3","custom_fields_values":{"custom_fields_value":[{"name":"field name","value":"content"}]},"incidents":{"incident":[{"number":"123"}]},"problems":[{"number":"123"}],"changes":[{"number":"123"}],"solutions":{"solution":[{"number":"123"}]},"releases":[{"number":"123"}],"configuration_item_ids":["123"]}}}}},"responses":{"200":{"description":"Object created and returned correctly","content":{"application/json":{"schema":{"type":"object","properties":{"incident":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"object","oneOf":[{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},{"enum":["nil","",null]}]},"description":{"type":"string"},"site":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"description":{"type":"string"},"location":{"type":"string"},"timezone":{"type":"string"}}},"department":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"description":{"type":"string"},"default_assignee_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]}}},"state":{"type":"string"},"priority":{"type":"string"},"assignee":{"type":"object","properties":{"group_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"is_user":{"oneOf":[{"type":"string"},{"type":"boolean"}]},"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"email":{"type":"string"},"avatar":{"type":"object","properties":{"type":{"type":"string"},"color":{"type":"string"},"initials":{"type":"string","minLength":2,"maxLength":2}}}}},"requester":{"type":"object","properties":{"group_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"is_user":{"oneOf":[{"type":"string"},{"type":"boolean"}]},"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"email":{"type":"string"},"avatar":{"type":"object","properties":{"type":{"type":"string"},"color":{"type":"string"},"initials":{"type":"string","minLength":2,"maxLength":2}}}}},"category":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"default_tags":{"type":"string"},"parent_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"default_assignee_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]}}},"subcategory":{"type":"object","properties":{"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"default_tags":{"type":"string"},"parent_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"default_assignee_id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]}}},"due_at":{"type":"string"},"custom_field_values":{"type":"object","oneOf":[{"type":"object","required":["custom_field_value"],"properties":{"custom_field_value":{"type":"array","items":{"allOf":[{"type":"object","oneOf":[{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}]}]}}}}]},"created_by":{"type":"object","properties":{"group_id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"is_user":{"oneOf":[{"type":"string"},{"type":"boolean"}]},"id":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"integer"}]},"name":{"type":"string"},"email":{"type":"string"},"avatar":{"type":"object","properties":{"type":{"type":"string"},"color":{"type":"string"},"initials":{"type":"string","minLength":2,"maxLength":2}}}}},"origin":{"type":"string"},"incidents":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"solutions":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"changes":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"problems":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"releases":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}},"configuration_item_ids":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"href":{"type":"string"}}}}}}}},"example":{"incident":{"id":"0000","number":"0001","name":"IncidentName","description":"DESCRIPTION","state":"NAME","site":{"id":"0","name":"SITE","location":"AUS","description":"","time_zone":""},"department":{"id":"0","name":"DEP","description":"","default_assignee_id":"00009"},"category":{"id":"categoryId","name":"CATEGORY","default_tags":"tagA, tagB","parent_id":"null","default_assignee_id":"1234"},"priority":"PRIORITY","assignee":{"group_id":"00002","is_user":"true","id":"00003","name":"user name","email":"EMAIL","avatar":{"type":"initials","color":"#fd4165","initials":"AA"}},"requester":{"group_id":"00002","is_user":"true","id":"00003","name":"user name","email":"EMAIL","avatar":{"type":"initials","color":"#fd4165","initials":"AA"}},"custom_fields_values":[{"id":"1223","custom_field_id":"0004","name":"field name","value":"content","options":"","type_name":"Text"}],"due_at":"2022-12-11T00:00:00.000+01:00","origin":"api","incidents":[{"id":"123","href":"https://mydomain.com/incidents/123"}],"problems":[{"id":"123","href":"https://mydomain.com/problems/123"}],"changes":[{"id":"123","href":"https://mydomain.com/changes/123"}],"solutions":[{"id":"123","href":"https://mydomain.com/solutions/123"}],"releases":[{"id":"123","href":"https://mydomain.com/releases/123"}],"configuration_items":[{"id":"123","href":"https://mydomain.com/configuration_items/123"}]}}}}},"400":{"description":"Bad request"},"500":{"description":"Server error"}}}}},"tags":[{"name":"Incident","description":"Incident operations"}]}
|
metadata
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: solarwinds-itsm-api-definitions
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.0.
|
|
4
|
+
version: 0.0.5
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Jonathan Goldstein
|
|
8
8
|
- Darth Vader
|
|
9
|
-
autorequire:
|
|
9
|
+
autorequire:
|
|
10
10
|
bindir: bin
|
|
11
11
|
cert_chain: []
|
|
12
12
|
date: 2020-05-26 00:00:00.000000000 Z
|
|
@@ -18,16 +18,18 @@ extensions: []
|
|
|
18
18
|
extra_rdoc_files: []
|
|
19
19
|
files:
|
|
20
20
|
- lib/definitions/common/components.json
|
|
21
|
+
- lib/definitions/common/examples/incident.json
|
|
21
22
|
- lib/definitions/common/schemas/incident.json
|
|
22
23
|
- lib/definitions/openapi.json
|
|
23
24
|
- lib/definitions/paths/incidents/incident_by_id.json
|
|
25
|
+
- lib/definitions/paths/incidents/incidents.json
|
|
24
26
|
- lib/resolved_schema/resolved_schema.json
|
|
25
27
|
- lib/solarwinds/itsm/api/definitions.rb
|
|
26
28
|
homepage: https://rubygems.org/gems/solarwinds-itsm-api-definitions
|
|
27
29
|
licenses:
|
|
28
30
|
- MIT
|
|
29
31
|
metadata: {}
|
|
30
|
-
post_install_message:
|
|
32
|
+
post_install_message:
|
|
31
33
|
rdoc_options: []
|
|
32
34
|
require_paths:
|
|
33
35
|
- lib
|
|
@@ -42,8 +44,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
|
42
44
|
- !ruby/object:Gem::Version
|
|
43
45
|
version: '0'
|
|
44
46
|
requirements: []
|
|
45
|
-
rubygems_version: 3.0.
|
|
46
|
-
signing_key:
|
|
47
|
+
rubygems_version: 3.0.8
|
|
48
|
+
signing_key:
|
|
47
49
|
specification_version: 4
|
|
48
50
|
summary: OpenAPI definitions
|
|
49
51
|
test_files: []
|