List

GET

Lists a collection of work items.

Query parameters

applies_to_partstringOptional

Filters for work belonging to any of the provided parts.

created_bystringOptional

Filters for work created by any of these users.

cursorstringOptional

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

issue.accountsstringOptional

Filters for issues with any of the provided Accounts.

issue.priorityenumOptional

Filters for issues with any of the provided priorities.

Allowed values: p0p1p2p3

issue.priority_v2longOptional

Filters for issues with any of the provided priority enum ids.

issue.rev_orgsstringOptional

Filters for issues with any of the provided Rev organizations.

issue.sla_summary.stageenumOptional

Filters for records with any of the provided SLA stages.

Allowed values: breachedcompletedpausedrunningwarning

issue.sprintstringOptional

Filters for issues with any of the sprint.

limitintegerOptional

The maximum number of works to return. The default is ‘50’.

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 work owned by any of these users.

reported_bystringOptional

Filters for work reported by any of these users.

stage.namestringOptional

Filters for records in the provided stage(s) by name.

staged_info.is_stagedbooleanOptional

Filters for issues that are staged.

sync_metadata.external_referencestringOptional

Filters for issues with this specific external reference.

sync_metadata.last_sync_in.statusenumOptional

Filters for works with selected sync statuses.

Allowed values: failedmodifiedstagedsucceeded

sync_metadata.last_sync_in.sync_unitstringOptional

Filters for works modified with selected sync units.

sync_metadata.last_sync_out.statusenumOptional

Filters for works with selected sync statuses.

Allowed values: failedmodifiedsucceeded

sync_metadata.last_sync_out.sync_unitstringOptional

Filters for works modified with selected sync units.

sync_metadata.origin_systemstringOptional

Filters for issues synced from this specific origin system.

tagsstringOptional

Filters for work with any of the provided tags.

ticket.channelsenumOptional

Filters for tickets with any of the provided channels.

Allowed values: emailplugslacktwiliotwilio_sms

ticket.groupstringOptional

Filters for tickets belonging to specific groups.

ticket.is_spambooleanOptional

Filters for tickets that are spam.

ticket.needs_responsebooleanOptional

Filters for tickets that need response.

ticket.rev_orgstringOptional

Filters for tickets that are associated with any of the provided Rev organizations.

ticket.severityenumOptional

Filters for tickets with any of the provided severities.

Allowed values: blockerhighlowmedium

ticket.sla_summary.stageenumOptional

Filters for records with any of the provided SLA stages.

Allowed values: breachedcompletedpausedrunningwarning

ticket.source_channelstringOptional

Filters for tickets with any of the provided source channels.

type"issue" or "ticket"Optional

Filters for work of the provided types.

Allowed values: issueticket

Response

This endpoint returns an object.

workslist of objects

The list of works.

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.

GET

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

200Retrieved

1 {
2   "works": [
3     {
4       "type": "ticket",
5       "id": "works",
6       "owned_by": [
7         {
8           "type": "sys_user",
9           "id": "works"
10         }
11       ],
12       "title": "works",
13       "applies_to_part": {
14         "type": "product",
15         "id": "works",
16         "name": "works",
17         "owned_by": [
18           {
19             "type": "sys_user",
20             "id": "works"
21           }
22         ]
23       },
24       "artifacts": [
25         {
26           "id": "id"
27         }
28       ],
29       "body": "works",
30       "channels": [
31         "email"
32       ],
33       "created_by": {
34         "type": "sys_user",
35         "id": "works"
36       },
37       "created_date": "2023-01-01T12:00:00Z",
38       "display_id": "works",
39       "group": {
40         "id": "id"
41       },
42       "modified_by": {
43         "type": "sys_user",
44         "id": "works"
45       },
46       "modified_date": "2023-01-01T12:00:00Z",
47       "needs_response": true,
48       "reported_by": [
49         {
50           "type": "sys_user",
51           "id": "works"
52         }
53       ],
54       "rev_org": {
55         "type": "rev_org",
56         "id": "works"
57       },
58       "sentiment": {
59         "id": 1000000,
60         "label": "label",
61         "ordinal": 1000000
62       },
63       "sentiment_modified_date": "2023-01-01T12:00:00Z",
64       "sentiment_summary": "works",
65       "severity": "blocker",
66       "sla_tracker": {
67         "id": "id"
68       },
69       "source_channel": "works",
70       "stage": {
71         "name": "name"
72       },
73       "tags": [
74         {
75           "tag": {
76             "id": "id",
77             "name": "name"
78           }
79         }
80       ],
81       "target_close_date": "2023-01-01T12:00:00Z"
82     }
83   ],
84   "next_cursor": "next_cursor",
85   "prev_cursor": "prev_cursor"
86 }

Built with

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

1	{
2	"works": [
3	{
4	"type": "ticket",
5	"id": "works",
6	"owned_by": [
7	{
8	"type": "sys_user",
9	"id": "works"
10	}
11	],
12	"title": "works",
13	"applies_to_part": {
14	"type": "product",
15	"id": "works",
16	"name": "works",
17	"owned_by": [
18	{
19	"type": "sys_user",
20	"id": "works"
21	}
22	]
23	},
24	"artifacts": [
25	{
26	"id": "id"
27	}
28	],
29	"body": "works",
30	"channels": [
31	"email"
32	],
33	"created_by": {
34	"type": "sys_user",
35	"id": "works"
36	},
37	"created_date": "2023-01-01T12:00:00Z",
38	"display_id": "works",
39	"group": {
40	"id": "id"
41	},
42	"modified_by": {
43	"type": "sys_user",
44	"id": "works"
45	},
46	"modified_date": "2023-01-01T12:00:00Z",
47	"needs_response": true,
48	"reported_by": [
49	{
50	"type": "sys_user",
51	"id": "works"
52	}
53	],
54	"rev_org": {
55	"type": "rev_org",
56	"id": "works"
57	},
58	"sentiment": {
59	"id": 1000000,
60	"label": "label",
61	"ordinal": 1000000
62	},
63	"sentiment_modified_date": "2023-01-01T12:00:00Z",
64	"sentiment_summary": "works",
65	"severity": "blocker",
66	"sla_tracker": {
67	"id": "id"
68	},
69	"source_channel": "works",
70	"stage": {
71	"name": "name"
72	},
73	"tags": [
74	{
75	"tag": {
76	"id": "id",
77	"name": "name"
78	}
79	}
80	],
81	"target_close_date": "2023-01-01T12:00:00Z"
82	}
83	],
84	"next_cursor": "next_cursor",
85	"prev_cursor": "prev_cursor"
86	}