Jump to

• Request
• Response

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 page

  Default 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 inapplicable

  Default 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" ]

  [
      "ASSIGNED",
      "COMPLETED",
      "SUSPENDED",
      "WITHDRAWN",
      "EXPIRED",
      "ERRORED",
      "ALERTED"
  ]

• totalResults: boolean
  Total Result - true or false

  Default 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 Top

Response

Supported Media Types

• application/json

200 Response

Success

Body ()

Root Schema : Collection

Type: object

Show Source

• 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)

{
    "type":"object",
    "properties":{
        "totalResult":{
            "type":"boolean",
            "default":false
        },
        "limit":{
            "type":"integer",
            "format":"int32"
        },
        "count":{
            "type":"integer",
            "format":"int32"
        },
        "offset":{
            "type":"integer",
            "format":"int32"
        },
        "hasMore":{
            "type":"boolean",
            "default":false
        },
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/Task"
            }
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        },
        "totalResults":{
            "type":"integer",
            "format":"int32"
        }
    },
    "xml":{
        "name":"Collection",
        "namespace":"http://xmlns.oracle.com/bpm/rest/v3/common/"
    }
}

Nested Schema : items

Type: array

Show Source

• Array of: object task

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/Task"
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object link

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Nested Schema : task

Type: object

Show Source

• 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

{
    "required":[
        "href",
        "mediaType",
        "rel"
    ],
    "type":"object",
    "properties":{
        "href":{
            "type":"string",
            "format":"uri"
        },
        "linkId":{
            "type":"string"
        },
        "hreflang":{
            "type":"string"
        },
        "length":{
            "type":"integer",
            "format":"int32"
        },
        "rel":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "type":{
            "type":"string"
        },
        "mediaType":{
            "type":"string"
        },
        "actionList":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/TaskActionLink"
            }
        },
        "permissions":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "assignedDate":{
            "type":"string"
        },
        "createdBy":{
            "type":"string"
        },
        "dueDate":{
            "type":"string"
        },
        "fromUserDisplayName":{
            "type":"string"
        },
        "fromUserName":{
            "type":"string"
        },
        "groupByName":{
            "type":"string"
        },
        "groupByValue":{
            "type":"string"
        },
        "number":{
            "type":"integer",
            "format":"int32"
        },
        "priority":{
            "type":"integer",
            "format":"int32"
        },
        "taskId":{
            "type":"string"
        },
        "taskDefinitionName":{
            "type":"string"
        },
        "taskNamespace":{
            "type":"string"
        },
        "titlePrefix":{
            "type":"string",
            "description":"shown only for current assignee or creator of task"
        },
        "createdDate":{
            "type":"string"
        },
        "state":{
            "type":"string"
        },
        "ownerGroup":{
            "type":"string"
        },
        "ownerRole":{
            "type":"string"
        },
        "ownerUser":{
            "type":"string"
        },
        "applicationName":{
            "type":"string"
        },
        "assignees":{
            "$ref":"#/components/schemas/CollectionIdentity"
        },
        "attachments":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/Attachment"
            }
        },
        "history":{
            "$ref":"#/components/schemas/TaskHistories"
        },
        "comments":{
            "$ref":"#/components/schemas/Comments"
        },
        "payload":{
            "$ref":"#/components/schemas/TaskSummaryField"
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        },
        "detailsURL":{
            "$ref":"#/components/schemas/Link"
        },
        "hasSubTasksFlag":{
            "type":"boolean",
            "default":false
        },
        "outcome":{
            "type":"string"
        },
        "startDate":{
            "type":"string"
        },
        "identificationKey":{
            "type":"string"
        },
        "updatedDate":{
            "type":"string"
        },
        "getcListURL":{
            "$ref":"#/components/schemas/Link"
        },
        "formMetadata":{
            "type":"string"
        },
        "externalUIURL":{
            "type":"string"
        },
        "rootTaskNumber":{
            "type":"string"
        },
        "applicationContext":{
            "type":"string"
        }
    },
    "xml":{
        "name":"task",
        "namespace":"http://xmlns.oracle.com/bpm/rest/tasks"
    }
}

Nested Schema : actionList

Type: array

Show Source

• Array of: object taskactionlink

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/TaskActionLink"
    }
}

Nested Schema : Collection

Type: object

Show Source

• 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

{
    "type":"object",
    "properties":{
        "totalResult":{
            "type":"boolean",
            "default":false
        },
        "limit":{
            "type":"integer",
            "format":"int32"
        },
        "userLink":{
            "$ref":"#/components/schemas/Link"
        },
        "count":{
            "type":"integer",
            "format":"int32"
        },
        "offset":{
            "type":"integer",
            "format":"int32"
        },
        "hasMore":{
            "type":"boolean",
            "default":false
        },
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/Identity"
            }
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        }
    },
    "xml":{
        "name":"Collection",
        "namespace":"http://xmlns.oracle.com/bpm/rest/v3/common/"
    }
}

Nested Schema : attachments

Type: array

Show Source

• Array of: object attachment

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/Attachment"
    }
}

Nested Schema : comments

Type: object

Show Source

• comment: array comment

{
    "type":"object",
    "properties":{
        "comment":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/Comment"
            }
        }
    },
    "xml":{
        "name":"comments",
        "namespace":"http://xmlns.oracle.com/bpm/rest/tasks"
    }
}

Nested Schema : link

Type: object

Show Source

• href: string (uri)
  href of the provided link
• rel: string
  relationship with the returned resource

  Example: self

{
    "type":"object",
    "properties":{
        "href":{
            "type":"string",
            "description":"href of the provided link",
            "format":"uri"
        },
        "rel":{
            "type":"string",
            "description":"relationship with the returned resource",
            "example":"self"
        }
    },
    "xml":{
        "name":"link",
        "namespace":"http://xmlns.oracle.com/bpm/rest"
    }
}

Nested Schema : taskHistories

Type: object

Show Source

• taskHistory: array taskHistory

{
    "type":"object",
    "properties":{
        "taskHistory":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/TaskHistory"
            }
        }
    },
    "xml":{
        "name":"taskHistories",
        "namespace":"http://xmlns.oracle.com/bpm/rest/tasks"
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object link

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Nested Schema : payload

Type: object

Show Source

• comment: string
• priority: integer (int32)
• summaryFields: array summaryFields
• xmlPayload: string

{
    "type":"object",
    "properties":{
        "summaryFields":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/GenericMap"
            }
        },
        "comment":{
            "type":"string"
        },
        "priority":{
            "type":"integer",
            "format":"int32"
        },
        "xmlPayload":{
            "type":"string"
        }
    },
    "xml":{
        "name":"payload",
        "namespace":"http://xmlns.oracle.com/bpm/rest/tasks"
    }
}

Nested Schema : permissions

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : taskactionlink

Type: object

Show Source

• href(required): string (uri)
• hreflang: string
• length: integer (int32)
• linkId: string
• mediaType(required): string
• rel(required): string
• title: string
• type: string

{
    "required":[
        "href",
        "mediaType",
        "rel"
    ],
    "type":"object",
    "properties":{
        "href":{
            "type":"string",
            "format":"uri"
        },
        "linkId":{
            "type":"string"
        },
        "hreflang":{
            "type":"string"
        },
        "length":{
            "type":"integer",
            "format":"int32"
        },
        "rel":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "type":{
            "type":"string"
        },
        "mediaType":{
            "type":"string"
        }
    },
    "xml":{
        "name":"taskactionlink",
        "namespace":"http://xmlns.oracle.com/bpm/rest/tasks"
    }
}

Nested Schema : items

Type: array

Show Source

• Array of: object identity

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/Identity"
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object link

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Nested Schema : identity

Type: object

Show Source

• email: string
• firstName: string
• id: string
• identity: object link
• lastName: string
• middleName: string
• mobile: string
• type: string
• workPhone: string

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string"
        },
        "type":{
            "type":"string"
        },
        "email":{
            "type":"string"
        },
        "identity":{
            "$ref":"#/components/schemas/Link"
        },
        "firstName":{
            "type":"string"
        },
        "lastName":{
            "type":"string"
        },
        "middleName":{
            "type":"string"
        },
        "mobile":{
            "type":"string"
        },
        "workPhone":{
            "type":"string"
        }
    },
    "xml":{
        "name":"identity",
        "namespace":"http://xmlns.oracle.com/bpm/rest/identities"
    }
}

Nested Schema : attachment

Type: object

Show Source

• attachmentName: string
• attachmentScope: string
• content: string
• docAttributes: array docAttributes
• href: string (uri)
• input: string
• mimeType: string
• rel: string
• uri: object link

{
    "type":"object",
    "properties":{
        "href":{
            "type":"string",
            "format":"uri"
        },
        "rel":{
            "type":"string"
        },
        "attachmentName":{
            "type":"string"
        },
        "content":{
            "type":"string"
        },
        "mimeType":{
            "type":"string"
        },
        "attachmentScope":{
            "type":"string"
        },
        "docAttributes":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/GenericMap"
            }
        },
        "input":{
            "type":"string"
        },
        "uri":{
            "$ref":"#/components/schemas/Link"
        }
    },
    "xml":{
        "name":"attachment",
        "namespace":"http://xmlns.oracle.com/bpm/rest/tasks"
    }
}

Nested Schema : docAttributes

Type: array

Show Source

• Array of: object genericMap

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/GenericMap"
    }
}

Nested Schema : genericMap

Type: object

Show Source

• category: string
• dataType: string
• displayName: string
• name: string
• readOnly: string
• value: string

{
    "type":"object",
    "properties":{
        "dataType":{
            "type":"string"
        },
        "name":{
            "type":"string"
        },
        "readOnly":{
            "type":"string"
        },
        "value":{
            "type":"string"
        },
        "displayName":{
            "type":"string"
        },
        "category":{
            "type":"string"
        }
    },
    "xml":{
        "name":"genericMap",
        "namespace":"http://xmlns.oracle.com/bpm/rest/tasks"
    }
}

Nested Schema : comment

Type: array

Show Source

• Array of: object comment

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/Comment"
    }
}

Nested Schema : comment

Type: object

Show Source

• commentStr: string

{
    "type":"object",
    "properties":{
        "commentStr":{
            "type":"string"
        }
    },
    "xml":{
        "name":"comment",
        "namespace":"http://xmlns.oracle.com/bpm/rest/tasks"
    }
}

Nested Schema : taskHistory

Type: array

Show Source

• Array of: object taskHistory

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/TaskHistory"
    }
}

Nested Schema : taskHistory

Type: object

Show Source

• actionName: string
• displayName: string
• pattern: string
• reason: string
• updatedDate: string
• userId: string

{
    "type":"object",
    "properties":{
        "actionName":{
            "type":"string"
        },
        "displayName":{
            "type":"string"
        },
        "userId":{
            "type":"string"
        },
        "pattern":{
            "type":"string"
        },
        "reason":{
            "type":"string"
        },
        "updatedDate":{
            "type":"string"
        }
    },
    "xml":{
        "name":"taskHistory",
        "namespace":"http://xmlns.oracle.com/bpm/rest/tasks"
    }
}

Nested Schema : summaryFields

Type: array

Show Source

• Array of: object genericMap

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/GenericMap"
    }
}

206 Response

Partial Content

400 Response

Bad request

401 Response

Unauthorized

404 Response

Task list not found

500 Response

Internal Server Error

Back to Top