openapi: 3.0.3 info: title: Blue Prism API description: An API to expose core functionality of the Blue Prism product. version: 7.5.1 servers: - url: https://{address} description: 'Customer-hosted Blue Prism API instance. Blue Prism Enterprise is self-hosted: the API ships as an IIS site installed on the customer''s own web server, so the host is environment-specific. Documented base URL format: http(s)://
/api/v7 (https://documentation.blueprism.com/bp-7-5/en-us/bp-api/api-example-usage.htm).' variables: address: default: bpapi.example.com description: Host name of the web server where the Blue Prism API is installed. security: - Bearer: - bp-api - bpserver - OAuth2: - bp-api - bpserver paths: /api/v7/calendars: get: summary: Return a list of calendars. description: '### Permissions required: `System - Calendar permission` ' operationId: getCalendars tags: - Calendars parameters: - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query schema: type: string enum: - IdAsc - IdDesc - NameAsc - NameDesc - RegionIdAsc - RegionIdDesc - name: id description: A filter to search for calendar id. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: name description: A filter to search for the name of the calendar. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: region description: A filter to search for the region id. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: workingWeek in: query style: form explode: false description: The working week to search for. schema: type: array items: type: string enum: - Sunday - Monday - Tuesday - Wednesday - Thursday - Friday - Saturday responses: '200': description: A list calendars was successfully retrieved. content: application/json: schema: type: array items: $ref: '#/components/schemas/Calendar' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' post: summary: Creates a Calendar. description: '> ### Permissions required: `System - Calendars` ' tags: - Calendars requestBody: description: Details of the calendar to create. required: true content: application/json: schema: $ref: '#/components/schemas/CreateCalendarModel' responses: '201': description: The calendar was successfully created. content: application/json: schema: $ref: '#/components/schemas/CreateCalendarResponseModel' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/calendars/{calendarId}: get: summary: Returns a calendar by Id description: '### Permissions required: `System - Calendar permission` ' tags: - Calendars parameters: - name: calendarId in: path description: The ID of the calendar to get. required: true schema: type: integer format: int32 responses: '200': description: A calendar was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/Calendar' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' delete: summary: Deletes a specified calendar. description: '### Permissions required: `System - Calendar permission` ' tags: - Calendars parameters: - name: calendarId in: path description: The ID of the calendar to delete. required: true schema: type: integer format: int32 responses: '204': description: The calendar was successfully deleted. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/Conflict' patch: summary: Update a calendar by Id operationId: updateCalendar description: '> ### Permissions required: `System - Calendar permission` ' tags: - Calendars parameters: - name: calendarId in: path required: true description: The ID of the Calendar to update. schema: type: integer format: int32 requestBody: description: Details of the calendar to update. required: true content: application/json: schema: $ref: '#/components/schemas/PatchRequest' examples: add (to array): $ref: '#/components/examples/PatchAddToArrayExample' add (to object): $ref: '#/components/examples/PatchAddToObjectExample' copy: $ref: '#/components/examples/PatchCopyExample' move: $ref: '#/components/examples/PatchMoveExample' remove: $ref: '#/components/examples/PatchRemoveExample' replace: $ref: '#/components/examples/PatchReplaceExample' responses: '204': description: The calendar was successfully updated. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/calendars/{calendarId}/clones: post: summary: Clones a calendar by Id description: '### Permissions required: `System - Calendar permission` ' tags: - Calendars parameters: - name: calendarId in: path description: The ID of the calendar to clone. required: true schema: type: integer format: int32 requestBody: description: Details of the calendar to create. required: true content: application/json: schema: $ref: '#/components/schemas/CloneCalendarModel' responses: '201': description: The calendar was successfully cloned. content: application/json: schema: $ref: '#/components/schemas/CreateCalendarResponseModel' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/calendars/{calendarId}/otherHolidays: get: summary: Returns calendar other holidays by calendar Id description: '### Permissions required: `System - Calendar permission` ' tags: - Calendars parameters: - name: calendarId in: path description: The ID of the calendar used to get other holidays. required: true schema: type: integer format: int32 responses: '200': description: The calendar other holidays were successfully retrieved. content: application/json: schema: type: array items: type: string example: - '2021-01-04' - '2021-10-25' - '2022-03-05' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/calendars/{calendarId}/otherHolidays/batch: delete: summary: Deletes other holidays in calendar. description: '### Permissions required: `System - Calendar permission` ' tags: - Calendars parameters: - name: calendarId in: path description: The ID of the calendar used to remove other holidays. required: true schema: type: integer format: int32 requestBody: description: The list of other holidays to delete. required: true content: application/json: schema: $ref: '#/components/schemas/OtherHolydaysModel' responses: '204': description: Other holidays were successfully deleted. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' post: summary: Creates other holidays in calendar. description: '### Permissions required: `System - Calendar permission` ' tags: - Calendars parameters: - name: calendarId in: path description: The ID of the calendar used to add other holidays. required: true schema: type: integer format: int32 requestBody: description: The list of other holidays to create. required: true content: application/json: schema: $ref: '#/components/schemas/OtherHolydaysModel' responses: '204': description: Other holidays were successfully created. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/calendars/{calendarId}/references: get: summary: Returns a list of process that reference a given calendar. description: '' tags: - Calendars parameters: - name: calendarId in: path description: The ID of the calendar to find references for. required: true schema: type: integer format: int32 - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query schema: type: string enum: - NameAsc - NameDesc - DescriptionAsc - DescriptionDesc - ProcessTypeAsc - ProcessTypeDesc - name: itemsPerPage description: The maximum number of items to retrieve. in: query schema: type: integer minimum: 1 - name: pagingToken description: The token to point to the last item previously returned. in: query schema: type: string - name: name description: A filter to search for the name of the reference. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: description in: query style: deepObject description: A filter to search for the description of the reference. schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: processType in: query style: form explode: false description: The type of the process to search for. schema: type: array items: type: string enum: - Process - Object responses: '200': description: A list of Calendar references were succesfully retrieved. content: application/json: schema: $ref: '#/components/schemas/ReferencesItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/dashboards/workQueueCompositions: get: summary: Return aggregate work queue data for each of the requested queues. operationId: getWorkQueueData tags: - Dashboards parameters: - name: workQueueIds in: query description: Array of work queue IDs to retrieve data for. required: true schema: type: array items: type: string format: uuid responses: '200': description: A list of work queue composition details was successfully retrieved. content: application/json: schema: type: array items: $ref: '#/components/schemas/WorkQueueComposition' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/dashboards/resourceUtilization: get: summary: Return runtime resource utilization. operationId: getResourceUtilization tags: - Dashboards parameters: - name: startDate in: query required: true description: The start date. schema: type: string format: date-time - name: resourceIds in: query description: Array of resource IDs to filter on. schema: type: array items: type: string format: uuid - name: pageNumber in: query description: Page number parameter used for data paging of utilization heat map. schema: type: integer - name: pageSize in: query description: Page size parameter used for data paging of utilization heat map. schema: type: integer responses: '200': description: A list of resource utilization details was successfully retrieved. content: application/json: schema: type: array items: $ref: '#/components/schemas/ResourceUtilization' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/dashboards/resourcesSummaryUtilization: get: summary: Return runtime resources summary utilization by date range. operationId: getResourceSummaryUtilizationByDate tags: - Dashboards parameters: - name: startDate in: query required: true description: The start date. schema: type: string format: date-time - name: endDate in: query required: true description: The end date. schema: type: string format: date-time - name: resourceIds in: query description: Resource IDs to filter on. schema: type: array items: type: string format: uuid responses: '200': description: A list of resource utilization by date range was successfully retrieved. content: application/json: schema: type: array items: $ref: '#/components/schemas/ResourcesSummaryUtilization' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/dashboards/licensesEntitlement: get: summary: Return aggregated licenses entitlement data. description: '> ### Permissions required: `System - License permission` ' tags: - Dashboards responses: '200': description: An aggregated licenses entitlement data was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/LicensesEntitlement' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/dashboards/currentLimitsAndUsage: get: summary: Return current active licenses limits and usages. operationId: getLicenseLimits description: '> ### Permissions required At least one of: `View Resource Screen Capture` | `View Resource` | `Control Resource` | `Configure Resource`
And at least one of: `Audit Alerts` | `Subscribe To Process Alerts` | `Configure Process Alerts` ' tags: - Dashboards responses: '200': description: Details of current active licenses limits and usages was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/LicenseUsageDetailsModel' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/encryptionschemes: get: summary: Return a list of encryption schemes in the environment. operationId: getEncryptionSchemes description: '> ### Permissions required: `Security - View Encryption Scheme Configuration` ' tags: - Encryption Schemes responses: '200': description: A list of encryption schemes was successfully retrieved. content: application/json: schema: type: array items: $ref: '#/components/schemas/EncryptionScheme' /api/v7/environmentvariables: get: summary: Return a list of environment variables. operationId: getEnvironmentVariables description: '> ### Permissions required At least one of: `Business Objects - View Environment Variables` | `Business Objects - Configure Environment Variables` | `Processes - View Environment Variables` | `Processes - Configure Environment Variables` ' tags: - Environment Variables parameters: - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query schema: type: string enum: - NameAsc - NameDesc - DescriptionAsc - DescriptionDesc - DataTypeAsc - DataTypeDesc - name: itemsPerPage description: The maximum number of items to retrieve. in: query schema: type: integer minimum: 1 - name: pagingToken description: The token to point to the last item previously returned. in: query schema: type: string - name: name description: A filter to search for the name of the environment variable. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: description in: query style: deepObject description: A filter to search for the description of the environment variable. schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: dataType in: query style: form explode: false description: The type of the environment variable to search for. schema: type: array items: type: string enum: - Binary - Date - DateTime - Flag - Image - Number - Password - RadioButtons - Text - Time - TimeSpan responses: '200': description: A list of environment variables was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/EnvironmentVariableItemsPage' examples: text: $ref: '#/components/examples/EnvironmentVariableTextExample' radiobuttons: $ref: '#/components/examples/EnvironmentVariableRadioButtonsExample' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' post: summary: Creates an Environment Variable. operationId: createEnvironmentVariable description: '> ### Permissions required: `Business Objects - Configure Environment Variables`, `Process - Configure Environment Variables` ' tags: - Environment Variables requestBody: description: Details of the environment variable to create. required: true content: application/json: schema: $ref: '#/components/schemas/CreateEnvironmentVariableModel' responses: '201': description: The environment variable was successfully created. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/environmentvariables/{environmentVariableId}/references: get: summary: Return references to a specified environment variable. operationId: getEnvironmentVariableReferences description: '> ### Permissions required: At least one of: `Business Objects - Configure Environment Variables`, `Processes - Configure Environment Variables` ' tags: - Environment Variables parameters: - name: environmentVariableId in: path description: The id of the environment variable. required: true schema: type: string format: uuid - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query schema: type: string enum: - NameAsc - NameDesc - DescriptionAsc - DescriptionDesc - ProcessTypeAsc - ProcessTypeDesc - name: itemsPerPage description: The maximum number of items to retrieve. in: query schema: type: integer minimum: 1 - name: pagingToken description: The token to point to the last item previously returned. in: query schema: type: string - name: name description: A filter to search for the name of the environment variable. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: description in: query style: deepObject description: A filter to search for the description of the environment variable reference. schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: processType description: A filter to search for the references by process type. in: query schema: $ref: '#/components/schemas/ProcessType' responses: '200': description: A list of environment variables references was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/EnvironmentVariableReferencesItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/environmentvariables/{environmentVariableId}: delete: summary: Delete environment variable by ID. operationId: deleteEnvironmentVariable description: '> ### Permissions required: `Business Objects - Configure Environment Variables` or `Processes - Configure Environment Variables` ' tags: - Environment Variables parameters: - name: environmentVariableId in: path description: The id of the environment variable. required: true schema: type: string format: uuid responses: '204': description: Environment variable was successfuly deleted '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' patch: summary: Updates the Environment Variable by ID. operationId: updateEnvironmentVariable description: '> ### Permissions required: `Business Objects - Configure Environment Variables` Or `Processes - Configure Environment Variables` ' tags: - Environment Variables parameters: - name: environmentVariableId in: path required: true description: The id of the environment variable to update. schema: type: string format: uuid requestBody: content: application/json: schema: $ref: '#/components/schemas/PatchRequest' examples: add (to array): $ref: '#/components/examples/PatchAddToArrayExample' add (to object): $ref: '#/components/examples/PatchAddToObjectExample' copy: $ref: '#/components/examples/PatchCopyExample' move: $ref: '#/components/examples/PatchMoveExample' remove: $ref: '#/components/examples/PatchRemoveExample' replace: $ref: '#/components/examples/PatchReplaceExample' responses: '204': description: The environment variable was successfully updated. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/health: get: summary: Return health of API. tags: - Health responses: '200': description: Health of API was retrieved with OK health. content: application/json: schema: $ref: '#/components/schemas/Health' '503': description: Health of API was retrieved with Service Unavailable health. content: application/json: schema: $ref: '#/components/schemas/Health' example: healthy: false dependencies: - name: databse healthy: false /api/v7/holidayRegions: get: summary: Return a list of holiday regions. description: '### Permissions required: `System - Calendars permission` ' operationId: getHolidayRegions tags: - Calendars responses: '200': description: A list of holiday regions was successfully retrieved. content: application/json: schema: type: array items: $ref: '#/components/schemas/HolidayRegion' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/holidayRegions/{holidayRegionId}/publicHolidays: get: summary: Return a list of holiday by region id. description: '### Permissions required: `System - Calendars permission` ' operationId: getHolidayByRegionId tags: - Calendars parameters: - name: holidayRegionId in: path description: The ID of the holiday region. required: true schema: type: integer format: int32 responses: '200': description: A list of holiday by region id was successfully retrieved. content: application/json: schema: type: array items: $ref: '#/components/schemas/HolidayByRegionId' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/processes: get: summary: Return a list of all the processes in the environment. operationId: GetProcesses description: '> ### Permissions required At least one of: `Create Process` | `Delete Process` | `Edit Process` | `Edit Process Groups` | `Execute Process` | `Execute Process as Web Service` | `Export Process` | `Manage Process Access Rights` | `View Process Definition` ' tags: - Processes parameters: - name: processName description: A filter to search for the name of the process. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: description description: A filter to search for the description of the process. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: groupName description: A filter to search for the group name of the process. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: attributesInclude in: query description: A filter to search for attributes to be included. style: form explode: false schema: type: array items: $ref: '#/components/schemas/ProcessAttributeFilter' - name: attributesExclude in: query description: A filter to search for attributes to be excluded. style: form explode: false schema: type: array items: $ref: '#/components/schemas/ProcessAttributeFilter' - name: sortBy in: query description: The field that results should be sorted by and the direction they should be sorted in. schema: type: string title: getProcessSortBy enum: - NameAsc - NameDesc - DescriptionAsc - DescriptionDesc - GroupAsc - GroupDesc - name: itemsPerPage in: query description: The maximum number of items to retrieve per page. schema: type: integer minimum: 1 - name: pagingToken in: query description: The token to point to the last item previously returned. schema: type: string responses: '200': description: An array of processes summaries. content: application/json: schema: $ref: '#/components/schemas/ProcessItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/processgroups/root/descendants: get: summary: Return a list of all the processes / process groups in the process group tree. operationId: getAllProcessGroupItems description: '> ### Permissions required At least one of: `Create Process` | `Delete Process` | `Edit Process` | `Edit Process Groups` | `Execute Process` | `Execute Process as Web Service` | `Export Process` | `Manage Process Access Rights` | `View Process Definition` ' tags: - Processes parameters: - name: name in: query description: A filter to search for the name of the process / group. style: deepObject required: false schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: sortBy in: query description: The field that results should be sorted by and the direction they should be sorted in. required: false schema: title: getAllProcessGroupItemsSortBy type: string enum: - NameAsc - NameDesc - name: itemsPerPage in: query description: The maximum number of items to retrieve per page. required: false schema: type: integer minimum: 1 - name: pagingToken in: query description: The token to point to the last item previously returned. required: false schema: type: string - name: attributesInclude in: query description: A filter to search for attributes to be included. style: form explode: false schema: type: array items: $ref: '#/components/schemas/ProcessAttributeFilter' - name: attributesExclude in: query description: A filter to search for attributes to be excluded. style: form explode: false schema: type: array items: $ref: '#/components/schemas/ProcessAttributeFilter' responses: '200': description: An array of process / process group summaries. content: application/json: schema: $ref: '#/components/schemas/ProcessGroupItemItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/resources: get: summary: Return a list of resources in the environment. operationId: getResources description: '> ### Permissions required At least one of: `View Resource` | `View Resource Screen Captures` | `Configure Resource` | `Control Resource` | `Manage Resource Access Rights` | `View Resource Details` ' tags: - Resources parameters: - name: name description: A filter to search for the name of the resource. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: groupName description: A filter to search for the group name of the resource. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: poolName description: A filter to search for the pool name of the resource. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: activeSessionCount description: A filter to search for resource's active session count. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: pendingSessionCount description: A filter to search for resource's pending session count. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: displayStatus description: A filter to search for the current status of the resource. in: query style: form explode: false schema: type: array items: type: string enum: - Working - Idle - Warning - Offline - Missing - LoggedOut - Private - Details - BPD - Hybrid - name: retirementFilter description: A filter to search for the retirement status of the resource. The default behavior is to search for non-retired resources. in: query schema: type: string enum: - NonRetired - Retired - All - name: resourceType description: A filter to search for the resource type. in: query schema: type: string enum: - Enterprise - Desktop - RemoteDigitalWorker - name: includeResourcePools description: Includes resource pools in the results. in: query schema: type: boolean - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query schema: type: string enum: - NameAsc - NameDesc - PoolAsc - PoolDesc - GroupAsc - GroupDesc - PendingAsc - PendingDesc - ActiveAsc - ActiveDesc - DisplayStatusAsc - DisplayStatusDesc - name: itemsPerPage in: query description: The maximum number of items to retrieve per page. schema: type: integer minimum: 1 - name: pagingToken nullable: true in: query description: The token to point to the last item previously returned. schema: type: string responses: '200': description: An array of resource summaries. content: application/json: schema: $ref: '#/components/schemas/ResourceItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/resources/{resourceId}: put: operationId: updateResource summary: Retire or unretire a resource with the given ID. description: '> ### Permissions required: `Configure Resource` ' tags: - Resources parameters: - name: resourceId in: path description: The ID of the resource or pool. required: true schema: type: string format: uuid requestBody: required: true description: 'To retire an active resource, use "Retire". To unretire a resource, use "None". The "Retire" attribute should not be included if attempting to unretire a resource. ' content: application/json: schema: $ref: '#/components/schemas/UpdateResource' responses: '204': description: The resource has been successfully updated. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': description: The resource could not be updated. See errorMessage for more details. content: application/json: schema: $ref: '#/components/schemas/Error' /api/v7/resources/pools: get: summary: Return a list of resource pools. operationId: getResourcePools description: '> ### Permissions required At least one of: `View Resource` | `View Resource Screen Captures` | `Configure Resource` | `Control Resource` | `Manage Resource Access Rights` | `View Resource Details` ' tags: - Pools responses: '200': description: A list pools was successfully retrieved. content: application/json: schema: type: array items: $ref: '#/components/schemas/ResourcePool' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/schedules: get: summary: Return a list of schedules in the environment. operationId: getSchedules description: '> ### Permissions required At least one of: `View Schedule` | `Edit Schedule` | `Delete Schedule` | `Create Schedule` | `Retire Schedule` | `System - Scheduler` ' tags: - Schedules parameters: - name: name description: A filter to search for name of the schedule. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: retirementStatus description: A filter to search for the retirement status of the schedule. The default behavior is to search for all statuses. in: query style: form explode: false schema: type: array items: type: string enum: - Active - Retired - name: itemsPerPage in: query description: The maximum number of items to retrieve per page. schema: type: integer minimum: 1 - name: pagingToken in: query description: The token to point to the last item previously returned. schema: type: string responses: '200': description: A list of schedule summaries was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/ScheduleItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' post: summary: Create a new schedule definition. operationId: createSchedule description: '> ### Permissions required: `Create Schedule`

and `Edit Schedule` ' tags: - Schedules parameters: - name: copyFrom in: query description: Schedule ID to create copy against. deprecated: true schema: type: integer requestBody: description: Details of the schedule definition to create or to update when cloning. To send a request without a body, enter a null value (swagger only). content: application/json: schema: $ref: '#/components/schemas/ScheduleDetailsOptionalName' responses: '201': description: The schedule definition was successfully created/copied. content: application/json: schema: $ref: '#/components/schemas/CreateScheduleDefinitionResponseModel' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/schedules/{scheduleId}: get: summary: Return requested schedule summary. operationId: getSchedule description: '> ### Permissions required At least one of: `View Schedule` | `Edit Schedule` | `Delete Schedule` | `Create Schedule` | `Retire Schedule` | `System - Scheduler` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule to return. required: true schema: type: integer responses: '200': description: The schedule summary was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/ScheduleDefinitionResponseModel' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' put: summary: Update a given schedule. operationId: updateSchedule description: '> ### Permissions required For editing: `Edit Schedule`

For retiring all of the following: `Edit Schedule` | `Retire Schedule`

For unretiring all of the following: `Edit Schedule` | `Retire Schedule` | `Create Schedule` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule to update. required: true schema: type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/ScheduleDetailsOptionalName' responses: '200': description: The schedule was successfully updated. content: application/json: schema: $ref: '#/components/schemas/ScheduleDefinitionResponseModel' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' delete: summary: Delete a specified schedule. operationId: deleteSchedule description: '> ### Permissions required: `Delete Schedule`

and `Edit Schedule` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule to delete. required: true schema: type: integer responses: '204': description: The schedule was successfully deleted. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/schedules/{scheduleId}/clones: post: summary: Clone a new schedule definition. operationId: CloneSchedule description: "> ### Permissions required\n`Create Schedule` and `Edit Schedule` \n" tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule to copy. required: true schema: type: integer requestBody: description: Details of the schedule definition to update. Name can not be a null value. content: application/json: schema: $ref: '#/components/schemas/CloneScheduleDetails' responses: '200': description: The schedule summary was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/CreateScheduleDefinitionResponseModel' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/schedules/{scheduleId}/sessions: post: deprecated: true summary: Create a session and set a schedule to run at a specific date and time. operationId: startSchedule description: '> ### Permissions required: `Edit Schedule` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule to start. required: true schema: type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/ScheduleSessionStart' responses: '202': description: The schedule was successfully set to run at a specified date and time. content: application/json: schema: $ref: '#/components/schemas/ScheduleSessionStartResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' delete: deprecated: true summary: Request the schedule to stop. operationId: stopSchedule description: '> ### Permissions required: `Edit Schedule` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule. required: true schema: type: integer responses: '202': description: The request to stop the schedule was successfully sent. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/schedules/{scheduleId}/runs/active: delete: summary: Request the schedule to stop. operationId: stopSchedule description: '> ### Permissions required: `Edit Schedule` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule. required: true schema: type: integer responses: '202': description: The request to stop the schedule was successfully sent. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/schedules/{scheduleId}/tasks: get: summary: Return a list of tasks in a schedule. operationId: getScheduleTasks description: '> ### Permissions required At least one of: `View Schedule` | `Edit Schedule` | `Delete Schedule` | `Create Schedule` | `Retire Schedule` | `System - Scheduler` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule for which to retrieve tasks. required: true schema: type: integer responses: '200': description: A list of tasks is successfully retrieved. content: application/json: schema: type: array items: $ref: '#/components/schemas/ScheduledTask' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' post: summary: Create a task in a schedule. operationId: createScheduleTask description: '> ### Permissions required At least one of: `Create Schedule` | `Edit Schedule` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule for which to create task. required: true schema: type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateScheduledTask' responses: '201': description: An ID of successfully created task. content: application/json: schema: $ref: '#/components/schemas/CreateScheduledTaskResponse' '400': $ref: '#/components/responses/BadRequestErrorMessage' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/Conflict' /api/v7/schedules/{scheduleId}/tasks/{taskId}: get: summary: Return a given scheduled task. operationId: getScheduleTask description: '> ### Permissions required At least one of: `View Schedule` | `Edit Schedule` | `Delete Schedule` | `Create Schedule` | `Retire Schedule` | `System - Scheduler` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule that task belongs to. required: true schema: type: integer - name: taskId in: path description: The ID of the scheduled task to return. required: true schema: type: integer responses: '200': description: The schedule task was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/ScheduledTask' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' delete: summary: Delete a given scheduled task. operationId: deleteScheduleTask description: '> ### Permissions required: `Edit Schedule`

and `Delete Schedule` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule that task belongs to. required: true schema: type: integer - name: taskId in: path description: The ID of the task to delete. required: true schema: type: integer responses: '204': description: The task was successfully deleted. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' put: summary: Update a given scheduled task. operationId: updateScheduleTask description: '> ### Permissions required: `Edit Schedule` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule that task belongs to required: true schema: type: integer - name: taskId in: path description: The ID of the scheduled task to update. required: true schema: type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateScheduledTask' responses: '204': description: The scheduled task was successfully updated. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/schedules/{scheduleId}/tasks/{taskId}/sessions/{sessionId}: delete: summary: Delete scheduled task session. operationId: deleteScheduledTaskSession description: '> ### Permissions required: `Edit Schedule` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule. required: true schema: type: integer - name: taskId in: path description: The ID of the scheduled task. required: true schema: type: integer - name: sessionId in: path description: The ID of the scheduled task session. required: true schema: type: integer responses: '204': description: The scheduled task session was successfully deleted. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/schedules/{scheduleId}/tasks/{taskId}/sessions: get: summary: Return a list of the scheduled sessions for a specified task. operationId: getScheduledSessionForTask description: '> ### Permissions required At least one of: `View Schedule` | `Edit Schedule` | `Delete Schedule` | `Create Schedule` | `Retire Schedule` | `System - Scheduler` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule that task belongs to. required: true schema: type: integer - name: taskId in: path description: The ID of the task to retrieve data for. required: true schema: type: integer minimum: 1 responses: '200': description: A collection of the associated scheduled sessions for a specific task. content: application/json: schema: $ref: '#/components/schemas/ScheduledSession' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' post: summary: Create a scheduled session in task. operationId: createScheduleSessionForTask description: '> ### Permissions required At least one of: `View Resource Screen Capture` | `View Resource Details` | `Manage Resource Access Rights` | `Control Resource` | `Configure Resource` | `View Resource`

And at least one of: `View Process Definition` | `Export Process` | `Execute Process` | `Manage Process Access Rights` | `Execute Process as Web Service` | `Edit Process Groups` | `Edit Process` | `Delete Process` | `Create Process`

and `Edit Schedule` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule that task belongs to. required: true schema: type: integer minimum: 1 - name: taskId in: path description: The ID of the task for which to create scheduled session. required: true schema: type: integer minimum: 1 requestBody: description: Parameters of the scheduled session to create. required: true content: application/json: schema: $ref: '#/components/schemas/ScheduledSessionParameters' responses: '201': description: A successfully created scheduled session ID. content: application/json: schema: $ref: '#/components/schemas/CreateScheduledSessionResponse' '400': $ref: '#/components/responses/BadRequestErrorMessage' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/schedules/tasks/{taskId}/sessions: get: deprecated: true summary: Return a list of the scheduled sessions for a specified task. operationId: getSchduledSessionsForTask description: '> ### Permissions required At least one of: `View Schedule` | `Edit Schedule` | `Delete Schedule` | `Create Schedule` | `Retire Schedule` | `System - Scheduler` ' tags: - Schedules parameters: - name: taskId in: path description: The ID of the task to retrieve data for. required: true schema: type: integer minimum: 1 responses: '200': description: A collection of the associated scheduled sessions for a specific task. content: application/json: schema: $ref: '#/components/schemas/ScheduledSession' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/schedules/{scheduleId}/tasks/{taskId}/scheduledSessionParameters: put: summary: Update start-up parameters. operationId: updateStartupParameters description: '> ### Permissions required: `Edit Schedule` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule to update start-up parameters for. required: true schema: type: integer minimum: 1 - name: taskId in: path description: The ID of the task to update start-up parameters for. required: true schema: type: integer minimum: 1 requestBody: description: A collection of start up parameters. required: true content: application/json: schema: $ref: '#/components/schemas/ScheduledSessionArguments' responses: '204': description: Associated scheduled sessions for a specific task were updated. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' get: summary: Return start-up parameters. operationId: getStartupParameters description: '> ### Permissions required At least one of: `View Schedule` | `Edit Schedule` | `Delete Schedule` | `Create Schedule` | `Retire Schedule` | `System - Scheduler` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule to retrieve start-up parameters for. required: true schema: type: integer minimum: 1 - name: taskId in: path description: The ID of the task to retrieve start-up parameters for. required: true schema: type: integer minimum: 1 responses: '200': description: A collection of start up parameters for a specific task. content: application/json: schema: $ref: '#/components/schemas/ScheduledSessionArguments' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/schedules/{scheduleId}/logs: get: deprecated: true summary: Return all logs for a specified schedule operationId: getLogsForSchedule description: '> ### Permissions required At least one of: `View Schedule` | `Edit Schedule` | `Delete Schedule` | `Create Schedule` | `Retire Schedule` | `System - Scheduler` ' tags: - Schedules parameters: - name: scheduleId description: The ID of the schedule to retrieve data for in: path required: true schema: type: integer - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query required: false schema: type: string enum: - EndTimeAsc - EndTimeDesc - ScheduleLogIdAsc - ScheduleLogIdDesc - ScheduleNameAsc - ScheduleNameDesc - ServerNameAsc - ServerNameDesc - StartTimeAsc - StartTimeDesc - StatusAsc - StatusDesc - name: itemsPerPage description: The number of items to show per page in: query required: false schema: type: integer - name: scheduleLogStatus description: A filter to search for the status of the log. in: query style: form explode: false schema: type: array items: type: string enum: - Pending - Running - Terminated - Completed - PartExceptioned - name: startTime description: A filter to search for the log start time. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: endTime description: A filter to search for the log end time. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: pagingToken description: The token to point to the last item previously returned in: query schema: type: string - name: scheduleName description: A filter to search for name of the schedule. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: serverName description: A filter to search for name of the server. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' responses: '200': description: A page containing a list of schedule log items and paging token are successfully retrieved content: application/json: schema: $ref: '#/components/schemas/ScheduleLogDeprecatedItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/schedules/logs: get: deprecated: true summary: Return all schedule logs. operationId: getAllScheduleLogs description: '> ### Permissions required At least one of: `View Schedule` | `Edit Schedule` | `Delete Schedule` | `Create Schedule` | `Retire Schedule` | `System - Scheduler` ' tags: - Schedules parameters: - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query required: false schema: type: string enum: - EndTimeAsc - EndTimeDesc - ScheduleLogIdAsc - ScheduleLogIdDesc - ScheduleNameAsc - ScheduleNameDesc - ServerNameAsc - ServerNameDesc - StartTimeAsc - StartTimeDesc - StatusAsc - StatusDesc - name: itemsPerPage description: The maximum number of items to retrieve per page. in: query required: false schema: type: integer - name: scheduleLogStatus description: A filter to search for the status of the log. in: query style: form explode: false schema: type: array items: type: string enum: - Pending - Running - Terminated - Completed - PartExceptioned - name: startTime description: A filter to search for the log start time. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: endTime description: A filter to search for the log end time. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: pagingToken in: query description: The token to point to the last item previously returned. schema: type: string - name: scheduleName description: A filter to search for name of the schedule. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: serverName description: A filter to search for name of the server. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' responses: '200': description: A page containing a list of schedule log items and a paging token are successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/ScheduleLogDeprecatedItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/schedules/{scheduleId}/runs: post: summary: Create a session and set a schedule to run at a specific date and time. operationId: createSessionRun description: '> ### Permissions required: `Edit Schedule` ' tags: - Schedules parameters: - name: scheduleId in: path description: The ID of the schedule to start. required: true schema: type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/ScheduleSessionStart' responses: '202': description: The schedule was successfully set to run at a specified date and time. content: application/json: schema: $ref: '#/components/schemas/ScheduleSessionStartResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/scheduleLogs: get: summary: Return all schedule logs. operationId: getScheduleLogs description: '> ### Permissions required At least one of: `View Schedule` | `Edit Schedule` | `Delete Schedule` | `Create Schedule` | `Retire Schedule` | `System - Scheduler` ' tags: - ScheduleLogs parameters: - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query required: false schema: type: string enum: - EndTimeAsc - EndTimeDesc - ScheduleLogIdAsc - ScheduleLogIdDesc - ScheduleNameAsc - ScheduleNameDesc - ServerNameAsc - ServerNameDesc - StartTimeAsc - StartTimeDesc - StatusAsc - StatusDesc - DurationAsc - DurationDesc - name: itemsPerPage description: The maximum number of items to retrieve per page. in: query required: false schema: type: integer - name: scheduleLogStatus description: A filter to search for the status of the log. in: query style: form explode: false schema: type: array items: type: string enum: - Pending - Running - Terminated - Completed - PartExceptioned - name: startTime description: A filter to search for the log start time. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: endTime description: A filter to search for the log end time. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: duration description: A filter to search for the schedules duration. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/TimeEqualsExample' range: $ref: '#/components/examples/TimeRangeExample' greater: $ref: '#/components/examples/TimeLessThanExample' - name: pagingToken in: query description: The token to point to the last item previously returned. schema: type: string - name: scheduleName description: A filter to search for name of the schedule. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: serverName description: A filter to search for name of the server. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' responses: '200': description: A page containing a list of schedule log items and a paging token are successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/ScheduleLogItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/scheduleLogs/{scheduleId}: get: summary: Return all logs for a specified schedule. operationId: getScheduleLogsById description: '> ### Permissions required At least one of: `View Schedule` | `Edit Schedule` | `Delete Schedule` | `Create Schedule` | `Retire Schedule` | `System - Scheduler` ' tags: - ScheduleLogs parameters: - name: scheduleId description: The ID of the schedule to retrieve data for. in: path required: true schema: type: integer - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query required: false schema: type: string enum: - EndTimeAsc - EndTimeDesc - ScheduleLogIdAsc - ScheduleLogIdDesc - ServerNameAsc - ServerNameDesc - StartTimeAsc - StartTimeDesc - StatusAsc - StatusDesc - DurationAsc - DurationDesc - name: itemsPerPage description: The maximum number of items to retrieve per page. in: query required: false schema: type: integer - name: scheduleLogStatus description: A filter to search for the status of the log. in: query style: form explode: false schema: type: array items: type: string enum: - Pending - Running - Terminated - Completed - PartExceptioned - name: startTime description: A filter to search for the log start time. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: endTime description: A filter to search for the log end time. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: duration description: A filter to search for the schedules duration. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/TimeEqualsExample' range: $ref: '#/components/examples/TimeRangeExample' greater: $ref: '#/components/examples/TimeLessThanExample' - name: pagingToken description: The token to point to the last item previously returned. in: query schema: type: string - name: serverName description: A filter to search for name of the server. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' responses: '200': description: A page containing a list of schedule log items and paging token are successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/ScheduleLogItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/sessions: get: summary: Return a list of sessions in the environment. operationId: GetSessions description: '> ### Permissions required At least one of: `Create Process` | `Delete Process` | `Edit Process` | `Edit Process Groups` | `Export Process` | `Execute Process` | `Execute Process as Web Service` | `View Process Definition` | `Manage Process Access Rights`

And at least one of: `View Resource` | `View Resource Screen Captures` | `Configure Resource` | `Control Resource` | `Manage Resource Access Rights` ' tags: - Sessions parameters: - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query required: false style: form explode: false schema: title: getSessionsSortBy type: string enum: - SessionNumberAsc - SessionNumberDesc - ProcessNameAsc - ProcessNameDesc - ResourceNameAsc - ResourceNameDesc - UserNameAsc - UserNameDesc - StatusAsc - StatusDesc - ExceptionTypeAsc - ExceptionTypeDesc - StartTimeAsc - StartTimeDesc - EndTimeAsc - EndTimeDesc - LatestStageAsc - LatestStageDesc - StageStartedAsc - StageStartedDesc - name: itemsPerPage description: The maximum number of items to retrieve. in: query required: false schema: type: integer minimum: 1 - name: pagingToken description: The token to point to the last item previously returned. in: query required: false schema: type: string - name: processName description: A filter to search for the name of the process being run by the session. in: query style: deepObject required: false schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: sessionNumber description: A filter to search for the session number. style: deepObject required: false in: query schema: $ref: '#/components/schemas/BasicNumericFilter' examples: startsWith: $ref: '#/components/examples/IntegerStartsWithExample' equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' greater: $ref: '#/components/examples/IntegerGreaterThanExample' - name: resourceName description: A filter to search for the name of the resource on which the session is running/ran. in: query required: false style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: userName description: A filter to search for the name of the user that triggered the session. in: query required: false style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: status description: The status of the sessions to search for. in: query required: false style: form explode: false schema: type: array items: $ref: '#/components/schemas/SessionStatus' - name: sessionSource description: The source of the sessions to search for. in: query required: false style: form explode: false schema: type: array items: $ref: '#/components/schemas/SessionSource' - name: startTime description: A filter to search for the time that the session started. in: query style: deepObject required: false schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: endTime description: A filter to search for the time that the session ended. in: query style: deepObject schema: nullable: true $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: latestStage description: A filter to search for the name of the latest stage. in: query style: deepObject schema: nullable: true $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: stageStarted description: A filter to search for the time when the latest stage started. in: query style: deepObject schema: nullable: true $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: onlySessionsForCurrentUser description: Flag to restrict sessions to API user. in: query schema: nullable: true type: boolean - name: processId.eq description: The ID of the process to retrieve data for. in: query required: false schema: nullable: true type: string format: uuid responses: '200': description: An array of session summaries. content: application/json: schema: $ref: '#/components/schemas/SessionItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' post: summary: Create a new session for the given resource ID and process ID. operationId: createSession description: '> ### Permissions required At least one of: `Create Process` | `Edit Process` | `Execute Process`

and `Control Resource` ' tags: - Sessions requestBody: description: Parameters to create a new session required: true content: application/json: schema: $ref: '#/components/schemas/CreateSessionParameters' responses: '200': description: A newly created session ID. content: application/json: schema: type: string format: uuid '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/sessions/{sessionId}: get: summary: Return details of a specified session. operationId: getSession description: '> ### Permissions required At least one of: `Create Process` | `Delete Process` | `Edit Process` | `Edit Process Groups` | `Export Process` | `Execute Process` | `Execute Process as Web Service` | `View Process Definition` | `Manage Process Access Rights`

And at least one of: `View Resource` | `View Resource Screen Captures` | `Configure Resource` | `Control Resource` | `Manage Resource Access Rights` ' tags: - Sessions parameters: - name: sessionId in: path description: The ID of the session to retrieve data for. required: true schema: type: string format: uuid responses: '200': description: The session was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/SessionSummary' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFoundSession' delete: summary: Deletes a specified pending session. operationId: deleteSession description: "> ### Permissions required\n `Control Resource`

\n And at least one of: `View Process Definition`\ \ | `Edit Process` | `Create Process`\n" tags: - Sessions parameters: - name: sessionId in: path description: The ID of the pending session to delete. required: true schema: type: string format: uuid responses: '204': description: The pending session was successfully deleted. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' patch: summary: Update the session for the given session ID. operationId: updateSession description: '> ### Permissions required At least one of: `Create Process` | `Edit Process` | `Execute Process`

and `Control Resource` ' tags: - Sessions parameters: - name: sessionId in: path description: The ID of the session to update. required: true schema: type: string format: uuid requestBody: description: Details of the session to update, only supports 'Running', 'Stopping' and 'Stopped' statuses. required: true content: application/json: schema: $ref: '#/components/schemas/UpdateSession' responses: '202': description: The session has been successfully updated. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/SessionForbidden' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/Conflict' /api/v7/sessions/{sessionId}/parameters: get: summary: Get start-up parameters for a specified session. operationId: getSessionStartUpParameters description: '> ### Permissions required At least one of: `Create Process` | `Edit Process` | `Export Process` | `Execute Process` | `View Process Definition`

And at least one of: `View Resource` | `View Resource Screen Captures` | `Configure Resource` | `Control Resource` | `Manage Resource Access Rights` ' tags: - Sessions parameters: - name: sessionId in: path description: The ID of the session to retrieve start-up parameters for. required: true schema: type: string format: uuid responses: '200': description: Start-up parameters of the requested session were successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/SessionStartUpParameters' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' put: summary: Update start-up parameters for a specified session. operationId: updateSessionStartupParameters description: '> ### Permissions required At least one of: `Create Process` | `Edit Process` | `Execute Process`

and `Control Resource` ' tags: - Sessions parameters: - name: sessionId in: path description: The ID of the session to update start-up parameters for. required: true schema: type: string format: uuid requestBody: description: A start-up parameters for session. required: true content: application/json: schema: $ref: '#/components/schemas/SessionStartUpParameters' responses: '204': description: Associated parameters for a specific session were successfully updated. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/Conflict' /api/v7/sessions/{sessionId}/logs: get: summary: Return all logs for a specified session. operationId: getSessionLogs description: '> ### Permissions required At least one of: `Create Process` | `Delete Process` | `Edit Process` | `Edit Process Groups` | `Export Process` | `Execute Process` | `Execute Process as Web Service` | `View Process Definition` | `Manage Process Access Rights`

And at least one of: `View Resource` | `View Resource Screen Captures` | `Configure Resource` | `Control Resource` | `Manage Resource Access Rights`

and `Audit - Process Logs` ' tags: - Sessions parameters: - name: sessionId in: path description: The ID of the session to retrieve data for. required: true schema: type: string format: uuid - name: sortBy in: query description: The field that results should be sorted by and the direction they should be sorted in. required: false style: form explode: false schema: title: getSessionLogsSortBy type: string enum: - LogNumberAsc - LogNumberDesc - StageIdAsc - StageIdDesc - StageNameAsc - StageNameDesc - StageTypeAsc - StageTypeDesc - ProcessNameAsc - ProcessNameDesc - PageNameAsc - PageNameDesc - ObjectNameAsc - ObjectNameDesc - ActionNameAsc - ActionNameDesc - ResultAsc - ResultDesc - ResultTypeAsc - ResultTypeDesc - ResourceStartTimeAsc - ResourceStartTimeDesc - ResourceEndTimeAsc - ResourceEndTimeDesc - BluePrismMemoryAsc - BluePrismMemoryDesc - TargetAppIdAsc - TargetAppIdDesc - TargetMemoryAsc - TargetMemoryDesc - name: logNumber in: query description: A filter to search for the log id/number. style: deepObject required: false schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: stageId in: query description: A filter to search for the id of the stage. required: false style: deepObject schema: $ref: '#/components/schemas/EqualsFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' - name: stageName in: query description: A filter to search for the name of the stage. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: stageType in: query description: A filter to search for the type of the stage. required: false style: form explode: false schema: type: array items: $ref: '#/components/schemas/StageType' - name: processName in: query description: A filter to search for the name of the process. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: pageName in: query description: A filter to search for the name of the page. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: objectName in: query description: A filter to search for the name of the object. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: actionName in: query description: A filter to search for the name of the action. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: result in: query description: A filter to search for the result. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: resultType in: query description: A filter to search for the type of the result. required: false style: form explode: false schema: type: array items: $ref: '#/components/schemas/ResultType' - name: resourceStartTime description: A filter to search for the time that the session started. in: query style: deepObject required: false schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: resourceEndTime description: A filter to search for the time that the ended started. in: query style: deepObject required: false schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: bluePrismMemory in: query description: A filter to search for the blue prism memory. style: deepObject required: false schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: targetAppId in: query description: A filter to search for the target app id. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: targetMemory in: query description: A filter to search for the target memory. style: deepObject required: false schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: itemsPerPage in: query description: The maximum number of items to retrieve per page. schema: type: integer minimum: 1 - name: pagingToken in: query description: The token to point to the last item previously returned. schema: type: string responses: '200': description: A list of session logs was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/SessionLogsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/sessions/{sessionId}/logslight: get: summary: Return fewer logs fields (logid,startdatetime,starttimezoneoffset,stagetype,objectname,actionname,processname,pagename,stagename,result,resulttype,attributexml and logNumber) for a specified session in apis calls. operationId: getSessionLogsLight description: '> ### Permissions required At least one of: `Create Process` | `Delete Process` | `Edit Process` | `Edit Process Groups` | `Export Process` | `Execute Process` | `Execute Process as Web Service` | `View Process Definition` | `Manage Process Access Rights`

And at least one of: `View Resource` | `View Resource Screen Captures` | `Configure Resource` | `Control Resource` | `Manage Resource Access Rights`

and `Audit - Process Logs` ' tags: - Sessions parameters: - name: sessionId in: path description: The ID of the session to retrieve data for. required: true schema: type: string format: uuid - name: sortBy in: query description: The field that results should be sorted by and the direction they should be sorted in. required: false style: form explode: false schema: title: getSessionLogsSortBy type: string enum: - LogNumberAsc - LogNumberDesc - StageIdAsc - StageIdDesc - StageNameAsc - StageNameDesc - StageTypeAsc - StageTypeDesc - ProcessNameAsc - ProcessNameDesc - PageNameAsc - PageNameDesc - ObjectNameAsc - ObjectNameDesc - ActionNameAsc - ActionNameDesc - ResultAsc - ResultDesc - ResultTypeAsc - ResultTypeDesc - ResourceStartTimeAsc - ResourceStartTimeDesc - ResourceEndTimeAsc - ResourceEndTimeDesc - BluePrismMemoryAsc - BluePrismMemoryDesc - TargetAppIdAsc - TargetAppIdDesc - TargetMemoryAsc - TargetMemoryDesc - name: logNumber in: query description: A filter to search for the log id/number. style: deepObject required: false schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: stageId in: query description: A filter to search for the id of the stage. required: false style: deepObject schema: $ref: '#/components/schemas/EqualsFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' - name: stageName in: query description: A filter to search for the name of the stage. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: stageType in: query description: A filter to search for the type of the stage. required: false style: form explode: false schema: type: array items: $ref: '#/components/schemas/StageType' - name: processName in: query description: A filter to search for the name of the process. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: pageName in: query description: A filter to search for the name of the page. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: objectName in: query description: A filter to search for the name of the object. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: actionName in: query description: A filter to search for the name of the action. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: result in: query description: A filter to search for the result. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: resultType in: query description: A filter to search for the type of the result. required: false style: form explode: false schema: type: array items: $ref: '#/components/schemas/ResultType' - name: resourceStartTime description: A filter to search for the time that the session started. in: query style: deepObject required: false schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: resourceEndTime description: A filter to search for the time that the ended started. in: query style: deepObject required: false schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: bluePrismMemory in: query description: A filter to search for the blue prism memory. style: deepObject required: false schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: targetAppId in: query description: A filter to search for the target app id. required: false style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: targetMemory in: query description: A filter to search for the target memory. style: deepObject required: false schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: itemsPerPage in: query description: The maximum number of items to retrieve per page. schema: type: integer minimum: 1 - name: pagingToken in: query description: The token to point to the last item previously returned. schema: type: string responses: '200': description: A list of session logs was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/SessionLogsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/sessions/{sessionId}/logs/{logId}/parameters: get: summary: Return all parameters for a specified session log. operationId: getSessionLogParameters description: '> ### Permissions required At least one of: `Create Process` | `Delete Process` | `Edit Process` | `Edit Process Groups` | `Export Process` | `Execute Process` | `Execute Process as Web Service` | `View Process Definition` | `Manage Process Access Rights`

And at least one of: `View Resource` | `View Resource Screen Captures` | `Configure Resource` | `Control Resource` | `Manage Resource Access Rights`

and `Audit - Process Logs` ' tags: - Sessions parameters: - name: sessionId in: path description: The ID of the session to retrieve data for. required: true schema: type: string format: uuid - name: logId in: path description: The ID of the log to retrieve for the session. required: true schema: type: integer minimum: 1 responses: '200': description: A list of session log parameters was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/SessionLogParametersResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/subscriptions/{subscriptionId}: patch: summary: Update the subscription for the given subscription ID. operationId: updatesubscription description: '> ### Permissions required At least one of: `Full Access to webhooks` ' tags: - Subscriptions parameters: - name: subscriptionId in: path description: The ID of the subscription to update. required: true schema: type: string format: uuid requestBody: content: application/json: schema: $ref: '#/components/schemas/PatchRequest' examples: null replace: $ref: '#/components/examples/PatchReplaceExample' responses: '202': description: The session has been successfully updated. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/timezones: get: summary: Return a list of time zones. operationId: getTimezones tags: - Time Zones responses: '200': description: A list of time zones was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/TimeZones' '401': $ref: '#/components/responses/NotAuthorized' /api/v7/user/permissions: get: summary: Return a list of permissions for the currently authenticated user. operationId: getPermissionsForUser tags: - User responses: '200': description: A list of user permissions was successfully retrieved. content: application/json: schema: type: array items: type: string example: - Permission_1 - Permission_2 - Permission_3 '401': $ref: '#/components/responses/NotAuthorized' /api/v7/workqueues: get: summary: Return a list of work queues in the environment. operationId: getWorkqueues description: '> ### Permissions required At least one of: `Read Access to Queue Management` | `Full Access to Queue Management` ' tags: - Work Queues parameters: - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query required: false schema: type: string enum: - NameAsc - NameDesc - StatusAsc - StatusDesc - KeyFieldAsc - KeyFieldDesc - MaxAttemptsAsc - MaxAttemptsDesc - IsEncryptedAsc - IsEncryptedDesc - TotalItemCountAsc - TotalItemCountDesc - CompletedItemCountAsc - CompletedItemCountDesc - PendingItemCountAsc - PendingItemCountDesc - LockedItemCountAsc - LockedItemCountDesc - ExceptionedItemCountAsc - ExceptionedItemCountDesc - TotalCaseDurationAsc - TotalCaseDurationDesc - AverageWorkTimeAsc - AverageWorkTimeDesc - name: name description: A filter to search for the name of the work queue. in: query style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: keyField description: A filter to search for the name of the work queue's key field. in: query style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: status.eq description: A filter to search for the current status of the work queue. in: query schema: $ref: '#/components/schemas/QueueStatus' - name: maxAttempts description: A filter to search for the configured maximum attempts of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: pendingItemCount description: A filter to search for the pending item count of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: lockedItemCount description: A filter to search for the locked item count of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: completedItemCount description: A filter to search for the completed item count of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: exceptionedItemCount description: A filter to search for the exceptioned item count of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: totalItemCount description: A filter to search for the total item count of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: averageWorkTime description: A filter to search for the average work time of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/TimeEqualsExample' range: $ref: '#/components/examples/TimeRangeExample' greater: $ref: '#/components/examples/TimeLessThanExample' - name: totalCaseDuration description: A filter to search for the total case duration of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/TimeEqualsExample' range: $ref: '#/components/examples/TimeRangeExample' greater: $ref: '#/components/examples/TimeLessThanExample' - name: itemsPerPage description: The maximum number of items to retrieve per page. in: query schema: type: integer minimum: 1 - name: pagingToken description: The token to point to the last item previously returned. in: query schema: type: string responses: '200': description: A list of work queue summaries was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/WorkQueuesItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' post: summary: Create a new work queue. operationId: createWorkQueue description: '> ### Permissions required For creating work queue: `Workflow - Work Queue Configuration`
For creating active work queue: `Workflow - Work Queue Configuration` and `Control Resource` and at least one of: `Create Process` | `Edit Process` | `Execute Process` > This endpoint does not support application server-based encryption keys. Only database-based encryption keys can be used. ' tags: - Work Queues requestBody: description: Details of the queue to create. required: true content: application/json: schema: $ref: '#/components/schemas/CreateWorkQueue' responses: '201': description: The work queue was successfully created. content: application/json: schema: $ref: '#/components/schemas/Identifier' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '409': description: A work queue with this name already exists. content: application/json: schema: $ref: '#/components/schemas/Error' /api/v7/workqueues/light: get: summary: Return fewer information about work queue(all fields except work queue configuration and sessionexceptionretry). operationId: getWorkqueuesLight description: '> ### Permissions required At least one of: `Read Access to Queue Management` | `Full Access to Queue Management` ' tags: - Work Queues parameters: - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query required: false schema: type: string enum: - NameAsc - NameDesc - StatusAsc - StatusDesc - KeyFieldAsc - KeyFieldDesc - MaxAttemptsAsc - MaxAttemptsDesc - IsEncryptedAsc - IsEncryptedDesc - TotalItemCountAsc - TotalItemCountDesc - CompletedItemCountAsc - CompletedItemCountDesc - PendingItemCountAsc - PendingItemCountDesc - LockedItemCountAsc - LockedItemCountDesc - ExceptionedItemCountAsc - ExceptionedItemCountDesc - TotalCaseDurationAsc - TotalCaseDurationDesc - AverageWorkTimeAsc - AverageWorkTimeDesc - name: name description: A filter to search for the name of the work queue. in: query style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: keyField description: A filter to search for the name of the work queue's key field. in: query style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: status.eq description: A filter to search for the current status of the work queue. in: query schema: $ref: '#/components/schemas/QueueStatus' - name: maxAttempts description: A filter to search for the configured maximum attempts of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: pendingItemCount description: A filter to search for the pending item count of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: lockedItemCount description: A filter to search for the locked item count of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: completedItemCount description: A filter to search for the completed item count of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: exceptionedItemCount description: A filter to search for the exceptioned item count of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: totalItemCount description: A filter to search for the total item count of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: averageWorkTime description: A filter to search for the average work time of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/TimeEqualsExample' range: $ref: '#/components/examples/TimeRangeExample' greater: $ref: '#/components/examples/TimeLessThanExample' - name: totalCaseDuration description: A filter to search for the total case duration of the work queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/TimeEqualsExample' range: $ref: '#/components/examples/TimeRangeExample' greater: $ref: '#/components/examples/TimeLessThanExample' - name: itemsPerPage description: The maximum number of items to retrieve per page. in: query schema: type: integer minimum: 1 - name: pagingToken description: The token to point to the last item previously returned. in: query schema: type: string responses: '200': description: A list of work queue summaries was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/WorkQueuesItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/workqueues/configurations: get: summary: Return configuration(id, name, assignedProcessId, assignedResourceGroupId and activeQueueStats) for each active work queue. operationId: getWorkQueueConfiguration description: '> ### Permissions required At least one of: `Read Access to Queue Management` | `Full Access to Queue Management` ' tags: - Work Queues parameters: - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query required: false schema: type: string enum: - NameAsc - NameDesc - name: name description: A filter to search for the name of the work queue configuration. in: query style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: itemsPerPage description: The maximum number of items to retrieve per page. in: query schema: type: integer minimum: 1 - name: pagingToken description: The token to point to the last item previously returned. in: query schema: type: string responses: '200': description: A list of work queue configurations was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/WorkQueueConfigurationsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/workqueues/{workQueueId}: get: summary: Return details of a work queue. operationId: getWorkQueue description: '> ### Permissions required At least one of: `Read Access to Queue Management` | `Full Access to Queue Management` ' tags: - Work Queues parameters: - name: workQueueId in: path description: The ID of the queue to retrieve details for. required: true schema: type: string format: uuid responses: '200': description: The work queue details were successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/WorkQueueSummary' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' patch: summary: Modify the work queue as described in the patch document. operationId: updateWorkQueue description: '> ### Permissions required At least one of: `Read Access to Queue Management` | `Full Access to Queue Management`

and `Workflow - Work Queue Configuration` > This endpoint does not support application server-based encryption keys. Only database-based encryption keys can be used. ' tags: - Work Queues parameters: - name: workQueueId in: path description: The ID of the queue to modify. required: true schema: type: string format: uuid requestBody: content: application/json: schema: $ref: '#/components/schemas/PatchRequest' examples: add (to array): $ref: '#/components/examples/PatchAddToArrayExample' add (to object): $ref: '#/components/examples/PatchAddToObjectExample' copy: $ref: '#/components/examples/PatchCopyExample' move: $ref: '#/components/examples/PatchMoveExample' remove: $ref: '#/components/examples/PatchRemoveExample' replace: $ref: '#/components/examples/PatchReplaceExample' responses: '204': description: The work queue was successfully updated. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' delete: summary: Delete a specified work queue. operationId: deleteWorkQueue description: '> ### Permissions required: `Workflow - Work Queue Configuration` ' tags: - Work Queues parameters: - name: workQueueId in: path description: The ID of the queue to delete. required: true schema: type: string format: uuid responses: '204': description: The queue was successfully deleted. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': description: Either the queue is not empty or still has running sessions. content: application/json: schema: $ref: '#/components/schemas/Error' /api/v7/workqueues/{workQueueId}/references: get: summary: Return references to a specified work queue. operationId: getWorkQueueReferences description: '> ### Permissions required: `Workflow - Work Queue Configuration` ' tags: - Work Queues parameters: - name: workQueueId description: The ID of the queue to get references of. in: path required: true schema: type: string format: uuid - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query schema: type: string enum: - NameAsc - NameDesc - DescriptionAsc - DescriptionDesc - ProcessTypeAsc - ProcessTypeDesc - name: itemsPerPage description: The maximum number of items to retrieve. in: query schema: type: integer minimum: 1 - name: pagingToken description: The token to point to the last item previously returned. in: query schema: type: string - name: name description: A filter to search for the name of the reference. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: description in: query style: deepObject description: A filter to search for the description of the reference. schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: processType in: query style: form explode: false description: The type of the process to search for. schema: type: array items: type: string enum: - Process - Object responses: '200': description: An list of queue references was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/ReferencesItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/workqueues/{workQueueId}/items: get: summary: Return items in a specified work queue. operationId: getWorkQueueItems description: '> ### Permissions required At least one of: `Read Access to Queue Management` | `Full Access to Queue Management` > ### Additional permissions for accessing Active Queue items At least one of: `Create Process` | `Edit Process` | `Execute Process` And `Control Resource` ' tags: - Work Queues parameters: - name: workQueueId description: The ID of the queue to get an item from. in: path required: true schema: type: string format: uuid - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query required: false schema: type: string enum: - AttemptAsc - AttemptDesc - AttemptWorkTimeAsc - AttemptWorkTimeDesc - CompletedAsc - CompletedDesc - DeferredAsc - DeferredDesc - ExceptionAsc - ExceptionDesc - ExceptionReasonAsc - ExceptionReasonDesc - KeyValueAsc - KeyValueDesc - LastUpdatedAsc - LastUpdatedDesc - LoadedAsc - LoadedDesc - LockedAsc - LockedDesc - PriorityAsc - PriorityDesc - StatusAsc - StatusDesc - WorkTimeAsc - WorkTimeDesc - SlaAsc - SlaDesc - SlaDateTimeAsc - SlaDateTimeDesc - ProcessNameAsc - ProcessNameDesc - IsSuggestedAsc - IsSuggestedDesc - name: keyValue description: A filter to search for the value of the key field of the work queue item. in: query schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: status description: A filter to search for the status of the work queue item. in: query schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: state description: A filter to search for the current state of the work queue item. in: query style: form explode: false schema: type: array items: type: string enum: - Pending - Locked - Deferred - Completed - Exceptioned - name: totalWorkTime description: A filter to search for the total work time of the work queue item. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/TimeEqualsExample' range: $ref: '#/components/examples/TimeRangeExample' greater: $ref: '#/components/examples/TimeLessThanExample' - name: loadedDate description: A filter to search for the time the work queue item was loaded onto the queue. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: deferredDate description: A filter to search for the time the work queue item is deferred until. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: lockedDate description: A filter to search for the time the work queue item was locked. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: completedDate description: A filter to search for the time the work queue item was completed. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: exceptionedDate description: A filter to search for the time the work queue item exceptioned. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: lastUpdated description: A filter to search for the time the work queue item was last updated. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: attempt description: A filter to search for the current attempt number of the work queue item. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: priority description: A filter to search for the priority of the work queue item. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: exceptionReason description: A filter to search for the reason that the work queue item exceptioned. in: query schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' contains: $ref: '#/components/examples/StringContainsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: slaDateTime description: A filter to search for the sla time the work queue item. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: processName description: A filter to search for the process name of the work queue item. in: query schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: sla description: A filter to search for the sla time of the work queue item. in: query schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/TimeEqualsExample' range: $ref: '#/components/examples/TimeRangeExample' greater: $ref: '#/components/examples/TimeLessThanExample' - name: withinSla in: query description: Flag to get work queue items within sla time. schema: type: boolean - name: isSuggested in: query description: A filter to search the work queue items which is used to help troubleshoot issues. schema: $ref: '#/components/schemas/EqualsFilter' - name: itemsPerPage description: The maximum number of items to retrieve per page. in: query schema: type: integer - name: pagingToken description: The token to point to the last item previously returned. in: query schema: type: string responses: '200': description: An list of queue items was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/WorkQueueItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' post: deprecated: true summary: Create work queue item(s). operationId: createWorkQueueItem description: '> ### Permissions required: `Full Access to Queue Management` > ### Additional permissions for accessing Active Queue items At least one of: `Create Process` | `Edit Process` | `Execute Process` And `Control Resource` ' tags: - Work Queues parameters: - name: workQueueId in: path description: The ID of the queue to insert into. required: true schema: type: string format: uuid requestBody: description: Details of the queue items to create. required: true content: application/json: schema: $ref: '#/components/schemas/CreateWorkQueueItems' responses: '201': description: The item was successfully added content: application/json: schema: $ref: '#/components/schemas/Identifiers' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/workqueues/{workQueueId}/items/batch: post: summary: Create work queue items. operationId: createWorkQueueItems description: '> ### Permissions required: `Full Access to Queue Management` > ### Additional permissions for accessing Active Queue items At least one of: `Create Process` | `Edit Process` | `Execute Process` And `Control Resource` > This endpoint does not support application server-based encryption keys. Only work queues that are not encrypted, or use database-based encryption keys can use this endpoint. ' tags: - Work Queues parameters: - name: workQueueId in: path description: The ID of the queue to insert into. required: true schema: type: string format: uuid requestBody: description: Details of the queue items to create. required: true content: application/json: schema: $ref: '#/components/schemas/CreateWorkQueueItems' responses: '201': description: The item was successfully added content: application/json: schema: $ref: '#/components/schemas/Identifiers' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/workqueues/items/{workQueueItemId}: get: deprecated: true summary: Return details of a specified item from a work queue. operationId: getWorkQueueItem description: '> ### Permissions required At least one of: `Read Access to Queue Management` | `Full Access to Queue Management` > ### Additional permissions for accessing Active Queue items At least one of: `Create Process` | `Edit Process` | `Execute Process` And `Control Resource` This endpoint does not support application server-based encryption keys. Only work queues that are not encrypted, or use database-based encryption keys can use this endpoint. ' tags: - Work Queues parameters: - name: workQueueItemId in: path description: The ID of the item to get. required: true schema: type: string format: uuid responses: '200': description: The specified work queue item was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/WorkQueueItem' '400': $ref: '#/components/responses/BadRequest' '404': $ref: '#/components/responses/NotFound' /api/v7/workqueues/{workQueueId}/items/{workQueueItemId}: get: summary: Return details of a specified item from a work queue. operationId: getWorkQueueItemFromWorkQueue description: '> ### Permissions required At least one of: `Read Access to Queue Management` | `Full Access to Queue Management`. > ### Additional permissions for accessing Active Queue item At least one of: `Create Process` | `Edit Process` | `Execute Process` And `Control Resource` > This endpoint does not support application server-based encryption keys. Only work queues that are not encrypted, or use database-based encryption keys can use this endpoint. ' tags: - Work Queues parameters: - name: workQueueId in: path description: The queue ID of the item to get. required: true schema: type: string format: uuid - name: workQueueItemId in: path description: The ID of the item to get. required: true schema: type: string format: uuid responses: '200': description: The specified work queue item was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/WorkQueueItem' '400': $ref: '#/components/responses/BadRequest' '404': $ref: '#/components/responses/NotFound' /api/v7/workqueues/{workQueueId}/items/{workQueueItemId}/attempts: get: summary: Returns all attempts for the given work queue item operationId: getWorkQueueItemAttempts description: '> ### Permissions required At least one of: `Read Access to Queue Management` | `Full Access to Queue Management`. > ### Additional permissions for accessing Active Queue item At least one of: `Create Process` | `Edit Process` | `Execute Process` And `Control Resource` ' tags: - Work Queues parameters: - name: workQueueId in: path description: The queue ID of the item to return attempts. required: true schema: type: string format: uuid - name: workQueueItemId in: path description: The ID of the item to return attempts. required: true schema: type: string format: uuid responses: '200': description: A collection of work queue items. content: application/json: schema: type: array items: $ref: '#/components/schemas/WorkQueueItemNoData' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' post: summary: Creates a new work queue item attempt by forcing an item to retry. operationId: createWorkQueueItemAttempt description: '> ### Permissions required: `Full Access to Queue Management` ' tags: - Work Queues parameters: - name: workQueueId in: path description: The queue ID of the item to force retry. required: true schema: type: string format: uuid - name: workQueueItemId in: path description: The ID of the item to force retry. required: true schema: type: string format: uuid responses: '201': description: The work queue item attempt was successfully created. content: application/json: schema: $ref: '#/components/schemas/CreateWorkQueueItemAttemptResponseModel' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/workqueues/{workQueueId}/items/{workQueueItemId}/attempts/{attemptId}: delete: summary: Deletes a worked queue item. operationId: deleteWorkQueueItemAttempt description: '> ### Permissions required: `Full Access to Queue Management` ' tags: - Work Queues parameters: - name: workQueueId in: path description: The queue ID of the item to delete. required: true schema: type: string format: uuid - name: workQueueItemId in: path description: The ID of the item to delete. required: true schema: type: string format: uuid - name: attemptId in: path description: The ID of the attempt of the work queue item to delete required: true schema: type: number responses: '204': description: The worked queue item was successfully deleted. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' patch: summary: Modify the work queue item as described in the patch document. operationId: updateWorkQueueItemAttempt description: '> ### Permissions required: `Full Access to Queue Management` ' tags: - Work Queues parameters: - name: workQueueId in: path description: The queue ID of the item to update. required: true schema: type: string format: uuid - name: workQueueItemId in: path description: The ID of the item to update. required: true schema: type: string format: uuid - name: attemptId in: path description: The ID of the attempt of the work queue item to update required: true schema: type: number requestBody: content: application/json: schema: $ref: '#/components/schemas/PatchRequest' examples: replace: $ref: '#/components/examples/PatchReplaceExample' responses: '204': description: The work queue item was successfully updated. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/workqueues/{workQueueId}/items/{workQueueItemId}/callbacks: post: summary: Creates a new work queue web hook item . operationId: CreateWebHookWorkQueueItem description: '> ### Permissions required: At least one of: `Read Access to Queue Management` | `Full Access to Queue Management` And `Full Access to webhooks` ' tags: - Work Queues parameters: - name: workQueueId in: path description: The queue ID of the item. required: true schema: type: string format: uuid - name: workQueueItemId in: path description: The ID of the item. required: true schema: type: string format: uuid requestBody: description: Details of the webhook subscriptions to create. required: true content: application/json: schema: $ref: '#/components/schemas/CreateWebhookWorkQueueItem' responses: '201': description: The work queue webhook item was successfully created. content: application/json: schema: oneOf: - $ref: '#/components/schemas/WorkQueueItemWebhookSubscriptionResponse' - $ref: '#/components/schemas/WorkQueueItemSubscriptionCustomResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/workqueuegroups/{identifier}: get: summary: Return details of a work queue group. operationId: getWorkQueueGroup description: '> ### Permissions required: `Workflow - Work Queue Configuration` ' tags: - Work Queue Groups parameters: - name: identifier in: path description: It can be 'root' value to get a root group or the ID of the work queue group to retrieve details for. required: true schema: type: string format: uuid or "root" responses: '200': description: The work queue group details were successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/WorkQueueGroup' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' patch: summary: Modify the work queue group as described in the patch document. operationId: updateWorkQueueGroup description: '> ### Permissions required: `Workflow - Work Queue Configuration` ' tags: - Work Queue Groups parameters: - name: identifier in: path description: The ID of the work queue group to update. required: true schema: type: string format: uuid or "root" requestBody: content: application/json: schema: $ref: '#/components/schemas/PatchRequest' examples: replace: $ref: '#/components/examples/PatchReplaceExample' responses: '204': description: The work queue group was successfully updated. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/workqueuegroups: post: summary: Creates a work queue group. operationId: createWorkQueueGroup description: '> ### Permissions required: `Workflow - Work Queue Configuration` ' tags: - Work Queue Groups requestBody: description: Details of the group to create. required: true content: application/json: schema: $ref: '#/components/schemas/CreateWorkQueueGroup' responses: '201': description: The work queue group was successfully created. content: application/json: schema: $ref: '#/components/schemas/CreateWorkQueueGroupResponseModel' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/workqueuegroups/{workQueueGroupId}: delete: summary: Deletes a work queue group. operationId: deleteWorkQueueGroup description: '> ### Permissions required: `Workflow - Work Queue Configuration` ' tags: - Work Queue Groups parameters: - name: workQueueGroupId in: path description: The ID of the work queue group to delete. required: true schema: type: string format: uuid responses: '204': description: The work queue group was successfully deleted. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/workqueuegroups/{identifier}/items: get: summary: Return a list of work queues belonging to a work queue group. operationId: getWorkQueuesInGroup description: '> ### Permissions required: `Workflow - Work Queue Configuration` ' tags: - Work Queue Groups parameters: - name: identifier in: path description: It can be a 'root' value to get work queues from the root queue group or the ID of the work queue group to retrieve work queues from it. required: true schema: type: string format: uuid or "root" - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query required: false schema: type: string enum: - NameAsc - NameDesc - name: itemsPerPage description: The maximum number of items to retrieve per page. in: query schema: type: integer minimum: 1 - name: pagingToken description: The token to point to the last item previously returned. in: query schema: type: string - name: name description: A filter to search for the name of items inside work queue group. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' responses: '200': description: The work queue group work queues were successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/WorkQueuesFromGroupItemsPage' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/workqueuegroups/{identifier}/childgroups: get: summary: Return details of child groups of work queue group. operationId: getChildGroupsInWorkQueueGroup description: '> ### Permissions required: `Workflow - Work Queue Configuration` ' tags: - Work Queue Groups parameters: - name: identifier in: path description: It can be a 'root' value to get details of groups from the root or the ID of the parent work queue group to retrieve details of child groups. required: true schema: type: string format: uuid or "root" - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query schema: type: string enum: - NameAsc - NameDesc - HasChildGroupsAsc - HasChildGroupsDesc - HasChildItemsAsc - HasChildItemsDesc - name: itemsPerPage description: The maximum number of items to retrieve per page. in: query schema: type: integer minimum: 1 - name: pagingToken description: The token to point to the last item previously returned. in: query schema: type: string - name: name description: A filter to search for the name of the queue group. in: query style: deepObject schema: $ref: '#/components/schemas/BasicStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: hasChildGroups in: query style: form explode: false description: The availability of child groups in the group. schema: type: array items: type: string enum: - 'true' - 'false' - name: hasChildItems in: query style: form explode: false description: The availability of child items in the group. schema: type: array items: type: string enum: - 'true' - 'false' responses: '200': description: The work child groups details were successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/WorkQueueChildGroups' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' /api/v7/licenses: get: summary: Return a list of licenses. operationId: getLicenses description: '> ### Permissions required: `System - License permission` ' tags: - Licenses parameters: - name: pagingToken description: The token to point to the last item previously returned. in: query schema: type: string - name: itemsPerPage description: The maximum number of items to retrieve per page. in: query schema: type: integer minimum: 1 - name: sortBy description: The field that results should be sorted by and the direction they should be sorted in. in: query schema: type: string enum: - LicenseIdAsc - LicenseIdDesc - StatusAsc - StatusDesc - ActivationStatusAsc - ActivationStatusDesc - OwnerAsc - OwnerDesc - TypeAsc - TypeDesc - StartsAsc - StartsDesc - ExpiresAsc - ExpiresDesc - ProcessesAsc - ProcessesDesc - SessionsAsc - SessionsDesc - ResourcesAsc - ResourcesDesc - AlertsAsc - AlertsDesc - StandaloneAsc - StandaloneDesc - DecipherIDPAsc - DecipherIDPDesc - name: status in: query style: form explode: false description: The status of the license to search for. schema: type: array items: type: string enum: - Future - Expired - ExpiresSoon - GracePeriodEndsSoon - RequiresActivation - Active - name: activationStatus in: query style: form explode: false description: The activation status of the license to search for. schema: type: array items: type: string enum: - NotApplicable - NotActivated - Activated - name: type in: query style: form explode: false description: The type of the license to search for. schema: type: array items: type: string enum: - None - Enterprise - NHS - Evaluation - Education - Desktop - name: owner description: A filter to search for the owner of the license. in: query style: deepObject schema: $ref: '#/components/schemas/FullStringFilter' examples: equals: $ref: '#/components/examples/StringEqualsExample' startsWith: $ref: '#/components/examples/StringStartsWithExample' contains: $ref: '#/components/examples/StringContainsExample' range: $ref: '#/components/examples/StringRangeExample' greater: $ref: '#/components/examples/StringGreaterThanExample' - name: starts in: query style: deepObject description: A filter to search for the date that the license starts. schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: expires in: query style: deepObject description: A filter to search for the date that the license expires. schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/DateTimeEqualsExample' range: $ref: '#/components/examples/DateTimeRangeExample' greater: $ref: '#/components/examples/DateTimeGreaterThanExample' - name: processes description: A filter to search for the number of processes that may be published. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: sessions description: A filter to search for the number of sessions which may be run. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: resources description: A filter to search for the number of runtime resources which may be registered at any one time. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: alerts description: A filter to search for the number of machines on which Process Alerts may be used. in: query style: deepObject schema: $ref: '#/components/schemas/RangeOrEqualFilter' examples: equals: $ref: '#/components/examples/IntegerEqualsExample' range: $ref: '#/components/examples/IntegerRangeExample' less: $ref: '#/components/examples/IntegerLessThanExample' - name: standalone.eq description: A filter to check availability of license standalone. in: query schema: type: boolean - name: decipherIDP.eq description: A filter to check availability of license decipherIDP. in: query schema: type: boolean responses: '200': description: A list of licenses was successfully retrieved. content: application/json: schema: $ref: '#/components/schemas/LicensesItemsPage' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' post: summary: Add a license. operationId: createLicense description: '> ### Permissions required: `System - License permission` ' tags: - Licenses requestBody: description: Encoded license key. required: true content: application/json: schema: $ref: '#/components/schemas/AddLicense' responses: '201': description: The license was successfully added. content: application/json: schema: $ref: '#/components/schemas/AddLicenseResponseModel' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' /api/v7/licenses/{licenseId}: delete: summary: Delete a specified license. operationId: deleteLicense description: '> ### Permissions required: `System - License permission ` ' tags: - Licenses parameters: - name: licenseId in: path description: The ID of the license to delete. required: true schema: type: integer responses: '204': description: The license was successfully deleted. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' components: securitySchemes: Bearer: type: http scheme: bearer description: JWT token issued from Authentication Server. bearerFormat: JWT OAuth2: type: oauth2 flows: clientCredentials: tokenUrl: https://auth-server/connect/token scopes: bp-api: API scope bpserver: Blue Prism Application scope responses: NotAuthorized: description: The authentication token was either missing or invalid and must be refreshed. content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' Forbidden: description: The authentication token does not give sufficient permissions to perform this action. content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' BadRequest: description: The request is malformed or contains incorrect information. See the response for more details. content: application/json: schema: oneOf: - $ref: '#/components/schemas/UrlParameterError' - $ref: '#/components/schemas/ValidationError' BadRequestErrorMessage: description: The request is malformed or contains incorrect information. See the response for more details. content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' NotFound: description: The requested resource could not be found. content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' NotFoundSession: description: The requested session could not be found. content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' Conflict: description: The request conflicts with the current state of the resource. content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' SessionForbidden: description: The user does not have execute permission for this action, or the number of sessions permitted by the current license would be exceeded. content: application/json: schema: $ref: '#/components/schemas/Error' schemas: DataCollection: description: Represents a Blue Prism collection. type: object properties: rows: description: A collection of rows representing the data contained within the collection. type: array items: $ref: '#/components/schemas/DataRow' RadioButtonsArray: description: Used for the RadioButtons data type. type: array items: type: object properties: name: type: string selected: type: boolean DataRow: description: A dictionary which represents a row of data from a Blue Prism collection. type: object additionalProperties: $ref: '#/components/schemas/DataValue' DataRowSchedule: description: A dictionary which represents a row of data from a Blue Prism collection. type: object additionalProperties: $ref: '#/components/schemas/DataValueSchedule' DataValue: description: Represents a single item of data in a Blue Prism format. type: object properties: valueType: description: The type of object contained in the value field. type: string enum: - Binary - Collection - Date - DateTime - Flag - Image - Number - Password - RadioButtons - Text - Time - TimeSpan value: description: The value of the object. nullable: true oneOf: - type: string format: base64 description: Used for Binary and Image data types. The image format must only be one of these BPM, JPG, JPEG, GIF, PNG, ICO or TIFF. - $ref: '#/components/schemas/DataCollection' description: Used for the Collection data type. - type: string format: date description: Used for Date and Time data types. - type: boolean description: Used for the Flag data type. - type: number description: Used for the Number data type. - type: string description: Used for Password and Text data types. - type: string format: time description: Used for the TimeSpan data type. - $ref: '#/components/schemas/RadioButtonsArray' additionalParameters: description: Custom extra parameters i.e. Binary's file path. type: array items: type: string DataValueSchedule: description: Represents a single item of data in a Blue Prism format. type: object properties: valueType: description: The type of object contained in the value field. type: string enum: - Binary - Date - DateTime - Flag - Image - Number - Password - Text - Time - TimeSpan value: description: The value of the object. oneOf: - type: string format: base64 description: Used for Binary and Image data types. - type: string format: date description: Used for Date and Time data types. - type: boolean description: Used for the Flag data type. - type: number description: Used for the Number data type. - type: string description: Used for Password and Text data types. - type: string format: time description: Used for the TimeSpan data type. CreateScheduleDefinitionResponseModel: description: Contains the ID of a schedule. type: object properties: id: type: integer description: The ID of the schedule. ScheduleDefinitionResponseModel: description: Contains the details of a Schedule. type: object properties: id: type: integer description: The ID of the schedule. name: type: string description: The name of the schedule. description: type: string description: The description of the schedule. initialTaskId: type: integer description: The ID of the initial task this schedule executes. initialTaskName: type: string description: The Name of the initial task this schedule executes. isRetired: type: boolean description: If the schedule is retired or not. tasksCount: type: integer description: The number of tasks a schedule has. intervalType: type: string description: The type of interval the schedule runs at. enum: - Once - Minute - Hour - Day - Week - Month - Year startDate: type: string description: The earliest date the schedule will run. format: date-time endDate: type: string nullable: true description: The last date on which the schedule will run. If this value is null or missing, the schedule will run indefinitely. format: date-time timeZoneId: type: string nullable: true description: The ID of the time zone. adjustForDaylightSaving: type: boolean nullable: true description: Determines if to use daylight savings time when time one is a valid time zone ID. hourlyDetails: type: object nullable: true $ref: '#/components/schemas/HourlyMinutelyDetails' description: Hourly details that apply to the hour interval schedule type. minutelyDetails: type: object nullable: true $ref: '#/components/schemas/HourlyMinutelyDetails' description: Minute details that apply to the minute interval schedule type. dailyDetails: type: object nullable: true $ref: '#/components/schemas/DailyDetails' description: Daily details that apply to the daily interval schedule type. weeklyDetails: type: object nullable: true $ref: '#/components/schemas/WeeklyDetails' description: Weekly details that apply to the weekly interval schedule type. monthlyDetails: type: object nullable: true $ref: '#/components/schemas/MonthlyDetails' description: Monthly details that apply to the monthly interval schedule type. yearlyDetails: type: object nullable: true $ref: '#/components/schemas/YearlyDetails' description: Yearly details that apply to the yearly interval schedule type. UpdateScheduleDetails: description: Contains the details of a schedule. allOf: - type: object properties: name: type: string description: The name of the schedule. - $ref: '#/components/schemas/ScheduleDetails' CloneScheduleDetails: description: Contains the details of a schedule. allOf: - type: object properties: name: type: string description: The name of the schedule. required: - name - $ref: '#/components/schemas/ScheduleDetails' ScheduleDetailsOptionalName: description: Contains the details of a schedule. allOf: - type: object properties: name: type: string description: The name of the schedule. - $ref: '#/components/schemas/ScheduleDetails' ScheduleDetails: description: Contains the details of a schedule. type: object properties: description: type: string description: The description of the schedule. initialTaskId: type: integer nullable: true description: The ID of the initial task this schedule executes. intervalType: type: string description: The type of interval the schedule runs at. enum: - Once - Minute - Hour - Day - Week - Month - Year startDate: type: string description: The earliest date the schedule will run. format: date-time endDate: type: string nullable: true description: The last date on which the schedule will run. If this value is null or missing then the schedule will run indefinitely. format: date-time timeZoneId: type: string nullable: true description: The ID of the time zone. adjustForDaylightSaving: type: boolean nullable: true description: Determines if to use daylight savings time when time zone is a valid time zone ID. minutelyDetails: type: object nullable: true $ref: '#/components/schemas/HourlyMinutelyDetails' description: Minute details that apply to the minute interval schedule type. hourlyDetails: type: object nullable: true $ref: '#/components/schemas/HourlyMinutelyDetails' description: Hourly details that apply to the hour interval schedule type. dailyDetails: type: object nullable: true $ref: '#/components/schemas/DailyDetails' description: Daily details that apply to the daily interval schedule type. weeklyDetails: type: object nullable: true $ref: '#/components/schemas/WeeklyDetails' description: Weekly details that apply to the weekly interval schedule type. monthlyDetails: type: object nullable: true $ref: '#/components/schemas/MonthlyDetails' description: Monthly details that apply to the monthly interval schedule type. yearlyDetails: type: object nullable: true $ref: '#/components/schemas/YearlyDetails' description: Yearly details that apply to the yearly interval schedule type. MonthlyDetails: description: Monthly details that apply to the monthly interval schedule type. type: object properties: period: type: integer description: The schedule frequency. type: type: string description: The type of monthly interval. enum: - NthDay - NthWeekDay - NthWorkingDay missingDateAction: type: string nullable: true description: If startdate month day > 28, selects a substitute month day to execute schedule on (required when NthDay is selected). enum: - Skip - LastSupportedDayInMonth - FirstsupportedDayInNextMonth weekNumber: type: string nullable: true description: Which week number to repeat the schedule on (required when NthWeekDay is selected). enum: - First - Second - Third - Fourth - Fifth - Last weekDay: type: string nullable: true description: Which weekday to repeat the schedule on (required when NthWeekDay is selected). enum: - Sunday - Monday - Tuesday - Wednesday - Thursday - Friday - Saturday workingDay: type: string nullable: true description: Which working day the schedule will run on (required when NthWorkingDay is selected). enum: - First - Last calendarId: type: integer nullable: true description: The ID of the calendar to use (required when NthWorkingDay is selected). WeeklyDetails: description: Weekly details that apply to the weekly interval schedule type. type: object properties: period: type: integer description: The schedule frequency. type: type: string description: The type of weekly interval. enum: - WeekDay - WorkingDay weekDay: type: string nullable: true description: Which working day the schedule will run on. enum: - First - Last calendarId: type: integer nullable: true description: The ID of the calendar to use. YearlyDetails: description: Yearly details that apply to the yearly interval schedule type. type: object properties: period: type: integer description: The schedule frequency. DailyDetails: description: Daily details that apply to the daily interval schedule type. type: object properties: period: type: integer description: The schedule frequency. calendarId: type: integer nullable: true description: The ID of the calendar to use. HourlyMinutelyDetails: description: Hourly and minute details that apply to the hourly and minute interval schedule type. type: object properties: period: type: integer description: The schedule frequency (minutes or hours). start: type: string format: time description: The time of day from which the given schedule is active. end: type: string format: time description: The time of day until which the given schedule is active. calendarId: type: integer nullable: true description: The ID of the calendar to use. ScheduleSummary: description: Contains basic details of a session. type: object properties: id: type: integer description: The ID of the schedule. name: type: string description: The name of the schedule. description: type: string description: The description of the schedule. initialTaskId: type: integer description: The ID of the initial task this schedule executes. isRetired: type: boolean description: If the schedule is retired or not. tasksCount: type: integer description: The number of tasks a schedule has. intervalType: type: string description: The type of interval the schedule runs at. enum: - Once - Minute - Hour - Day - Week - Month - Year timePeriod: type: integer description: The time period to apply to the intervalType on which the schedule will run. This cannot be applied to an intervalType of "Once". For example, timePeriod "2" with intervalType "Day" will run the schedule every 2 days. startPoint: type: string description: The earliest time from which a schedule will run when the intervalType is set to "Day". format: date-time endPoint: type: string description: The latest time from which a schedule will run when the intervalType is set to "Day". format: date-time dayOfWeek: type: string nullable: true description: The day of the week that the schedule will run on when intervalType is "Week" or "Month". enum: - Sunday - Monday - Tuesday - Wednesday - Thursday - Friday - Saturday dayOfMonth: type: string description: The position of the specified day in the month on which a schedule will run. This should be combined with the dayOfWeek value. For example, the "Second Monday" in the month, or the "Third Friday" in the month. enum: - Last - None - First - Second - Third - Fourth - Fifth startDate: type: string nullable: true description: The earliest date the schedule will run. format: date-time endDate: type: string nullable: true description: The last date on which the schedule will run. If this value is null or missing, the schedule will run indefinitely. format: date-time calendarId: type: integer description: The ID of the calendar. calendarName: type: string description: The name of the calendar. example: id: 123 name: Example schedule description: A schedule for API example purposes. initialTaskId: 4 isRetired: false tasksCount: 3 intervalType: Hour timePeriod: 2 startPoint: '0001-01-01T09:00:00+01:00' endPoint: '0001-01-01T17:30:00+01:00' dayOfWeek: Tuesday dayOfMonth: First startDate: '2020-10-02T00:00:00Z' endDate: '2020-10-03T02:20:00Z' calendarId: 1 calendarName: Example calendar name ScheduleItemsPage: description: Contains details of a page of schedules. type: object properties: pagingToken: type: string description: The token to be used in the next request to return the next collection of items. items: type: array description: A collection of schedule summary. items: $ref: '#/components/schemas/ScheduleSummary' example: pagingToken: U3VwZXIgc2VjcmV0IGRhdGEuIFNoaGho items: - id: 123 name: Example schedule description: A schedule for API example purposes. initialTaskId: 4 isRetired: false tasksCount: 3 intervalType: Hour timePeriod: 2 startPoint: '0001-01-01T09:00:00+01:00' endPoint: '0001-01-01T17:30:00+01:00' dayOfWeek: Tuesday dayOfMonth: First startDate: '2020-10-02T00:00:00Z' endDate: '2020-10-03T02:20:00Z' calendarId: 1 calendarName: Example calendar name ScheduleLogItemsPage: description: Contains details of a page of schedule logs. type: object properties: pagingToken: type: string description: The token to be used in the next request to return the next collection of items. items: type: array description: A collection of schedule log summary items: $ref: '#/components/schemas/ScheduleLogSummary' example: pagingToken: U3VwZXIgc2VjcmV0IGRhdGEuIFNoaGho items: - scheduleLogId: 1 startTime: '2019-08-27T14:15:22Z' endTime: '2019-08-27T14:15:22Z' duration: 00:01:23 status: pending serverName: Example server scheduleId: 1 scheduleName: Example schedule ScheduleLogSummary: description: Contains basic details about a schedule log. type: object properties: scheduleLogId: type: integer description: The ID of the schedule log. startTime: type: string format: date-time description: The start time of the schedule. endTime: type: string format: date-time description: The end time of the schedule. duration: type: string format: time-span description: The duration of the schedule. status: type: string description: The current status of the schedule. enum: - pending - running - terminated - completed - partExceptioned serverName: type: string description: The name of the application server this schedule instance ran on. scheduleId: type: integer description: The ID of the schedule. scheduleName: type: string description: The name of the schedule. ScheduleLogDeprecatedItemsPage: description: Contains details of a page of schedule logs. type: object properties: pagingToken: type: string description: The token to be used in the next request to return the next collection of items. items: type: array description: A collection of schedule log summary items: $ref: '#/components/schemas/ScheduleLogDeprecatedSummary' ScheduleLogDeprecatedSummary: description: Contains basic details about a schedule log. type: object properties: scheduleLogId: type: integer description: The ID of the schedule log. startTime: type: string format: date-time description: The start time of the schedule. endTime: type: string format: date-time description: The end time of the schedule. status: type: string description: The current status of the schedule. enum: - pending - running - terminated - completed - partExceptioned serverName: type: string description: The name of the application server this schedule instance ran on. scheduleId: type: integer description: The ID of the schedule. scheduleName: type: string description: The name of the schedule. CreateSession: description: Contains details for creating a new session. type: object properties: processId: type: string description: The ID of the process to run in the session. format: uuid parameters: type: array description: Parameters to pass to the session. items: $ref: '#/components/schemas/DataValue' UpdateSession: description: Contains details for updating a session. type: object properties: status: type: string description: The status of the session. enum: - Pending - Running - Stopped - Terminated - Completed - Stopping - Warning SessionDetails: description: Contains details of a session. type: object properties: sessionId: type: string description: The ID of the session. processId: type: string description: The ID of the process in the session. format: uuid status: type: string description: The current status of the session. enum: - Pending - Running - Stopped - Terminated parameters: type: array description: Parameters to pass to the session. items: $ref: '#/components/schemas/DataValue' SessionLogsPage: description: Contains details of a page of session logs. type: object properties: pagingToken: type: string description: The token to be used in the next request to return the next collection of items. items: type: array description: A collection of items items: $ref: '#/components/schemas/SessionLogSummary' example: pagingToken: U3VwZXIgc2VjcmV0IGRhdGEuIFNoaGho items: - logId: 123 logNumber: 123 stageId: 00000000-0000-0000-0000-000000000000 stageName: Example stage stageType: Calculation processName: Example process pageName: Example page objectName: Example object actionName: Example action result: Some result resultType: Collection resourceStartTime: '2020-10-02T12:34:56+01:00' resourceEndTime: '2020-10-02T13:34:56+01:00' bluePrismMemory: 123 targetAppId: Example target targetMemory: 123 hasParameters: true SessionLogParametersResponse: description: Contains input and output parameters of a session log. type: object properties: inputs: $ref: '#/components/schemas/DataRow' outputs: $ref: '#/components/schemas/DataRow' example: inputs: parameter1: valueType: Text value: Example value parameter2: valueType: Number value: 123 outputs: parameter1: valueType: Collection value: rows: - valueType: Number value: 321 - valueType: Date value: '2020-10-02T12:34:56+01:00' SessionLogSummary: description: Contains basic details of a session log. type: object properties: logId: type: integer description: The ID of the session log. logNumber: type: integer description: The number of the session log. stageId: type: string description: The id of the stage that created this log entry. stageName: type: string description: The name of the stage that created this log entry. stageType: description: The type of the stage that created this log entry. type: string $ref: '#/components/schemas/StageType' processName: type: string description: The name of the processes. pageName: type: string description: The name of the page. objectName: type: string description: The name of the object. actionName: type: string description: The name of the action. result: type: string description: The result of the stage. resultType: type: string description: The result type of the stage. $ref: '#/components/schemas/ResultType' resourceStartTime: type: string format: date-time description: The date and time that the resource started running. resourceEndTime: type: string format: date-time description: The date and time that the resource ended running. bluePrismMemory: type: integer description: The automate memory. targetAppId: type: string description: The id of the target app. targetMemory: type: integer description: The tareget memory. hasParameters: type: boolean description: If the session log has parameters. example: logId: 123 logNumber: 123 stageId: 00000000-0000-0000-0000-000000000000 stageName: Example stage stageType: Calculation processName: Example process pageName: Example page objectName: Example object actionName: Example action result: Some result resultType: Collection resourceStartTime: '2020-10-02T12:34:56+01:00' resourceEndTime: '2020-10-02T13:34:56+01:00' bluePrismMemory: 123 targetAppId: Example target targetMemory: 123 hasParameters: true SessionSummary: description: Contains basic details of a session, type: object properties: sessionId: type: string description: The ID of the session, format: uuid sessionNumber: type: integer description: The unique number of the session, areStartupParamsSet: type: boolean description: The flag which shows whether startup parameters were set, AreInputParamsSet: type: boolean description: The flag which shows whether input parameters were set, processId: type: string description: The ID of the process in the session, format: uuid processName: type: string description: The name of the session's process, resourceId: type: string description: The ID of the resource in the session, format: uuid resourceName: type: string description: The name of the resource in the session, username: type: string description: The username of the user that initialized the session, status: $ref: '#/components/schemas/SessionStatus' description: The current state of the session, startTime: type: string nullable: true description: The start time of the session, format: date-time endTime: type: string nullable: true description: The end time of the session, format: date-time latestStage: type: string description: The latest stage name of the session, nullable: true stageStarted: type: string nullable: true description: The stage start time of the session, format: date-time exceptionMessage: type: string nullable: true description: The exception message of the failed session, terminationReason: type: string enum: - None - ProcessError - InternalError description: The reason for the termination of the session, nullable: true exceptionType: type: string description: Type of the exception. nullable: true sessionSource: $ref: '#/components/schemas/SessionSource' description: Source of the session. processAttribute: type: array description: The attributes of the process. items: $ref: '#/components/schemas/ProcessAttribute' example: sessionId: 01234567-89ab-cdef-0123-456789abcdef sessionNumber: 123 areStartupParamsSet: true areInputParamsSet: true processId: 01234567-89ab-cdef-0123-456789abcdef processName: Example process resourceId: 01234567-89ab-cdef-0123-456789abcdef resourceName: Example resource username: Example user status: Running startTime: '2020-10-02T12:34:56+02:00' endTime: '2020-10-03T13:36:21+02:00' latestStage: Example stage stageStarted: '2020-10-02T12:35:30+02:00' exceptionMessage: Exception message terminationReason: InternalError exceptionType: Exception type sessionSource: Enterprise processAttribute: - Retired - Published - PublishedWebService SessionItemsPage: description: Contains details of a page of sessions. type: object properties: pagingToken: $ref: '#/components/schemas/PagingToken' nullable: true items: type: array description: A collection of session summary. items: $ref: '#/components/schemas/SessionSummary' example: - sessionId: 01234567-89ab-cdef-0123-456789abcdef sessionNumber: 123 processId: 01234567-89ab-cdef-0123-456789abcdef processName: Example process resourceId: 01234567-89ab-cdef-0123-456789abcdef resourceName: Example resource username: Example user status: Running startTime: '2020-10-02T12:34:56+02:00' endTime: '2020-10-03T13:36:21+02:00' latestStage: Example stage stageStarted: '2020-10-02T12:35:30+02:00' exceptionMessage: Exception message terminationReason: InternalError exceptionType: Exception type sessionSource: Enterprise processAttribute: Published SessionStartUpParameters: description: Contains start-up parameters of a session. type: object properties: parameters: $ref: '#/components/schemas/DataRow' example: parameters: parameter1: valueType: Text value: Example value additionalParameters: - UTF-8 parameter2: valueType: Number value: 123 additionalParameters: null parameter3: valueType: Image value: isAWPOCldncNSNLnacnKNsnaNAlknKLKScnsaklcn... additionalParameters: - C:\Path\To\File.ext - 01/01/2022 01:01:01 AM CreateSessionParameters: description: Contain a parameter used to create a new session type: object properties: resourceId: type: string format: uuid description: The ID of the resource or pool to create session. processId: type: string format: uuid description: The ID of the process to create session. StageType: description: The stage type of a session type: string enum: - Undefined - Action - Decision - Calculation - Data - Collection - Process - SubSheet - ProcessInfo - SubSheetInfo - Start - End - Anchor - Note - LoopStart - LoopEnd - Read - Write - Navigate - Code - ChoiceStart - ChoiceEnd - WaitStart - WaitEnd - Alert - Exception - Recover - Resume - Block - MultipleCalculation - Skill - Input - Output - EnterpriseSession ResultType: description: The result type of a session type: string enum: - Unknown - Binary - Collection - Date - DateTime - Flag - Image - Number - Password - Text - Time - TimeSpan - RadioButton SessionStatus: description: The status of a session type: string enum: - Pending - Running - Terminated - Stopped - Completed - Stopping - Warning SessionSource: description: The source of a session type: string enum: - Desktop - Enterprise TimeZones: description: A collection of time zones. type: array items: $ref: '#/components/schemas/TimeZone' example: items: - id: Dateline Standard Time displayName: (UTC-12:00) International Date Line West baseUtcOffset: '-12:00:00' standardName: Dateline Standard Time - id: UTC-11 displayName: (UTC-11:00) Co-ordinated Universal Time-11 baseUtcOffset: '-11:00:00' standardName: UTC-11 TimeZone: description: Contains details of a time zone. type: object properties: id: type: string description: The time zone identifier. displayName: type: string description: The general display name that represents the time zone. baseUtcOffset: type: string format: time-span description: The time difference between the current time zone's standard time and Coordinated Universal Time (UTC). standardName: type: string description: The display name for the time zone's standard time. WorkQueueGroup: description: Contains basic details of a work queue group. type: object properties: id: type: string description: The ID of the work queue group. format: uuid or "root" name: type: string description: The name of the work queue group. parentGroupId: type: string description: The ID of the parent work queue group. format: uuid or "root" hasChildGroups: type: boolean description: True if the group containes other groups; otherwise, false. hasChildItems: type: boolean description: True if the group containes work queues; otherwise, false. example: id: 01234567-89ab-cdef-0123-456789abcdef name: Example work queue group parentGroupId: fedcba98-7654-3210-fedc-ba9876543210 hasChildGroups: false hasChildItems: false WorkQueuesFromGroupItemsPage: description: Contains details of a page of work queues from the work queue group. type: object properties: pagingToken: type: string description: The token to be used in the next request to return the next collection of items. items: type: array description: A collection of work queues from the work queue group. items: $ref: '#/components/schemas/WorkQueueInGroup' example: pagingToken: U3VwZXIgc2VjcmV0IGRhdGEuIFNoaGho items: - id: 01234567-89ab-cdef-0123-456789abcdef name: queue 1 WorkQueueInGroup: description: Contains details of the work queue from the work queue group. type: object properties: id: type: string description: The ID of the queue. format: uuid name: type: string description: The name of the queue. CreateWorkQueueGroup: description: Contains details for creating a new work queue group. type: object properties: name: type: string description: The name of the group to create. minLength: 1 maxLength: 255 parentGroupId: type: string format: uuid or "root" description: The ID of the group to use as a parent. example: name: Test Group parentGroupId: a4e0b0ba-3b8f-443d-bdb0-ee519299bd01 CreateWorkQueueGroupResponseModel: description: Contains the ID of a new work queue group. type: object properties: groupId: type: string format: uuid description: The ID of the created work queue group. WorkQueueChildGroups: description: Contains basic details of a work queue group. type: object properties: pagingToken: $ref: '#/components/schemas/PagingToken' items: type: array description: A collection of work queue groups. items: $ref: '#/components/schemas/WorkQueueGroup' WorkQueueSummary: description: Contains basic details of a work queue. type: object properties: id: type: string description: The ID of the queue. format: uuid name: type: string description: The name of the queue. minLength: 1 keyField: type: string description: The name of the column used as the queue's key. status: $ref: '#/components/schemas/QueueStatus' isEncrypted: type: boolean description: True if the queue is encrypted; otherwise, false. maxAttempts: type: integer description: The maximum number of retry attempts for items in the queue. pendingItemCount: type: integer description: The number of items in the queue in a pending state. completedItemCount: type: integer description: The number of items in the queue in a completed state. lockedItemCount: type: integer description: The number of items in the queue in a locked state. exceptionedItemCount: type: integer description: The number of items in the queue in an exceptioned state. totalItemCount: type: integer description: The total number of items in the queue. averageWorkTime: type: string format: time-span description: The average amount of time an items spends being worked. totalCaseDuration: type: string format: time-span description: The total amount of time items have been worked. groupName: type: string description: The name of the group in which the queue is located. groupId: type: string description: ID of the group in which the queue is located. format: uuid isRetryItems: type: boolean description: True if Retry items in this queue in the event of an unexpected session termination is enabled; otherwise, false. isSnapshotEnabled: type: boolean description: True if there is information related to Snapshot Configuration; otherwise, false. isActiveQueue: type: boolean description: True if the queue is active; otherwise, false. activeWorkQueueConfiguration: nullable: true $ref: '#/components/schemas/ActiveWorkQueueConfiguration' activeQueueStats: $ref: '#/components/schemas/ActiveWorkQueueStatistics' example: id: 01234567-89ab-cdef-0123-456789abcdef name: Example work queue keyField: Example field status: Running isEncrypted: false maxAttempts: 5 pendingItemCount: 10 completedItemCount: 75 lockedItemCount: 1 exceptionedItemCount: 3 totalItemCount: 14 averageWorkTime: 00:01:23 totalCaseDuration: 06:12:53 groupName: Example group groupId: fedcba98-7654-3210-fedc-ba9876543210 isRetryItems: true isSnapshotEnabled: true isActiveQueue: true activeWorkQueueConfiguration: assignedProcessId: axe34dfx-1234-2435-fedc-ba9876500987 assignedResourceGroupId: xv3fd45s-6543-6231-exrf-we23e456781 ActiveWorkQueueConfiguration: description: Contains details of an active work queue. type: object properties: assignedProcessId: type: string description: ID of the assigned process. format: uuid assignedResourceGroupId: type: string description: ID of the assigned resource group. format: uuid example: assignedProcessId: axe34dfx-1234-2435-fedc-ba9876500987 assignedResourceGroupId: xv3fd45s-6543-6231-exrf-we23e456781 ActiveWorkQueueStatistics: description: Contains statistics for an active work queue. type: object nullable: true properties: activeSessions: type: integer description: the current number of active sessions for this queue. availableResources: type: integer description: the current number of available resources assigned to this queue. timeRemaining: type: string description: the amount of time remaining for this queue based on the number of pending cases and the average work time for a case. format: time-span elapsedRemaining: type: string description: the amount of time remaining for all currently assigned sessions to work the remaining pending cases. format: time-span ETA: type: string description: the projected end time for this queue in local time. format: date-time example: activeSessions: '10' availableResources: '5' timeRemaining: 01:25:10 elapsedRemaining: 00:05:10 ETA: '2020-10-03T13:36:21+02:00' WorkQueueConfigurationSummary: description: Contains details of a work queue configuration. type: object properties: id: type: string description: The ID of the queue. format: uuid name: type: string description: The name of the queue. minLength: 1 activeWorkQueueConfiguration: nullable: true $ref: '#/components/schemas/ActiveWorkQueueConfiguration' activeQueueStats: $ref: '#/components/schemas/ActiveWorkQueueStatistics' example: id: f83a55c4-1151-41b1-89b0-6ad81ad50d7e name: Example work queue activeWorkQueueConfiguration: assignedProcessId: 5ebaf769-6325-4f8a-b175-aefb150ea64f assignedResourceGroupId: 49df134f-974b-4f81-b4a7-8518c04fa970 activeQueueStats: activeSessions: '10' availableResources: '5' timeRemaining: 01:25:10 elapsedRemaining: 00:05:10 ETA: '2020-10-03T13:36:21+02:00' WorkQueueConfigurationsPage: description: Contains details of a page of work queues configrations. type: object properties: pagingToken: nullable: true type: string description: The token to be used in the next request to return the next collection of items. items: type: array description: A collection of work queues configurations. items: $ref: '#/components/schemas/WorkQueueConfigurationSummary' example: pagingToken: A5VwZXIgg2VjcmV2IKLcdGEuLFNoaGhu items: - id: f83a55c4-1151-41b1-89b0-6ad81ad50d7e name: Example work queue activeWorkQueueConfiguration: assignedProcessId: 5ebaf769-6325-4f8a-b175-aefb150ea64f assignedResourceGroupId: 49df134f-974b-4f81-b4a7-8518c04fa970 activeQueueStats: activeSessions: '10' availableResources: '5' timeRemaining: 01:25:10 elapsedRemaining: 00:05:10 ETA: '2020-10-03T13:36:21+02:00' WorkQueuesItemsPage: description: Contains details of a page of work queues. type: object properties: pagingToken: nullable: true type: string description: The token to be used in the next request to return the next collection of items. items: type: array description: A collection of work queues. items: $ref: '#/components/schemas/WorkQueueSummary' example: pagingToken: U3VwZXIgc2VjcmV0IGRhdGEuIFNoaGho items: - id: 01234567-89ab-cdef-0123-456789abcdef name: Example work queue keyField: Example field status: Running isEncrypted: false maxAttempts: 5 pendingItemCount: 10 completedItemCount: 75 lockedItemCount: 1 exceptionedItemCount: 3 totalItemCount: 14 averageWorkTime: 00:01:23 totalCaseDuration: 06:12:53 groupName: Example group groupId: fedcba98-7654-3210-fedc-ba9876543210 isRetryItems: true isSnapshotEnabled: true isActiveQueue: true activeWorkQueueConfiguration: assignedProcessId: axe34dfx-1234-2435-fedc-ba9876500987 assignedResourceGroupId: xv3fd45s-6543-6231-exrf-we23e456781 activeQueueStats: activeSessions: '10' availableResources: '5' timeRemaining: 01:25:10 elapsedRemaining: 00:05:10 ETA: '2020-10-03T13:36:21+02:00' ReferencesItemsPage: description: Contains references of a specified object. type: object properties: pagingToken: $ref: '#/components/schemas/PagingToken' items: type: array description: A collection of references. items: $ref: '#/components/schemas/Reference' CreateWorkQueue: description: Contains details for creating a new work queue. type: object properties: name: type: string description: The name of the queue to create. minLength: 1 maxLength: 255 keyField: type: string description: The name of the column to be used as the queue's key. minLength: 0 maxLength: 255 maxAttempts: type: integer description: The maximum number of retry attempts for items in the queue. minimum: 1 maximum: 999999 status: $ref: '#/components/schemas/QueueStatus' encryptionKeyId: type: integer description: The ID of the encryption key to use for the queue. If no encryption is required, this field should be 0. sessionExceptionRetry: type: boolean description: Retry items in this queue in the event of an unexpected session termination. activeQueueAssignedProcessId: type: string format: uuid description: The ID of the process to use for an active queue. activeQueueAssignedResourceGroupId: type: string format: uuid description: The ID of the resource group to use for an active queue. groupid: type: object description: The ID of the group to use for the queue. If no group id is required, this field should be empty string like "" or empty Guid - "00000000-0000-0000-0000-000000000000". example: name: Example queue keyField: Example field maxAttempts: 3 status: Running encryptionKeyId: 0 sessionExceptionRetry: false activeQueueAssignedProcessId: 658de89c-a43d-4b18-a38c-d26d5eb26659 activeQueueAssignedResourceGroupId: 5180390c-b21a-4d69-9753-b876e34f100d groupid: a4e0b0ba-3b8f-443d-bdb0-ee519299bd01 UpdateWorkQueue: description: Contains details for updating a work queue's information. type: object properties: name: type: string description: The name of the queue. minLength: 1 keyField: type: string description: The name of the column to be used as the queue's key. maxAttempts: type: integer description: The maximum number of retry attempts for items in the queue. minimum: 0 default: 3 status: $ref: '#/components/schemas/QueueStatus' encryptionKeyId: type: integer description: The ID of the encryption key to use for the queue. If no encryption is required, this field should be 0. example: name: Example queue keyField: Example field maxAttempts: 5 status: Paused encryptionKeyId: 0 WorkQueueItemsPage: description: Contains details of a page of work queue items. type: object properties: pagingToken: type: string description: The token to be used in the next request to return the next collection of items. items: type: array description: A collection of work queue items. items: $ref: '#/components/schemas/WorkQueueItemNoData' example: pagingToken: U3VwZXIgc2VjcmV0IGRhdGEuIFNoaGho items: - id: 01234567-89ab-cdef-0123-456789abcdef priority: 3 ident: 5112 state: Pending keyValue: Example value status: Example status tags: - Example tag 1 - Example tag 2 attemptNumber: 1 loadedDate: '2020-10-02T12:34:56+01:00' deferredDate: '2020-10-02T12:34:56+01:00' lockedDate: '0001-01-01T00:00:00Z' completedDate: '0001-01-01T00:00:00Z' exceptionedDate: '0001-01-01T00:00:00Z' exceptionReason: Example reason lastUpdated: '2020-10-02T12:34:56+01:00' workTimeInSeconds: 123 attemptWorkTimeInSeconds: 56 resource: Example resource sessionId: 01234567-89ab-cdef-0123-456789abcdef sla: 7200 slaDateTime: '0001-01-01T00:00:00Z' processName: Example process name isSuggested: false WorkQueueItemNoData: description: Contains details of a work queue item but does not return the data contained in it. type: object properties: id: type: string description: The ID of the item. format: uuid priority: type: integer description: The priority value assigned to the item. ident: type: integer description: The database-specific identity of the item. state: type: string enum: - None - Pending - Locked - Deferred - Completed - Exceptioned description: The current state of the item. keyValue: type: string description: The value of the key field. status: type: string description: The user-supplied status value. tags: type: array description: A collection of tags assigned to the item. items: type: string attemptNumber: type: integer description: The number of the attempt next time this item is worked. format: integer minimum: 1 loadedDate: type: string description: The time and date that the item was loaded into the system. format: date-time deferredDate: type: string description: The earliest time and date that this item is deferred until. format: date-time lockedDate: type: string description: The time and date that this item was locked; or the minimum date-time value if not locked. format: date-time completedDate: type: string description: The time and date that this item was completed; or the minimum date-time value if not completed. format: date-time exceptionedDate: type: string description: The time and date that this item was marked as exceptioned; or the minimum date-time value if not exceptioned. format: date-time lastUpdated: type: string description: The time and date that this item was last updated. format: date-time workTimeInSeconds: type: integer description: The number of seconds that this item has been worked on so far (including any previous attempts). format: integer attemptWorkTimeInSeconds: type: integer description: The number of seconds that this item has been worked on so far in this attempt. format: integer exceptionReason: type: string description: The error message which caused the exception, if any. resource: type: string description: The name of the resource. sessionId: type: string description: The session ID of the item. format: uuid sla: type: integer description: Business SLA of the item in seconds. format: integer slaDatetime: type: string description: SLA DateTime format: date-time processName: type: string description: Process name isSuggested: type: boolean description: Is Suggested example: id: 01234567-89ab-cdef-0123-456789abcdef priority: 3 ident: 5112 state: Pending keyValue: Example value status: Example status tags: - Example tag 1 - Example tag 2 attemptNumber: 1 loadedDate: '2020-10-02T12:34:56+01:00' deferredDate: '2020-10-02T12:34:56+01:00' lockedDate: '0001-01-01T00:00:00Z' completedDate: '0001-01-01T00:00:00Z' exceptionedDate: '0001-01-01T00:00:00Z' lastUpdated: '2020-10-02T12:34:56+01:00' workTimeInSeconds: 123 attemptWorkTimeInSeconds: 56 resource: Example resource sessionId: 01234567-89ab-cdef-0123-456789abcdef sla: 7200 slaDateTime: '0001-01-01T00:00:00Z' processName: Example process name isSuggested: false WorkQueueItem: description: Contains details of a work queue item including the data. type: object properties: id: type: string description: The ID of the item. format: uuid priority: type: integer description: The priority value assigned to the item. ident: type: integer description: The database-specific identity of the item. state: type: string enum: - None - Pending - Locked - Deferred - Completed - Exceptioned description: The current state of the item. keyValue: type: string description: The value of the key field. status: type: string description: The user-supplied status value. tags: type: array description: A collection of tags assigned to the item. items: type: string attemptNumber: type: integer description: The number of the attempt next time this item is worked. format: integer minimum: 1 loadedDate: type: string description: The time and date that the item was loaded into the system. format: date-time deferredDate: type: string description: The earliest time and date that this item is deferred until. format: date-time lockedDate: type: string description: The time and date that this item was locked; or the minimum date-time value if not locked. format: date-time completedDate: type: string description: The time and date that this item was completed; or the minimum date-time value if not completed. format: date-time exceptionedDate: type: string description: The time and date that this item was marked as exceptioned; or the minimum date-time value if not exceptioned. format: date-time exceptionReason: type: string description: The error message which caused the exception, if any. lastUpdated: type: string description: The time and date that this item was last updated. format: date-time workTimeInSeconds: type: integer description: The number of seconds that this item has been worked on so far (including any previous attempts). format: integer attemptWorkTimeInSeconds: type: integer description: The number of seconds that this item has been worked on so far in this attempt. format: integer resource: type: string description: The name of the resource. sessionId: type: string description: The ID of the session. format: uuid sla: type: integer description: Business SLA of the item in seconds. format: integer slaDateTime: type: string description: SLA DateTime format: date-time processName: type: string description: Process name isSuggested: type: boolean description: Is Suggested data: $ref: '#/components/schemas/DataCollection' example: id: 01234567-89ab-cdef-0123-456789abcdef priority: 3 ident: 123 state: Completed keyValue: Example value status: Example status tags: - Example tag 1 - Example tag 2 attemptNumber: 1 loadedDate: '2020-10-02T12:34:56+01:00' deferredDate: '2020-10-02T12:34:56+01:00' lockedDate: '0001-01-01T00:00:00Z' completedDate: '2020-10-02T13:00:00+01:00' exceptionedDate: '0001-01-01T00:00:00Z' exceptionReason: Example reason lastUpdated: '2020-10-02T13:00:00+01:00' workTimeInSeconds: 123 attemptWorkTimeInSeconds: 123 resource: Example resource sessionId: 01234567-89ab-cdef-0123-456789abcdef data: rows: - valueType: Number value: 321 - valueType: Date value: '2020-10-02T12:34:56+01:00' sla: 7200 slaDateTime: '0001-01-01T00:00:00Z' processName: Example process name isSuggested: false CreateWorkQueueItems: description: Contains details for creating a number of work queue items. type: array items: $ref: '#/components/schemas/CreateWorkQueueItem' CreateWorkQueueItem: description: Contains details for creating a work queue item in a queue. type: object properties: data: $ref: '#/components/schemas/DataCollection' deferredDate: type: string nullable: true description: The earliest time and date that this item is deferred until. format: date-time priority: type: integer description: The priority value assigned to the item. format: integer tags: type: array description: A collection of tags assigned to the item. items: type: string status: type: string description: The user-supplied status value. sla: type: integer nullable: true description: The user-supplied sla value. processName: type: string description: The user-supplied process name value. isSuggested: type: boolean description: The user-supplied isSuggested value - default value should be false. example: data: rows: - valueType: Number value: 321 - valueType: Date value: '2020-10-02T12:34:56+01:00' deferredDate: '2020-10-02T12:34:56+01:00' priority: 3 tags: - Example tag 1 - Example tag 2 status: Example status sla: 7200 processName: Example process name isSuggested: false QueueStatus: description: The current status of the queue. type: string enum: - Running - Paused CreateWorkQueueItemAttemptResponseModel: description: Contains the ID of a new work queue item attempt. type: object properties: attemptId: type: integer description: The ID of the work queue item attempt. CreateWebhookWorkQueueItem: description: Contains details for creating a webhook subscriptions for a work queue item in a queue. type: object required: - eventtypes - callbackurl properties: eventtypes: type: array description: List of events that trigger the webhook. items: type: string enum: - exception - completed - prioritychanged - dataupdated - status - deferred - locked - retryexception callbackurl: type: string description: The url to send callbacl request. format: uri example: https://your-api.com/webhook/callback extensions: type: object description: Optional security and metadata configuration. required: - security properties: data: type: object description: Custom JSON object for client-specific metadata. Can be empty additionalProperties: true example: clientId: '1' security: type: object description: The authentication callback detailes. required: - credentialName - type properties: credentialName: description: The name of the credentials registered in BPE Credential Manager. type: string example: Client1 type: type: string description: The type of the credentials. example: BasicAuthentication WorkQueueItemWebhookSubscriptionResponse: description: Response containing webhook subscription details. type: object required: - id - secret - subscriptions properties: id: type: string format: uuid description: The ID of the webhook subscription. secret: type: string description: The secret for validating webhook payloads. subscriptions: type: array description: The list of subscriptions according to event types. items: $ref: '#/components/schemas/WorkQueueItemEventSubscriptionResponse' WorkQueueItemSubscriptionCustomResponse: description: Response containing custom subscription details. type: object required: - subscriptionId - subscriptions properties: subscriptionId: type: string format: uuid description: The ID of the subscription. subscriptions: type: array description: The list of subscriptions according to event types. items: $ref: '#/components/schemas/WorkQueueItemEventSubscriptionResponse' WorkQueueItemEventSubscriptionResponse: type: object description: The subscription created for an event type. properties: subscriptionId: type: string description: The ID of the subscription. format: uuid eventType: type: string description: The event type subscribed to. example: exception EncryptionScheme: description: Contains details of an encryption scheme. type: object properties: name: type: string description: The name of the encryption scheme. algorithm: type: string enum: - None - TripleDES - Rijndael256 - AES256 description: The name of the encryption algorithm. keyLocation: type: string enum: - Database - Server description: If the key is stored in the database or server. isAvailable: type: boolean description: If the encryption scheme is available. example: name: Example encryption scheme algorithm: AES256 keyLocation: Server isAvailable: true EnvironmentVariable: description: Contains details of an environment variable. type: object properties: id: type: string description: The id of the environment variable. format: uuid name: type: string description: The name of the environment variable. description: type: string description: The description of the environment variable. dataType: type: string description: The type of the environment variable. value: type: object description: The value of the environment variable. nullable: true EnvironmentVariableItemsPage: description: Contains details of a page of environment variables. type: object properties: pagingToken: $ref: '#/components/schemas/PagingToken' items: type: array description: A collection of environment variables. items: $ref: '#/components/schemas/EnvironmentVariable' EnvironmentVariableReferencesItemsPage: description: Contains details of a page of environment variables references. type: object properties: pagingToken: type: string description: The token to be used in the next request to return the next collection of items. items: type: array description: A collection of environment variables references. items: $ref: '#/components/schemas/Reference' Health: description: Contains details of API health and its dependencies. type: object properties: healthy: type: boolean description: The overall health status of the API. dependencies: type: array description: The health of API dependencies items: $ref: '#/components/schemas/Dependency' Dependency: description: Contains details of API dependency health type: object properties: name: type: string description: The name of the dependency example: database healthy: type: boolean description: The health status of the dependency License: description: Contains details of the license. type: object properties: id: type: integer description: The ID of the license. status: type: string enum: - Future - Expired - ExpiresSoon - GracePeriodEndsSoon - RequiresActivation - Active description: The status of the license. activationStatus: type: string enum: - NotApplicable - NotActivated - Activated description: The activationStatus of the license. owner: type: string description: The owner of the license. type: type: string enum: - None - Enterprise - NHS - Evaluation - Education - Desktop description: The type of the license. starts: type: string description: The date on which this license comes into effect. format: date-time expires: type: string description: The date at which this license expires. format: date-time processes: type: string description: The number of processes. sessions: type: string description: The number of sessions. resources: type: string description: The number of resources. alerts: type: string description: The number of alerts. standalone: type: boolean description: Does this license standalone? decipherIDP: type: boolean description: Does this license have decipher permissions? example: id: 1 status: Active owner: Test License activationStatus: NotApplicable type: Enterprise starts: '2021-01-31' expires: '2023-01-31' processes: '1' sessions: unlimited resources: '5' alerts: '50' standalone: true decipherIDP: false LicensesItemsPage: description: Contains basic details of a licenses. type: object properties: pagingToken: $ref: '#/components/schemas/PagingToken' items: type: array description: A collection of licenses. items: $ref: '#/components/schemas/License' AddLicense: description: Contains details for adding a new license key. type: object properties: encodedLicenseKey: type: string description: The encoded license key. example: encodedLicenseKey: PD94bWwgdmVyc2lvbj0iMS4 AddLicenseResponseModel: description: Contains the information of an added license. type: object properties: id: type: integer description: The ID of the license. status: type: string enum: - Future - Expired - ExpiresSoon - GracePeriodEndsSoon - RequiresActivation - Active description: The status of the license. expires: type: string description: The date at which this license expires. format: date-time owner: type: string description: The owner of the license. example: id: 1 status: Active expires: '2023-01-31' owner: Test License ScheduleSessionStart: description: A request to start a schedule at startTime. type: object properties: startTime: type: string description: The date and time that the schedule should be run at. format: date-time example: '2020-10-02T12:34:56+02:00' ScheduleSessionStartResponse: description: A response to a start request containing the date-time when the schedule is expected to run. type: object properties: scheduledTime: type: string description: The date and time that the schedule has been scheduled to run at. format: date-time example: '2020-10-02T12:34:56+02:00' ScheduledTask: description: Contains details of a scheduled task. type: object properties: id: type: integer description: The ID of the scheduled task. name: type: string description: The name of the scheduled task. description: type: string description: The description of the scheduled task. failFastOnError: type: boolean description: Determines if all errors should be regarded as a task failure. delayAfterEnd: type: integer description: The delay after task end. onSuccessTaskId: type: integer description: The ID for the task to commence on the success of this task. onSuccessTaskName: type: string description: The name of the task to commence on the success of this task. onFailureTaskId: type: integer description: The ID for the task to commence on the failure of this task. onFailureTaskName: type: string description: The name of the task to commence on the failure of this task. sessionsCount: type: integer description: The number of scheduled sessions a task has. CreateScheduledTask: description: Contains details of a scheduled task. type: object properties: name: type: string description: The name of the scheduled task. description: type: string description: The description of the scheduled task. failFastOnError: type: boolean description: Determines if all errors should be regarded as a task failure. delayAfterEnd: type: integer description: The delay after task end. onSuccessTaskId: type: integer description: The ID for the task to commence on the success of this task. onFailureTaskId: type: integer description: The ID for the task to commence on the failure of this task. ScheduledSessionParameters: description: Contains parameters of a scheduled session. type: object properties: processId: type: string format: uuid description: The ID of the process. resourceId: type: string format: uuid description: The ID of the resource. CreateScheduledSessionResponse: description: Contains ID of created scheduled session. type: object properties: scheduledSessionId: description: The ID of the created scheduled session. type: integer CreateScheduledTaskResponse: description: Contains ID of created task. type: object properties: taskId: type: integer description: The ID of the created task. UpdateSchedule: description: Contains details for updating a schedule. type: object properties: isRetired: type: boolean description: A new value for schedule retirement status. ScheduledSessionArguments: description: Contains details of start-up parameters. type: array items: $ref: '#/components/schemas/ScheduledSessionArgumentsModel' ScheduledSessionArgumentsModel: description: Contains details of start-up parameters. type: object properties: parameters: $ref: '#/components/schemas/DataRow' taskSessionId: type: integer description: The ID of scheduled task session. format: integer example: parameters: parameter1: valueType: Text value: Example value additionalParameters: - UTF-8 parameter2: valueType: Number value: 123 additionalParameters: null parameter3: valueType: Image value: isAWPOCldncNSNLnacnKNsnaNAlknKLKScnsaklcn... additionalParameters: - C:\Path\To\File.ext - 01/01/2022 01:01:01 AM taskSessionId: 3 ScheduledSession: description: Contains details of a schedule session. type: array items: type: object properties: processName: type: string description: The particular process associated with that session. resourceName: type: string description: The particular resource associated with that session. taskSessionId: type: integer description: The ID of the session to run associated with the task. Process: description: Contains details of a published process. type: object properties: processId: type: string description: The ID of the process. format: uuid processName: type: string description: The name of the process. processDescription: type: string description: The description of the process. groupId: type: string description: The ID of group related to the process. format: uuid groupName: type: string description: The name of the group related to the process. attributes: type: array description: The attributes of the process. items: $ref: '#/components/schemas/ProcessAttribute' example: processId: 01234567-89ab-cdef-0123-456789abcdef processName: Process_Name processDescription: Process_Description groupId: 99e23d41-e8ec-4ffe-89c9-93814d70d551 groupName: Group_name attributes: - Retired - Published - PublishedWebService ProcessAttribute: description: The attributes of the process. type: string enum: - None - Retired - Published - PublishedWebService - PublishedDesktop ProcessAttributeFilter: description: The attributes of the process to filter by. type: string enum: - Retired - Published - PublishedWebService - PublishedDesktop ProcessItemsPage: description: Contains details of a page of processes. type: object properties: pagingToken: type: string description: The token to be used in the next request to return the next collection of items. items: type: array description: A collection of processes. items: $ref: '#/components/schemas/Process' example: pagingToken: U3VwZXIgc2VjcmV0IGRhdGEuIFNoaGho items: - processId: 01234567-89ab-cdef-0123-456789abcdef processName: Process_Name processDescription: Process_Description groupId: 99e23d41-e8ec-4ffe-89c9-93814d70d551 groupName: Group_name attributes: - Retired - PublishedWebService ProcessGroupItemItemsPage: description: Contains details of a page of nodes in the process group tree. type: object properties: pagingToken: type: string description: The token to be used in the next request to return the next collection of items. nullable: true items: type: array description: A collection of processes / process groups. items: $ref: '#/components/schemas/ProcessGroupItem' example: pagingToken: U3VwZXIgc2VjcmV0IGRhdGEuIFNoaGho items: - id: 01234567-89ab-cdef-0123-456789abcdef name: Process_Name nodeType: Item lastModified: '2022-04-01T09:05:10.64+01:00' ProcessGroupItem: description: Contains details of a process group tree node. type: object properties: id: type: string description: The ID of the process or group. format: uuid name: type: string description: The name of the process or group. nodeType: type: string enum: - Item - Group description: The type of this tree node - Item or Group. lastModified: type: string format: date-time description: The last modified date of the process it this is an item node. Default date value is this is a group node. example: '2020-10-02T12:34:56+02:00' example: id: 01234567-89ab-cdef-0123-456789abcdef name: Process_Name nodeType: Item lastModified: '2022-04-01T09:05:10.64+01:00' Resource: description: Contains details of a runtime resource. type: object properties: id: type: string description: The ID of the resource. format: uuid name: type: string description: The name of the resource. poolId: type: string description: The ID of the pool to which the resource belongs. format: uuid poolName: type: string description: The name of the pool to which the resource belongs. groupId: type: string description: The ID of the group to which the resource or its pool belongs. format: uuid groupName: type: string description: The name of the group to which the resource or its pool belongs. attributes: type: array description: The attributes of the resource. items: $ref: '#/components/schemas/ResourceAttribute' activeSessionCount: type: integer description: The number of active sessions on the resource. warningSessionCount: type: integer description: The number of warning sessions on the resource. pendingSessionCount: type: integer description: The number of pending sessions on the resource. databaseStatus: type: string enum: - Unknown - Ready - Offline - Pending description: The reported status of the resource. displayStatus: type: string enum: - Working - Idle - Warning - Offline - Missing - LoggedOut - Private - Details - BPD - Hybrid description: The calculated state of the resource. resourceType: type: string enum: - Desktop - Enterprise - RemoteDigitalWorker description: The calculated type of the resource example: id: 01234567-89ab-cdef-0123-456789abcdef name: Example poolId: 99e23d41-e8ec-4ffe-89c9-93814d70d551 poolName: Pool name groupId: fedcba98-7654-3210-fedc-ba9876543210 groupName: Example group attributes: - None activeSessionCount: 5 warningSessionCount: 1 pendingSessionCount: 2 databaseStatus: Ready displayStatus: Working resourceType: Desktop ResourceAttribute: description: The attributes of the resource. type: string enum: - None - Retired - Local - LoginAgent - Private - DefaultInstance - Desktop - RemoteDigitalWorker - Pool UpdateResource: description: Contains details to update a runtime resource's attributes. type: object properties: attributes: description: The attributes to assign to the resource. type: array items: $ref: '#/components/schemas/ResourceAttribute' example: attributes: - Retired - None ResourceItemsPage: description: Contains details of a page of runtime resources. type: object properties: pagingToken: type: string nullable: true description: The token to be used in the next request to return the next collection of items. items: type: array description: A collection of resources. items: $ref: '#/components/schemas/Resource' example: pagingToken: U3VwZXIgc2VjcmV0IGRhdGEuIFNoaGho items: - id: 01234567-89ab-cdef-0123-456789abcdef name: Example poolId: 99e23d41-e8ec-4ffe-89c9-93814d70d551 poolName: Pool name groupId: fedcba98-7654-3210-fedc-ba9876543210 groupName: Example group attributes: - None activeSessionCount: 5 warningSessionCount: 1 pendingSessionCount: 2 databaseStatus: Ready displayStatus: Working resourceType: Desktop CreateEnvironmentVariableModel: description: Contains details for creating a new environment variable. type: object properties: name: type: string description: The name of the environment variable to create. minLength: 1 maxLength: 64 description: type: string description: The description of the environment variable. dataType: type: string description: Valid types for environment variables - Date (date), DateTime (date-time), Flag (boolean), Number (integer), Password (string), Text (string), Time (date), TimeSpan (time), Image (base64), Binary (base64), RadioButtons (object radioButtons). value: description: The value of the environment variable of a valid type that the user provides to save to the DB. oneOf: - type: string format: base64 description: Used for Binary and Image data types. The image format must only be one of these BPM, JPG, JPEG, GIF, PNG, ICO or TIFF. - type: string format: date description: Used for Date, DateTime and Time data types. - type: boolean description: Used for the Flag data type. - type: number description: Used for the Number data type. - type: string description: Used for Password and Text data types. - type: string format: time description: Used for the TimeSpan data type. - $ref: '#/components/schemas/RadioButtons' description: Used for the RadioButtons data type. example: name: Test environment variable description: Any text value: Any text dataType: Text RadioButtons: description: Contains details for creating a new collection of radio buttons. type: array items: $ref: '#/components/schemas/RadioButton' RadioButton: type: object description: Contains details for creating a new radio button. properties: name: type: string description: The name of the radio button. selected: type: boolean description: Returns True if the radio button is selected. example: name: button1 selected: true FullStringFilter: description: Used to filter strings. Check for strings that start with, contain, equal, are greater than, are less than, or are between the given value(s). type: object anyOf: - $ref: '#/components/schemas/StringFilter' - $ref: '#/components/schemas/RangeOrEqualFilter' example: ctn: null strtw: null gte: null lte: null eq: null BasicStringFilter: description: Used to filter strings. Check for strings that start with, equal, are greater than, are less than, or are between the given value(s). type: object anyOf: - $ref: '#/components/schemas/RangeOrEqualFilter' - $ref: '#/components/schemas/StartsWithStringFilter' example: strtw: null gte: null lte: null eq: null BasicNumericFilter: description: Used to filter numbers. Check for numbers that start with, equal, are greater than, are less than, or are between the given values(s). type: object oneOf: - $ref: '#/components/schemas/RangeOrEqualFilter' - $ref: '#/components/schemas/StartsWithStringFilter' example: strtw: null eq: null lte: null gte: null RangeOrEqualFilter: description: Used to filter values. Check for values that are equal to, greater than or equal to, less than or equal to, or between the given value(s). type: object oneOf: - $ref: '#/components/schemas/RangeFilter' - $ref: '#/components/schemas/EqualsFilter' example: gte: null lte: null eq: null RangeFilter: description: Used to filter values. Check for values that are greater than or equal to, less than or equal to, or between the given value(s). type: object anyOf: - $ref: '#/components/schemas/GreaterThanOrEqualToFilter' - $ref: '#/components/schemas/LessThanOrEqualToFilter' example: gte: null lte: null StringFilter: description: Used to filter strings. Check for strings that start with, and/or contain the given value(s). type: object anyOf: - $ref: '#/components/schemas/ContainsStringFilter' - $ref: '#/components/schemas/StartsWithStringFilter' example: ctn: null strtw: null ContainsStringFilter: description: Used to filter strings. Check for strings that contain the given value. type: object properties: ctn: type: string description: The value that the field should contain. nullable: true example: ctn: null StartsWithStringFilter: description: Used to filter strings. Check for strings that start with the given value. type: object properties: strtw: type: string description: The value that the field should start with. nullable: true example: strtw: null GreaterThanOrEqualToFilter: description: Used to filter values. Check for values that are greater than or equal to the given value. type: object properties: gte: type: object description: The value that the field should be greater than or equal to. nullable: true example: gte: null LessThanOrEqualToFilter: description: Used to filter values. Check for values that are less than or equal to the given value. type: object properties: lte: type: object description: The value that the field should be less than or equal to. nullable: true example: lte: null EqualsFilter: description: Used to filter values. Check for values that are equal to the given value. type: object properties: eq: type: object description: The value that the field should be equal to. nullable: true example: eq: null PatchRequest: description: A request containing a JSON Patch document. See PatchDocument for details. type: array items: $ref: '#/components/schemas/PatchDocument' PatchDocument: description: A JSONPatch document as defined by RFC 6902. See http://jsonpatch.com/ required: - op - path properties: op: type: string description: The operation to be performed. enum: - add - remove - replace - move - copy path: type: string description: A JSON-Pointer. value: type: object description: The value to be used within the operations.. from: type: string description: A string containing a JSON Pointer value. Error: description: A general error occurred. See errorMessage for details. type: object properties: errorMessage: description: A message describing the problem encountered. type: string ErrorMessage: description: A message describing the problem encountered. type: string ValidationError: description: An error occurred during validation. See the response body for details on the invalid field. type: object properties: invalidField: type: string description: The field which is invalid. message: type: string description: A description of the error found with the field. UrlParameterError: description: An error occurred due to incorrect data supplied to url parameter. type: object properties: message: type: string description: A message about the error. messageDetail: type: string description: A detailed description about the error. Identifier: description: A GUID resource ID. type: object properties: id: type: string description: The ID of the newly created resource. format: uuid Identifiers: description: A collection of GUID resource IDs. type: object properties: ids: description: A collection of resource IDs. type: array items: type: string description: The IDs of the newly created items. format: uuid PagingToken: type: string description: The token to be used in the next request to return the next collection of items. example: U3VwZXIgc2VjcmV0IGRhdGEuIFNoaGho Reference: description: Contains details of referenced item. type: object properties: id: type: string format: uuid description: The ID of the process/object. name: type: string description: The name of the process/object. minLength: 1 description: type: string description: The description of process/object. type: type: string enum: - Process - Object - Unset description: The type of process/object ProcessType: description: The process type of environment variable reference. type: string enum: - Process - Object Calendar: description: A model of calendar. type: object properties: id: type: integer description: The ID of the calendar. name: type: string description: The name of the calendar. workingWeek: type: array description: An array of days in the working work. items: type: string region: $ref: '#/components/schemas/Region' example: id: 1 name: Working Week / No Holidays workingWeek: - Monday - Tuesday region: regionId: 1 disabledPublicHolidaysIds: - 1 - 2 Region: description: A model of region. type: object properties: regionId: type: integer description: The ID of the region. disabledPublicHolidaysIds: type: array description: An array of IDs of the disabled public holidays. items: type: integer description: The ID of disabled public holidays. example: regionId: 1 disabledPublicHolidaysIds: - 1 - 2 HolidayRegion: description: A model of holiday region. type: object properties: id: type: integer description: The ID of the holiday region. name: type: string description: The name of the region. example: id: 1 name: England and Wales HolidayByRegionId: description: A model of holiday by region id. type: object properties: publicHolidayId: type: integer description: The ID of the holiday by region id. name: type: string description: The name of the public holiday. nextDate: type: string description: The next date of the public holiday. example: publicHolidayId: 33 name: Coming of Age Day nextDate: 10/01/2023 CreateCalendarModel: description: Contains details for creating a new calendar. type: object properties: name: type: string description: The name of the calendar to create. minLength: 1 maxLength: 128 workingWeek: type: array description: An array of working week. Each day can be added only 1 time. items: type: string enum: - Sunday - Monday - Tuesday - Wednesday - Thursday - Friday - Saturday region: type: object description: A region of the calendar. properties: regionId: type: integer description: The Id of the region. disabledPublicHolidaysIds: type: array description: An array of disabled public holidays Ids. Each holidays can be added only 1 time. items: type: integer nullable: true CloneCalendarModel: description: Contains details for cloning a calendar with a new name. type: object properties: name: type: string description: The name of the calendar to create. minLength: 1 maxLength: 128 OtherHolydaysModel: description: Contains details for other holidays. type: object properties: holidays: type: array description: An array of other holidays. items: type: string format: date CreateCalendarResponseModel: description: Contains the ID of a calendar. type: object properties: id: type: integer description: The ID of the calendar. ResourcePool: description: A model of resource pool. type: object properties: id: type: string description: The ID of the resource pool. format: uuid name: type: string description: The name of the pool. members: type: integer description: The number of resources in the pool. databaseStatus: type: string enum: - Unknown - Ready - Offline - Pending description: The reported status of the resource pool. example: id: 1 name: Test Pool members: 3 databaseStatus: Ready ResourceUtilization: description: A model of resource utilization per hour. type: object properties: resourceId: type: string description: The ID of the resource. format: uuid digitalWorkerName: type: string description: The name of the resource. utilizationDate: type: string description: The date of the resource utilization. format: date-time example: '2020-10-02T12:34:56+02:00' usages: type: array description: An array of 24 items representing each hour of a day. Each item contains the number of minutes of that hour that the resource was working. items: type: integer description: The number of minutes that the resource was working in this hour. ResourcesSummaryUtilization: description: A model of average resource utilization per day. type: object properties: usagehour: type: string description: The date of the resource utilization. format: date-time example: '2020-10-02T12:34:56+02:00' usage: type: integer description: The average resource utilization per hour in minutes. WorkQueueComposition: description: A summary of work queue items. type: object properties: id: type: string description: The ID of the work queue. format: uuid name: type: string description: The name of work queue. completed: type: integer description: A count of completed items in work queue. pending: type: integer description: A count of pending items in work queue. deferred: type: integer description: A count of deferred items in work queue. locked: type: integer description: A count of locked items in work queue. exceptioned: type: integer description: A count of exceptioned items in work queue. LicensesEntitlement: description: A summary of an aggregated licenses entitlement data. type: object properties: activeLicenseTypes: description: An array of types of an active licenses. type: array items: type: string enum: - Enterprise - NHS - Evaluation - Education - Desktop enterpriseEntitlement: type: object $ref: '#/components/schemas/BaseEntitlement' description: A summary of an aggregated enterprise licenses entitlement data. desktopEntitlement: type: object $ref: '#/components/schemas/BaseEntitlement' description: A summary of an aggregated desktop licenses entitlement data. BaseEntitlement: description: An aggregated licenses entitlement data. type: object properties: publishedprocesseslimit: type: integer description: Number of processes that can be published. concurrentsessionslimit: type: integer description: Number of concurrent sessions which can be ran. runtimeresourceslimit: type: integer description: Number of resources which can be registered at any one time. processalertmachineslimit: type: integer description: Number of machines which Process Alerts can be used. LicenseUsageDetailsModel: description: A summary of active licenses limits and usages type: object properties: publishedProcessesLimit: type: integer nullable: true description: The number of processes that active licenses permit to be published or null if unlimited. example: null publishedProcessesUsed: type: integer description: The number of published processes (excluding retired processes) currently in use. example: 5 concurrentSessionsLimit: type: integer nullable: true description: The number of concurrent sessions that active licenses permit or null if unlimited. example: 50 concurrentSessionsUsed: type: integer description: The number of current pending, running or stopping sessions. example: 7 runtimeResourcesLimit: type: integer nullable: true description: The number of machines that active licenses permit or null if unlimited. example: 150 runtimeResourcesUsed: type: integer description: The number of machines currently in use. example: 72 processAlertMachinesLimit: type: integer nullable: true description: The number of machines on which this set of licenses permits process alerts or null if unlimited. example: 50 processAlertMachinesUsed: type: integer description: The number of machines with alerts currently in use. example: 17 examples: EnvironmentVariableRadioButtonsExample: summary: RadioButtons value: pagingToken: U3VwZXIgc2VjcmV0IGRhdGEuIFNoaGho items: - name: name of the radiobuttons variable description: description of the radiobuttons variable dataType: radiobuttons value: - name: rb1 selected: true - name: rb2 selected: false EnvironmentVariableTextExample: summary: Text value: pagingToken: U3VwZXIgc2VjcmV0IGRhdGEuIFNoaGho items: - name: name of the text variable description: description of the text variable dataType: text value: text value PatchAddToArrayExample: summary: Add values to a collection. value: - op: add path: /someArrayProperty value: - item1 - item2 PatchAddToObjectExample: summary: Add new property values to an object. value: - op: add path: /property value: propertyValue PatchCopyExample: summary: Copy a value from one property to another. value: - op: copy from: /sourceProperty path: /destinationProperty PatchMoveExample: summary: Move a value from one property to another. value: - op: move from: /sourceProperty path: /destinationProperty PatchReplaceExample: summary: Replace the value in a property. value: - op: replace path: /property value: propertyValue PatchRemoveExample: summary: Remove a property value. value: - op: remove path: /propertyToDeleteValueFrom DateTimeEqualsExample: value: eq: '2020-10-02T12:34:56+01:00' summary: Search for a value equal to 2020-10-02 at 12:34:56 (GMT+1). DateTimeRangeExample: value: gte: '2020-10-02T12:34:56+01:00' lte: '2020-11-02T12:34:56+01:00' summary: Search for a value between 2020-10-02 at 12:34:56 (GMT+1) and 2020-11-02 at 12:34:56 (GMT+1) (inclusive). DateTimeGreaterThanExample: value: gte: '2020-10-02T12:34:56+01:00' summary: Search for a value after or equal to 2020-10-02 at 12:34:56 (GMT+1). TimeEqualsExample: value: eq: '12:34:56' summary: Search for a value equal to 12:34:56. TimeRangeExample: value: gte: 01:23:45 lte: '12:34:56' summary: Search for a value between 01:23:45 and 12:34:56 (inclusive) TimeLessThanExample: value: lte: '12:34:56' summary: Search for a value less than or equal to 12:34:56 IntegerStartsWithExample: value: strtw: 123 summary: Search for a value starting with 123 IntegerEqualsExample: value: eq: 123 summary: Search for a value equal to 123. IntegerRangeExample: value: gte: 123 lte: 321 summary: Search for a value between 123 and 321 inclusive. IntegerLessThanExample: value: lte: 123 summary: Search for a value less than or equal to 123. IntegerGreaterThanExample: value: gte: 123 summary: Search for a value greater than or equal to 123. StringEqualsExample: value: eq: Example summary: Search for a value equal to "Example". StringContainsExample: value: ctn: amp summary: Search a value containing "amp" StringStartsWithExample: value: strtw: Exa summary: Search a value starting with "Exa". StringRangeExample: value: gte: Ex lte: F summary: Search for a value alphanumerically between "Ex" and "F". StringGreaterThanExample: value: gte: Example summary: Search for a value alphanumerically after or equal to "Example".