Retrieve a Task List
get
/bpm/api/4.0/tasks
Retrieves a task list for the current user.
Request
Query Parameters
- assignment: string Task assignees - MY, GROUP, MY_AND_GROUP (default), MY_AND_GROUP_ALL, REPORTEES, OWNER, REVIEWER, PREVIOUS, ALL, ADMIN. MY - Displays tasks that are assigned exclusively to you. GROUP - Displays tasks that are assigned to a group of which you are a member. MY_AND_GROUP -Displays tasks that are assigned to anyone, including you, in the groups you belongs to.This will not fetch tasks that are acquired by some other user in the groups you belong to. MY_AND_GROUP_ALL -Displays tasks that are assigned to anyone, including you, in the groups you belongs to.This will even fetch tasks that are acquired by some other user in the groups you belong to. REPORTEES - Displays tasks that are assigned to reportees of you OWNER - Displays tasks in which you are task owner. REVIEWER -Displays tasks for which you are a reviewer PREVIOUS - Displays tasks that were previously updated by you ALL - No filtering; Displays all tasks regardless of assignment or creator. ADMIN - No filtering; Displays all tasks regardless of assignment or creator.Default Value:
MY_AND_GROUP
- createdBy: string if provided, only tasks created by the given user are returned
- dueDateFrom: string Start of due date range in ISO-8601 format YYYY-MM-DDTHH:MM:SS[.sss]Z
- dueDateTo: string End of due date range in ISO-8601 format YYYY-MM-DDTHH:MM:SS[.sss]Z
- fields: array[string] Displays only the selected task attributes, which can include createdDate, creator, updatedDate, fromUser, tasknumber, priority,ownerUser, state, approvalDuration,taskDefinitionName, taskNameSpace, taskId, category,assignedDate, dueDate,outcome,ecid, identificationKey
- fromuser: array[string] Previous task assignee
- identificationKey: string if provided, only tasks with the given task identification key are returned
- keyword: string Keyword in task title
- limit: integer(int32) Maximum number of items per page, preferably between 1 and 100, default 25. Zero or negative value will render the parameter inapplicable and all results will be returned in single pageDefault Value:
25
- metadataFlag: boolean metadataFlag - true or false. if metadataFlag is true, then task details URL is populated.Default Value:
false
- offset: integer(int32) Index for the first item on a page of list items. Negative value will render the parameter inapplicableDefault Value:
0
- orderBy: string Field with which results are to be ordered. Given as orderBy=fieldname:asc/desc, default is asc for ascending.Field Names supported are createdDate, creator, updatedDate, fromUser, tasknumber, priority,ownerUser, state, approvalDuration,taskDefinitionName, taskNameSpace, taskId, category,assignedDate, dueDate,outcome,ecid, identificationKey
- outcome: string if provided, only tasks with the given task outcome value are returned
- pattern: string If pattern value is set to 'ToDo' then only ToDo tasks are returned.
- priority: array[string] Task priority from 1 (highest) to 5 (lowest) or Any (default)
- showActionFlag: boolean Show Action - true or false
- showPermissionFlag: boolean Show Permission - true or false
- since: string Returned items must be created later than the specified time, in ISO-8601 format YYYY-MM-DDTHH:MM:SS[.sss]Z
- status: array[string] Task status (Task status COMPLETED is valid when used with following assignments - ADMIN, ALL, PREVIOUS)
- Default Value:
ASSIGNED
Allowed Values:[ "ASSIGNED", "COMPLETED", "SUSPENDED", "WITHDRAWN", "EXPIRED", "ERRORED", "ALERTED" ]
-
- totalResults: boolean Total Result - true or falseDefault Value:
true
- until: string Returned items must be created before the specified time, in ISO-8601 format YYYY-MM-DDTHH:MM:SS[.sss]Z
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Success
Root Schema : Collection
Type:
Show Source object
- count: integer (int32)
- hasMore: boolean Default Value:
false
- items: array items
- limit: integer (int32)
- links: array links
- offset: integer (int32)
- totalResult: boolean Default Value:
false
- totalResults: integer (int32)
Nested Schema : task
Type:
Show Source object
- actionList: array actionList
- applicationContext: string
- applicationName: string
- assignedDate: string
- assignees: object Collection
- attachments: array attachments
- comments: object comments
- createdBy: string
- createdDate: string
- detailsURL: object link
- dueDate: string
- externalUIURL: string
- formMetadata: string
- fromUserDisplayName: string
- fromUserName: string
- getcListURL: object link
- groupByName: string
- groupByValue: string
- hasSubTasksFlag: boolean Default Value:
false
- history: object taskHistories
- href(required): string (uri)
- hreflang: string
- identificationKey: string
- length: integer (int32)
- linkId: string
- links: array links
- mediaType(required): string
- number: integer (int32)
- outcome: string
- ownerGroup: string
- ownerRole: string
- ownerUser: string
- payload: object payload
- permissions: array permissions
- priority: integer (int32)
- rel(required): string
- rootTaskNumber: string
- startDate: string
- state: string
- taskDefinitionName: string
- taskId: string
- taskNamespace: string
- title: string
- titlePrefix: string shown only for current assignee or creator of task
- type: string
- updatedDate: string
Nested Schema : Collection
Type:
Show Source object
- count: integer (int32)
- hasMore: boolean Default Value:
false
- items: array items
- limit: integer (int32)
- links: array links
- offset: integer (int32)
- totalResult: boolean Default Value:
false
- userLink: object link
Nested Schema : link
Type:
Show Source object
- href: string (uri) href of the provided link
- rel: string relationship with the returned resourceExample:
self
206 Response
Partial Content
400 Response
Bad request
401 Response
Unauthorized
404 Response
Task list not found
500 Response
Internal Server Error