Works
Update Work
Updates a work item's information.
AuthorizationBearer <token>
All the DevRev APIs require a token to authenticate the user. Provide Authorization: Bearer <TOKEN> as a header to every API request.
How do I find my token?
In: header
Empty Object
developed_with?works-update-request-issue-developed-with
priority?issue-priority
Priority of the work based upon impact and criticality.
Value in
"p0" | "p1" | "p2" | "p3"priority_v2?integer
Priority enum id of the work based upon impact and criticality. The allowed ids can be extended by the user. Stock allowed values:
{
"id": 1,
"label": "P0",
"ordinal": 1,
"overridable": true
},
{
"id": 2,
"label": "P1",
"ordinal": 2,
"overridable": true
},
{
"id": 3,
"label": "P2",
"ordinal": 3,
"overridable": true
},
{
"id": 4,
"label": "P3",
"ordinal": 4,
"overridable": true
}Format
int64sprint?string | null
Updates the sprint that the issue belongs to.
Format
idtarget_start_date?string | null
Updates the timestamp for when the work is expected to start.
Format
date-timeaccount?string
Updates the account that the opportunity is associated with.
Format
idamount?number | null
Updates the total opportunity amount.
Format
doubleannual_contract_value?set-money
The money value to create.
contacts?works-update-request-opportunity-contacts
customer_budget?number | null
Updates the customer budget.
Format
doubleforecast_category_v2?integer
Forecast category enum ID of an opportunity. The allowed ids can be extended by the user. Stock allowed values:
{
"id": 1,
"label": "Omitted",
"ordinal": 1,
"overridable": true
},
{
"id": 2,
"label": "Pipeline",
"ordinal": 2,
"overridable": true
},
{
"id": 3,
"label": "Upside",
"ordinal": 3,
"overridable": true
},
{
"id": 4,
"label": "Strong Upside",
"ordinal": 4,
"overridable": true
},
{
"id": 5,
"label": "Commit",
"ordinal": 5,
"overridable": true
},
{
"id": 6,
"label": "Won",
"ordinal": 6,
"overridable": true
}Format
int64probability?number | null
Updates the probability of winning the deal, lies between 0.0 and 1.0.
Format
doublevalue?set-money
The money value to create.
embedded?boolean
Whether the task is embedded in the work.
priority?task-priority
Priority of the work based upon impact and criticality.
Value in
"p0" | "p1" | "p2" | "p3"start_date?string
Timestamp when the task was started.
Format
date-timeaccount?string | null
Updates the account that the ticket is associated with.
Format
idchannels?works-update-request-ticket-channels
channels_v2?array<string>
Updates channel IDs of the ticket.
group?string | null
Updates the group that the ticket is associated with.
Format
idis_archived?boolean
Whether the ticket is archived.
is_frozen?boolean
Whether the ticket is frozen.
is_spam?boolean
Updates whether the ticket is spam.
needs_response?boolean
Updates whether the ticket needs a response.
rev_org?string | null
Updates the Rev organization that the ticket is associated with.
Format
idsentiment?integer
The enum ID for the sentiment of the ticket. The allowed ids can be extended by the user. Stock allowed values:
{
"id": 1,
"label": "Delighted",
"ordinal": 1,
"overridable": true
},
{
"id": 2,
"label": "Happy",
"ordinal": 2,
"overridable": true
},
{
"id": 3,
"label": "Neutral",
"ordinal": 3,
"overridable": true
},
{
"id": 4,
"label": "Unhappy",
"ordinal": 4,
"overridable": true
},
{
"id": 5,
"label": "Frustrated",
"ordinal": 5,
"overridable": true
}Format
int64sentiment_modified_date?string
Timestamp at which sentiment was last modified.
Format
date-timesentiment_summary?string
Summary justifying the current sentiment.
Format
textseverity?ticket-severity
Severity of the ticket.
Value in
"blocker" | "high" | "low" | "medium"source_channel_v2?string | null
Updates the source channel of the ticket.
Format
idResponse Body
curl -X POST "https://api.devrev.ai/works.update" \ -H "Content-Type: application/json" \ -d '{ "id": "ISS-12345" }'{
"work": {
"type": "issue",
"created_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"created_date": "2023-01-01T12:00:00.000Z",
"display_id": "string",
"id": "string",
"modified_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"modified_date": "2023-01-01T12:00:00.000Z",
"actual_close_date": "2023-01-01T12:00:00.000Z",
"applies_to_part": {
"type": "capability",
"display_id": "string",
"id": "string",
"name": "string",
"owned_by": [
{
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
}
],
"sync_metadata": {
"external_reference": "string",
"origin_system": "string"
}
},
"artifacts": [
{
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
}
],
"body": "string",
"custom_fields": {},
"custom_schema_fragments": [
"don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id"
],
"owned_by": [
{
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
}
],
"reported_by": [
{
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
}
],
"stage": {
"name": "string",
"notes": "string",
"ordinal": 0,
"stage": {
"display_id": "string",
"id": "string",
"name": "string"
},
"state": {
"display_id": "string",
"id": "string",
"is_final": true,
"name": "string"
}
},
"stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id",
"subtype": "string",
"sync_metadata": {
"external_reference": "string",
"last_sync_in": {
"status": "failed",
"sync_date": "2023-01-01T12:00:00.000Z",
"sync_unit": {
"display_id": "string",
"id": "string",
"external_system_type": "adaas",
"is_archived": true,
"name": "string",
"sync_run": {
"mode": "initial",
"progress": {
"state": "completed"
}
},
"sync_type": "manual"
}
},
"last_sync_out": {
"status": "failed",
"sync_date": "2023-01-01T12:00:00.000Z",
"sync_unit": {
"display_id": "string",
"id": "string",
"external_system_type": "adaas",
"is_archived": true,
"name": "string",
"sync_run": {
"mode": "initial",
"progress": {
"state": "completed"
}
},
"sync_type": "manual"
}
},
"origin_system": "string"
},
"tags": [
{
"tag": {
"display_id": "string",
"id": "string",
"name": "string",
"style_new": {
"color": "string"
}
},
"value": "string"
}
],
"target_close_date": "2023-01-01T12:00:00.000Z",
"title": "string",
"actual_start_date": "2023-01-01T12:00:00.000Z",
"developed_with": [
{
"type": "capability",
"display_id": "string",
"id": "string",
"name": "string",
"owned_by": [
{
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
}
],
"sync_metadata": {
"external_reference": "string",
"origin_system": "string"
}
}
],
"estimated_effort": 0.1,
"priority": "p0",
"priority_v2": {
"id": 0,
"label": "string",
"ordinal": 0,
"value": null
},
"sla_summary": {
"closest_to_breach_metric": "string",
"org_schedule": {
"display_id": "string",
"id": "string",
"name": "string",
"status": "archived",
"timezone": "string",
"valid_until": "2023-01-01T12:00:00.000Z"
},
"remaining_time": 0,
"sla_tracker": {
"created_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"created_date": "2023-01-01T12:00:00.000Z",
"display_id": "string",
"id": "string",
"modified_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"modified_date": "2023-01-01T12:00:00.000Z",
"applies_to_id": "string",
"applies_to_type": "conversation",
"metric_target_summaries": [
{
"breached_at": "2023-01-01T12:00:00.000Z",
"completed_at": "2023-01-01T12:00:00.000Z",
"completed_in": 0,
"in_policy": true,
"is_out_of_schedule": true,
"metric_definition": {
"display_id": "string",
"id": "string",
"name": "string"
},
"next_schedule_transition": "2023-01-01T12:00:00.000Z",
"org_schedule": {
"display_id": "string",
"id": "string",
"name": "string",
"status": "archived",
"timezone": "string",
"valid_until": "2023-01-01T12:00:00.000Z"
},
"remaining_time": 0,
"stage": "string",
"status": "string",
"target_time": "2023-01-01T12:00:00.000Z",
"warning_target_time": "2023-01-01T12:00:00.000Z"
}
],
"removed_sla_metric_history": [
{
"metric_definition": {
"display_id": "string",
"id": "string",
"name": "string"
},
"removed_at": "2023-01-01T12:00:00.000Z",
"removed_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
}
}
],
"sla": {
"display_id": "string",
"id": "string",
"name": "string",
"sla_type": "external",
"status": "archived"
},
"sla_policy_id": "string",
"stage": "string",
"status": "string"
},
"stage": "breached",
"target_time": "2023-01-01T12:00:00.000Z"
},
"sla_tracker": {
"display_id": "string",
"id": "string",
"applies_to_type": "conversation"
},
"sprint": {
"type": "curated",
"end_date": "2023-01-01T12:00:00.000Z",
"id": "string",
"name": "string",
"start_date": "2023-01-01T12:00:00.000Z",
"state": "active"
},
"target_start_date": "2023-01-01T12:00:00.000Z"
}
}{
"detail": "string",
"message": "string",
"type": "artifact_already_attached_to_a_parent",
"existing_parent": "string",
"is_same": true
}{
"detail": "string",
"message": "string",
"type": "unauthenticated"
}{
"detail": "string",
"message": "string",
"type": "forbidden"
}{
"detail": "string",
"message": "string",
"type": "not_found"
}{
"detail": "string",
"message": "string",
"type": "too_many_requests",
"retry_after": 0
}{
"detail": "string",
"message": "string",
"type": "internal_error",
"reference_id": "string"
}{
"detail": "string",
"message": "string",
"type": "service_unavailable"
}