Incidents List (Beta) — DevRev

Lists incidents.

Query parameters

applies_to_partsstringOptional

Filters for incidents that apply to any of the provided parts.

created_bystringOptional

Filters for incidents created by any of the provided users.

cursorstringOptional

The cursor to resume iteration from. If not provided, then iteration starts from the beginning.

limitintegerOptional

The maximum number of items.

mode"after" or "before"Optional

The iteration mode to use, otherwise if not set, then “after” is used.

Allowed values: afterbefore

owned_bystringOptional

Filters for incidents owned by any of the provided users.

piastringOptional

Filters for incidents with any of the provided PIAs.

playbookstringOptional

Filters for incidents with any of the provided playbooks.

related_docsstringOptional

Filters for incidents with any of the provided related docs.

reported_bylongOptional

Filters for incidents with any of the provided reporters.

severitylongOptional

Filters for incidents containing any of the provided severities.

sort_bystringOptional

The list of fields to sort the items by and how to sort them.

sourcelongOptional

Filters for incidents with any of the provided sources.

stagestringOptional

Filters for incidents in any of the provided stages.

subtypestringOptional

Filters for incidents with any of the provided subtypes.

titlestringOptional

Filters for incidents by the provided titles.

Response

This endpoint returns an object.

incidentslist of objects

The matching incidents.

next_cursorstringOptional

The cursor used to iterate subsequent results in accordance to the sort order. If not set, then no later elements exist.

prev_cursorstringOptional

The cursor used to iterate preceding results in accordance to the sort order. If not set, then no prior elements exist.

1 curl https://api.devrev.ai/incidents.list \ 2 -H "Authorization: Bearer <token>"

1 { 2 "incidents": [ 3 { 4 "id": "id", 5 "title": "title", 6 "acknowledged_date": "2023-01-01T12:00:00Z", 7 "actual_close_date": "2023-01-01T12:00:00Z", 8 "applies_to_parts": [ 9 { 10 "type": "product", 11 "id": "applies_to_parts", 12 "name": "applies_to_parts", 13 "owned_by": [ 14 { 15 "type": "sys_user", 16 "id": "applies_to_parts" 17 } 18 ] 19 } 20 ], 21 "artifacts": [ 22 { 23 "id": "id" 24 } 25 ], 26 "body": "body", 27 "created_by": { 28 "type": "sys_user", 29 "id": "created_by" 30 }, 31 "created_date": "2023-01-01T12:00:00Z", 32 "custom_fields": { 33 "key": "value" 34 }, 35 "custom_schema_fragments": [ 36 "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>" 37 ], 38 "display_id": "display_id", 39 "identified_date": "2023-01-01T12:00:00Z", 40 "impacted_customers": [ 41 { 42 "id": "id" 43 } 44 ], 45 "mitigated_date": "2023-01-01T12:00:00Z", 46 "modified_by": { 47 "type": "sys_user", 48 "id": "modified_by" 49 }, 50 "modified_date": "2023-01-01T12:00:00Z", 51 "owned_by": [ 52 { 53 "type": "sys_user", 54 "id": "owned_by" 55 } 56 ], 57 "pia": [ 58 { 59 "id": "id" 60 } 61 ], 62 "playbooks": [ 63 { 64 "id": "id" 65 } 66 ], 67 "reported_by": { 68 "id": 1000000, 69 "label": "label", 70 "ordinal": 1000000 71 }, 72 "severity": { 73 "id": 1000000, 74 "label": "label", 75 "ordinal": 1000000 76 }, 77 "source": { 78 "id": 1000000, 79 "label": "label", 80 "ordinal": 1000000 81 }, 82 "stakeholders": [ 83 { 84 "type": "sys_user", 85 "id": "stakeholders" 86 } 87 ], 88 "stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>", 89 "subtype": "subtype", 90 "tags": [ 91 { 92 "tag": { 93 "id": "id", 94 "name": "name" 95 } 96 } 97 ], 98 "target_close_date": "2023-01-01T12:00:00Z" 99 } 100 ], 101 "next_cursor": "next_cursor", 102 "prev_cursor": "prev_cursor" 103 }

1	curl https://api.devrev.ai/incidents.list \
2	-H "Authorization: Bearer <token>"

1	{
2	"incidents": [
3	{
4	"id": "id",
5	"title": "title",
6	"acknowledged_date": "2023-01-01T12:00:00Z",
7	"actual_close_date": "2023-01-01T12:00:00Z",
8	"applies_to_parts": [
9	{
10	"type": "product",
11	"id": "applies_to_parts",
12	"name": "applies_to_parts",
13	"owned_by": [
14	{
15	"type": "sys_user",
16	"id": "applies_to_parts"
17	}
18	]
19	}
20	],
21	"artifacts": [
22	{
23	"id": "id"
24	}
25	],
26	"body": "body",
27	"created_by": {
28	"type": "sys_user",
29	"id": "created_by"
30	},
31	"created_date": "2023-01-01T12:00:00Z",
32	"custom_fields": {
33	"key": "value"
34	},
35	"custom_schema_fragments": [
36	"don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>"
37	],
38	"display_id": "display_id",
39	"identified_date": "2023-01-01T12:00:00Z",
40	"impacted_customers": [
41	{
42	"id": "id"
43	}
44	],
45	"mitigated_date": "2023-01-01T12:00:00Z",
46	"modified_by": {
47	"type": "sys_user",
48	"id": "modified_by"
49	},
50	"modified_date": "2023-01-01T12:00:00Z",
51	"owned_by": [
52	{
53	"type": "sys_user",
54	"id": "owned_by"
55	}
56	],
57	"pia": [
58	{
59	"id": "id"
60	}
61	],
62	"playbooks": [
63	{
64	"id": "id"
65	}
66	],
67	"reported_by": {
68	"id": 1000000,
69	"label": "label",
70	"ordinal": 1000000
71	},
72	"severity": {
73	"id": 1000000,
74	"label": "label",
75	"ordinal": 1000000
76	},
77	"source": {
78	"id": 1000000,
79	"label": "label",
80	"ordinal": 1000000
81	},
82	"stakeholders": [
83	{
84	"type": "sys_user",
85	"id": "stakeholders"
86	}
87	],
88	"stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>",
89	"subtype": "subtype",
90	"tags": [
91	{
92	"tag": {
93	"id": "id",
94	"name": "name"
95	}
96	}
97	],
98	"target_close_date": "2023-01-01T12:00:00Z"
99	}
100	],
101	"next_cursor": "next_cursor",
102	"prev_cursor": "prev_cursor"
103	}