Incidents Create — DevRev

Creates an incident.

Request

This endpoint expects an object.

titlestringRequired

Title of the incident.

applies_to_partslist of stringsOptional

Parts to which the incident is applicable to.

artifactslist of stringsOptional

Artifacts attached to the incident.

bodystringOptional

Body of the incident.

custom_fieldsmap from strings to anyOptional

Application-defined custom fields.

custom_schema_specobjectOptional

Requested custom schemas described abstractly. Every provided schema's custom field must be specified, otherwise a bad request error is returned. If a new custom schema specifier is provided, then it will be added to the work, otherwise if a custom schema is omitted from the specifier, it remains unmodified.

identified_datedatetimeOptional

Time when the incident was identified/reported.

impacted_customerslist of stringsOptional

List of customers impacted due to the incident.

mitigated_datedatetimeOptional

Timestamp when the incident was mitigated.

owned_bylist of stringsOptional

User IDs of the users that own the incident.

severitylongOptional

Severity of the incident.

stageobjectOptional

Create object for stage.

stakeholderslist of stringsOptional

Users, along with the incident commander, involved in resolving incidents and handling communication.

tagslist of objectsOptional

Tags associated with the object.

target_close_datedatetimeOptional

Timestamp when the incident is expected to be resolved.

Response

This endpoint returns an object

incidentobject

1 curl -X POST https://api.devrev.ai/incidents.create \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "title": "title" 6 }'

1 { 2 "incident": { 3 "created_date": "2023-01-01T12:00:00Z", 4 "display_id": "display_id", 5 "id": "id", 6 "modified_date": "2023-01-01T12:00:00Z", 7 "artifacts": [ 8 { 9 "id": "id" 10 } 11 ], 12 "body": "body", 13 "custom_fields": { 14 "key": "value" 15 }, 16 "custom_schema_fragments": [ 17 "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>" 18 ], 19 "identified_date": "2023-01-01T12:00:00Z", 20 "impacted_customers": [ 21 { 22 "id": "id" 23 } 24 ], 25 "mitigated_date": "2023-01-01T12:00:00Z", 26 "severity": { 27 "id": 1000000, 28 "label": "label", 29 "ordinal": 1000000 30 }, 31 "stage": { 32 "stage": { 33 "id": "id" 34 }, 35 "state": { 36 "id": "id" 37 } 38 }, 39 "stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>", 40 "subtype": "subtype", 41 "tags": [ 42 { 43 "tag": { 44 "id": "id", 45 "name": "name" 46 } 47 } 48 ], 49 "target_close_date": "2023-01-01T12:00:00Z", 50 "title": "title" 51 } 52 }

1	curl -X POST https://api.devrev.ai/incidents.create \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"title": "title"
6	}'

1	{
2	"incident": {
3	"created_date": "2023-01-01T12:00:00Z",
4	"display_id": "display_id",
5	"id": "id",
6	"modified_date": "2023-01-01T12:00:00Z",
7	"artifacts": [
8	{
9	"id": "id"
10	}
11	],
12	"body": "body",
13	"custom_fields": {
14	"key": "value"
15	},
16	"custom_schema_fragments": [
17	"don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>"
18	],
19	"identified_date": "2023-01-01T12:00:00Z",
20	"impacted_customers": [
21	{
22	"id": "id"
23	}
24	],
25	"mitigated_date": "2023-01-01T12:00:00Z",
26	"severity": {
27	"id": 1000000,
28	"label": "label",
29	"ordinal": 1000000
30	},
31	"stage": {
32	"stage": {
33	"id": "id"
34	},
35	"state": {
36	"id": "id"
37	}
38	},
39	"stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>",
40	"subtype": "subtype",
41	"tags": [
42	{
43	"tag": {
44	"id": "id",
45	"name": "name"
46	}
47	}
48	],
49	"target_close_date": "2023-01-01T12:00:00Z",
50	"title": "title"
51	}
52	}