Update Work

POST

Updates a work item’s information.

Request

This endpoint expects an object.

issue

none

opportunity

task

ticket

Response

Success.

workobject

Errors

POST

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

200worksUpdateExample

1 {
2   "work": {
3     "created_by": {
4       "display_id": "foo",
5       "id": "foo",
6       "display_name": "foo",
7       "display_picture": {
8         "display_id": "foo",
9         "id": "foo",
10         "file": {
11           "type": "foo",
12           "name": "foo",
13           "size": 42
14         }
15       },
16       "email": "foo",
17       "full_name": "foo",
18       "state": "active"
19     },
20     "created_date": "2023-01-01T12:00:00.000Z",
21     "display_id": "foo",
22     "id": "foo",
23     "modified_by": {
24       "display_id": "foo",
25       "id": "foo",
26       "display_name": "foo",
27       "display_picture": {
28         "display_id": "foo",
29         "id": "foo",
30         "file": {
31           "type": "foo",
32           "name": "foo",
33           "size": 42
34         }
35       },
36       "email": "foo",
37       "full_name": "foo",
38       "state": "active"
39     },
40     "modified_date": "2023-01-01T12:00:00.000Z",
41     "actual_close_date": "2023-01-01T12:00:00.000Z",
42     "applies_to_part": {
43       "display_id": "foo",
44       "id": "foo",
45       "name": "foo",
46       "owned_by": [
47         {}
48       ],
49       "sync_metadata": {
50         "external_reference": "foo",
51         "origin_system": "foo"
52       }
53     },
54     "artifacts": [
55       {
56         "display_id": "foo",
57         "id": "foo",
58         "file": {
59           "type": "foo",
60           "name": "foo",
61           "size": 42
62         }
63       }
64     ],
65     "body": "foo",
66     "custom_fields": {},
67     "custom_schema_fragments": [
68       "foo"
69     ],
70     "owned_by": [
71       {
72         "display_id": "foo",
73         "id": "foo",
74         "display_name": "foo",
75         "display_picture": {
76           "display_id": "foo",
77           "id": "foo",
78           "file": {}
79         },
80         "email": "foo",
81         "full_name": "foo",
82         "state": "active"
83       }
84     ],
85     "reported_by": [
86       {
87         "display_id": "foo",
88         "id": "foo",
89         "display_name": "foo",
90         "display_picture": {
91           "display_id": "foo",
92           "id": "foo",
93           "file": {}
94         },
95         "email": "foo",
96         "full_name": "foo",
97         "state": "active"
98       }
99     ],
100     "stage": {
101       "name": "foo",
102       "notes": "foo",
103       "ordinal": 42,
104       "stage": {
105         "display_id": "foo",
106         "id": "foo",
107         "name": "foo"
108       },
109       "state": {
110         "display_id": "foo",
111         "id": "foo",
112         "is_final": true,
113         "name": "foo"
114       }
115     },
116     "stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id",
117     "subtype": "foo",
118     "sync_metadata": {
119       "external_reference": "foo",
120       "last_sync_in": {
121         "status": "failed",
122         "sync_date": "2023-01-01T12:00:00.000Z",
123         "sync_unit": {
124           "display_id": "foo",
125           "id": "foo",
126           "external_system_type": "adaas",
127           "is_archived": true,
128           "name": "foo",
129           "sync_run": {
130             "mode": "initial",
131             "progress": {
132               "state": "completed"
133             }
134           },
135           "sync_type": "manual"
136         }
137       },
138       "last_sync_out": {
139         "status": "failed",
140         "sync_date": "2023-01-01T12:00:00.000Z",
141         "sync_unit": {
142           "display_id": "foo",
143           "id": "foo",
144           "external_system_type": "adaas",
145           "is_archived": true,
146           "name": "foo",
147           "sync_run": {
148             "mode": "initial",
149             "progress": {
150               "state": "completed"
151             }
152           },
153           "sync_type": "manual"
154         }
155       },
156       "origin_system": "foo"
157     },
158     "tags": [
159       {
160         "tag": {
161           "display_id": "foo",
162           "id": "foo",
163           "name": "foo",
164           "style_new": {
165             "color": "foo"
166           }
167         },
168         "value": "foo"
169       }
170     ],
171     "target_close_date": "2023-01-01T12:00:00.000Z",
172     "title": "foo",
173     "actual_start_date": "2023-01-01T12:00:00.000Z",
174     "developed_with": [
175       {
176         "display_id": "foo",
177         "id": "foo",
178         "name": "foo",
179         "owned_by": [
180           {}
181         ],
182         "sync_metadata": {
183           "external_reference": "foo",
184           "origin_system": "foo"
185         }
186       }
187     ],
188     "priority": "p0",
189     "priority_v2": {
190       "id": 42,
191       "label": "foo",
192       "ordinal": 42,
193       "value": null
194     },
195     "sla_summary": {
196       "closest_to_breach_metric": "foo",
197       "org_schedule": {
198         "display_id": "foo",
199         "id": "foo",
200         "name": "foo",
201         "status": "archived",
202         "timezone": "foo",
203         "valid_until": "2023-01-01T12:00:00.000Z"
204       },
205       "remaining_time": 42,
206       "sla_tracker": {
207         "created_by": {
208           "display_id": "foo",
209           "id": "foo",
210           "display_name": "foo",
211           "display_picture": {},
212           "email": "foo",
213           "full_name": "foo",
214           "state": "active"
215         },
216         "created_date": "2023-01-01T12:00:00.000Z",
217         "display_id": "foo",
218         "id": "foo",
219         "modified_by": {
220           "display_id": "foo",
221           "id": "foo",
222           "display_name": "foo",
223           "display_picture": {},
224           "email": "foo",
225           "full_name": "foo",
226           "state": "active"
227         },
228         "modified_date": "2023-01-01T12:00:00.000Z",
229         "applies_to_id": "foo",
230         "applies_to_type": "conversation",
231         "metric_target_summaries": [
232           {
233             "breached_at": "2023-01-01T12:00:00.000Z",
234             "completed_at": "2023-01-01T12:00:00.000Z",
235             "completed_in": 42,
236             "in_policy": true,
237             "is_out_of_schedule": true,
238             "metric_definition": {
239               "display_id": "foo",
240               "id": "foo",
241               "name": "foo"
242             },
243             "next_schedule_transition": "2023-01-01T12:00:00.000Z",
244             "org_schedule": {
245               "display_id": "foo",
246               "id": "foo",
247               "name": "foo",
248               "status": "archived",
249               "timezone": "foo",
250               "valid_until": "2023-01-01T12:00:00.000Z"
251             },
252             "remaining_time": 42,
253             "stage": "foo",
254             "status": "foo",
255             "target_time": "2023-01-01T12:00:00.000Z",
256             "warning_target_time": "2023-01-01T12:00:00.000Z"
257           }
258         ],
259         "removed_sla_metric_history": [
260           {
261             "metric_definition": {
262               "display_id": "foo",
263               "id": "foo",
264               "name": "foo"
265             },
266             "removed_at": "2023-01-01T12:00:00.000Z",
267             "removed_by": {}
268           }
269         ],
270         "sla": {
271           "display_id": "foo",
272           "id": "foo",
273           "name": "foo",
274           "sla_type": "external",
275           "status": "archived"
276         },
277         "sla_policy_id": "foo",
278         "stage": "foo",
279         "status": "foo"
280       },
281       "stage": "breached",
282       "target_time": "2023-01-01T12:00:00.000Z"
283     },
284     "sla_tracker": {
285       "display_id": "foo",
286       "id": "foo",
287       "applies_to_type": "conversation"
288     },
289     "sprint": {
290       "type": "curated",
291       "end_date": "2023-01-01T12:00:00.000Z",
292       "id": "foo",
293       "name": "foo",
294       "start_date": "2023-01-01T12:00:00.000Z",
295       "state": "active"
296     },
297     "target_start_date": "2023-01-01T12:00:00.000Z"
298   }
299 }

Changelog

Up Next

Built with

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

1	{
2	"work": {
3	"created_by": {
4	"display_id": "foo",
5	"id": "foo",
6	"display_name": "foo",
7	"display_picture": {
8	"display_id": "foo",
9	"id": "foo",
10	"file": {
11	"type": "foo",
12	"name": "foo",
13	"size": 42
14	}
15	},
16	"email": "foo",
17	"full_name": "foo",
18	"state": "active"
19	},
20	"created_date": "2023-01-01T12:00:00.000Z",
21	"display_id": "foo",
22	"id": "foo",
23	"modified_by": {
24	"display_id": "foo",
25	"id": "foo",
26	"display_name": "foo",
27	"display_picture": {
28	"display_id": "foo",
29	"id": "foo",
30	"file": {
31	"type": "foo",
32	"name": "foo",
33	"size": 42
34	}
35	},
36	"email": "foo",
37	"full_name": "foo",
38	"state": "active"
39	},
40	"modified_date": "2023-01-01T12:00:00.000Z",
41	"actual_close_date": "2023-01-01T12:00:00.000Z",
42	"applies_to_part": {
43	"display_id": "foo",
44	"id": "foo",
45	"name": "foo",
46	"owned_by": [
47	{}
48	],
49	"sync_metadata": {
50	"external_reference": "foo",
51	"origin_system": "foo"
52	}
53	},
54	"artifacts": [
55	{
56	"display_id": "foo",
57	"id": "foo",
58	"file": {
59	"type": "foo",
60	"name": "foo",
61	"size": 42
62	}
63	}
64	],
65	"body": "foo",
66	"custom_fields": {},
67	"custom_schema_fragments": [
68	"foo"
69	],
70	"owned_by": [
71	{
72	"display_id": "foo",
73	"id": "foo",
74	"display_name": "foo",
75	"display_picture": {
76	"display_id": "foo",
77	"id": "foo",
78	"file": {}
79	},
80	"email": "foo",
81	"full_name": "foo",
82	"state": "active"
83	}
84	],
85	"reported_by": [
86	{
87	"display_id": "foo",
88	"id": "foo",
89	"display_name": "foo",
90	"display_picture": {
91	"display_id": "foo",
92	"id": "foo",
93	"file": {}
94	},
95	"email": "foo",
96	"full_name": "foo",
97	"state": "active"
98	}
99	],
100	"stage": {
101	"name": "foo",
102	"notes": "foo",
103	"ordinal": 42,
104	"stage": {
105	"display_id": "foo",
106	"id": "foo",
107	"name": "foo"
108	},
109	"state": {
110	"display_id": "foo",
111	"id": "foo",
112	"is_final": true,
113	"name": "foo"
114	}
115	},
116	"stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id",
117	"subtype": "foo",
118	"sync_metadata": {
119	"external_reference": "foo",
120	"last_sync_in": {
121	"status": "failed",
122	"sync_date": "2023-01-01T12:00:00.000Z",
123	"sync_unit": {
124	"display_id": "foo",
125	"id": "foo",
126	"external_system_type": "adaas",
127	"is_archived": true,
128	"name": "foo",
129	"sync_run": {
130	"mode": "initial",
131	"progress": {
132	"state": "completed"
133	}
134	},
135	"sync_type": "manual"
136	}
137	},
138	"last_sync_out": {
139	"status": "failed",
140	"sync_date": "2023-01-01T12:00:00.000Z",
141	"sync_unit": {
142	"display_id": "foo",
143	"id": "foo",
144	"external_system_type": "adaas",
145	"is_archived": true,
146	"name": "foo",
147	"sync_run": {
148	"mode": "initial",
149	"progress": {
150	"state": "completed"
151	}
152	},
153	"sync_type": "manual"
154	}
155	},
156	"origin_system": "foo"
157	},
158	"tags": [
159	{
160	"tag": {
161	"display_id": "foo",
162	"id": "foo",
163	"name": "foo",
164	"style_new": {
165	"color": "foo"
166	}
167	},
168	"value": "foo"
169	}
170	],
171	"target_close_date": "2023-01-01T12:00:00.000Z",
172	"title": "foo",
173	"actual_start_date": "2023-01-01T12:00:00.000Z",
174	"developed_with": [
175	{
176	"display_id": "foo",
177	"id": "foo",
178	"name": "foo",
179	"owned_by": [
180	{}
181	],
182	"sync_metadata": {
183	"external_reference": "foo",
184	"origin_system": "foo"
185	}
186	}
187	],
188	"priority": "p0",
189	"priority_v2": {
190	"id": 42,
191	"label": "foo",
192	"ordinal": 42,
193	"value": null
194	},
195	"sla_summary": {
196	"closest_to_breach_metric": "foo",
197	"org_schedule": {
198	"display_id": "foo",
199	"id": "foo",
200	"name": "foo",
201	"status": "archived",
202	"timezone": "foo",
203	"valid_until": "2023-01-01T12:00:00.000Z"
204	},
205	"remaining_time": 42,
206	"sla_tracker": {
207	"created_by": {
208	"display_id": "foo",
209	"id": "foo",
210	"display_name": "foo",
211	"display_picture": {},
212	"email": "foo",
213	"full_name": "foo",
214	"state": "active"
215	},
216	"created_date": "2023-01-01T12:00:00.000Z",
217	"display_id": "foo",
218	"id": "foo",
219	"modified_by": {
220	"display_id": "foo",
221	"id": "foo",
222	"display_name": "foo",
223	"display_picture": {},
224	"email": "foo",
225	"full_name": "foo",
226	"state": "active"
227	},
228	"modified_date": "2023-01-01T12:00:00.000Z",
229	"applies_to_id": "foo",
230	"applies_to_type": "conversation",
231	"metric_target_summaries": [
232	{
233	"breached_at": "2023-01-01T12:00:00.000Z",
234	"completed_at": "2023-01-01T12:00:00.000Z",
235	"completed_in": 42,
236	"in_policy": true,
237	"is_out_of_schedule": true,
238	"metric_definition": {
239	"display_id": "foo",
240	"id": "foo",
241	"name": "foo"
242	},
243	"next_schedule_transition": "2023-01-01T12:00:00.000Z",
244	"org_schedule": {
245	"display_id": "foo",
246	"id": "foo",
247	"name": "foo",
248	"status": "archived",
249	"timezone": "foo",
250	"valid_until": "2023-01-01T12:00:00.000Z"
251	},
252	"remaining_time": 42,
253	"stage": "foo",
254	"status": "foo",
255	"target_time": "2023-01-01T12:00:00.000Z",
256	"warning_target_time": "2023-01-01T12:00:00.000Z"
257	}
258	],
259	"removed_sla_metric_history": [
260	{
261	"metric_definition": {
262	"display_id": "foo",
263	"id": "foo",
264	"name": "foo"
265	},
266	"removed_at": "2023-01-01T12:00:00.000Z",
267	"removed_by": {}
268	}
269	],
270	"sla": {
271	"display_id": "foo",
272	"id": "foo",
273	"name": "foo",
274	"sla_type": "external",
275	"status": "archived"
276	},
277	"sla_policy_id": "foo",
278	"stage": "foo",
279	"status": "foo"
280	},
281	"stage": "breached",
282	"target_time": "2023-01-01T12:00:00.000Z"
283	},
284	"sla_tracker": {
285	"display_id": "foo",
286	"id": "foo",
287	"applies_to_type": "conversation"
288	},
289	"sprint": {
290	"type": "curated",
291	"end_date": "2023-01-01T12:00:00.000Z",
292	"id": "foo",
293	"name": "foo",
294	"start_date": "2023-01-01T12:00:00.000Z",
295	"state": "active"
296	},
297	"target_start_date": "2023-01-01T12:00:00.000Z"
298	}
299	}