List Works (POST)
Lists a collection of work items.
Headers
Authorization
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
This endpoint expects an object.
type
Filters for work of the provided types.
Allowed values:
actual_close_date
Provides ways to specify date ranges on objects.
applies_to_part
Filters for work belonging to any of the provided parts.
created_by
Filters for work created by any of these users.
created_date
Provides ways to specify date ranges on objects.
cursor
The cursor to resume iteration from. If not provided, then
iteration starts from the beginning.
custom_fields
Filters for custom fields.
issue
limit
The maximum number of works to return. The default is '50'.
mode
The iteration mode to use. If “after”, then entries after the provided cursor will be returned, or if no cursor is provided, then from the beginning. If “before”, then entries before the provided cursor will be returned, or if no cursor is provided, then from the end. Entries will always be returned in the specified sort-by order.
Allowed values:
modified_by
Filters for work modified by any of these users.
modified_date
Provides ways to specify date ranges on objects.
opportunity
owned_by
Filters for work owned by any of these users.
reported_by
Filters for work reported by any of these users.
sort_by
Fields to sort the works by and the direction to sort them.
stage
The filter for stages.
staged_info
state
Filters for work with any of the provided states.
sync_metadata
target_close_date
Provides ways to specify date ranges on objects.
ticket
Response
Success.
works
The list of works.
next_cursor
The cursor used to iterate subsequent results in accordance to the
sort order. If not set, then no later elements exist.
prev_cursor
The cursor used to iterate preceding results in accordance to the
sort order. If not set, then no prior elements exist.