List Works
Lists a collection of work items.
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
Query Parameters
Filters for work belonging to any of the provided parts.
Filters for work created by any of these users.
The cursor to resume iteration from. If not provided, then iteration starts from the beginning.
textFilters for custom fields.
Empty Object
Filters for issues with any of the provided accounts.
Filters for issues with any of the provided priorities.
Filters for issues with any of the provided priority enum ids.
Filters for issues with any of the provided Rev organizations.
Filters for records with any of the provided SLA stages.
Filters for issues with any of the sprint.
Filters for issues with any of the provided subtypes.
The maximum number of works to return. The default is '50'.
int32The iteration mode to use, otherwise if not set, then "after" is used.
"after" | "before"Filters for work modified by any of these users.
Filters for opportunities belonging to any of the provided accounts.
Filters for opportunities with any of the provided contacts.
Filters for opportunities with any of the provided forecast category enum IDs.
Filters for opportunity with any of the provided subtypes.
Filters for work owned by any of these users.
Filters for work reported by any of these users.
Fields to sort the works by and the direction to sort them.
Filters for records in the provided stage(s) by name.
Filters for issues that are staged.
Filters for work with any of the provided states.
Filters for issues with this specific external reference.
Filters for works with selected sync statuses.
Filters for works modified with selected sync history.
Filters for works modified with selected sync units.
Filters for works with selected sync statuses.
Filters for works modified with selected sync history.
Filters for works modified with selected sync units.
Filters for issues synced from this specific origin system.
Filters for work with any of the provided tags.
Filters for tickets that are associated with any of the brands.
Filters for tickets with any of the provided channels.
Filters for tickets that are associated with any of the channels.
Filters for tickets belonging to specific groups.
Filters for frozen tickets.
Filters for tickets that are spam.
Filters for tickets that need response.
Filters for tickets that are associated with any of the provided Rev organizations.
Filters for tickets with any of the provided severities.
Filters for records with any of the provided SLA stages.
Filters for tickets with any of the provided source channels.
Filters for tickets that are associated with any of the source channels.
Filters for tickets with any of the provided subtypes.
Filters for work of the provided types.
Response Body
curl -X GET "https://api.devrev.ai/works.list?applies_to_part=PROD-12345&created_by=DEVU-12345&cursor=string&custom_fields=&issue.accounts=ACC-12345&issue.priority=p0&issue.priority_v2=0&issue.rev_orgs=REV-AbCdEfGh&issue.sla_summary.stage=breached&issue.sprint=string&issue.subtype=string&limit=0&mode=after&modified_by=DEVU-12345&opportunity.account=ACC-12345&opportunity.contacts=string&opportunity.forecast_category_v2=0&opportunity.subtype=string&owned_by=DEVU-12345&reported_by=DEVU-12345&sort_by=string&stage.name=string&staged_info.is_staged=true&state=string&sync_metadata.external_reference=string&sync_metadata.last_sync_in.status=failed&sync_metadata.last_sync_in.sync_history=string&sync_metadata.last_sync_in.sync_unit=string&sync_metadata.last_sync_out.status=failed&sync_metadata.last_sync_out.sync_history=string&sync_metadata.last_sync_out.sync_unit=string&sync_metadata.origin_system=string&tags=TAG-12345&ticket.brand=string&ticket.channels=email&ticket.channels_v2=string&ticket.group=string&ticket.is_frozen=true&ticket.is_spam=true&ticket.needs_response=true&ticket.rev_org=REV-AbCdEfGh&ticket.severity=blocker&ticket.sla_summary.stage=breached&ticket.source_channel=string&ticket.source_channel_v2=string&ticket.subtype=string&type=issue"{
"next_cursor": "string",
"prev_cursor": "string",
"works": [
{
"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": "too_many_requests",
"retry_after": 0
}{
"detail": "string",
"message": "string",
"type": "internal_error",
"reference_id": "string"
}{
"detail": "string",
"message": "string",
"type": "service_unavailable"
}