...

Agents	Delete an Agent List Agents List Agents - Advanced Modify an Agent Read an Agent Resume an Agent Set Agent Task Execution Limit Suspend an Agent
Agent Clusters	Create an Agent Cluster Delete an Agent Cluster List Agent Clusters Modify an Agent Cluster Read an Agent Cluster Resume an Agent Cluster Resume an Agent Cluster Membership Return an Agent from an Agent Cluster Set an Agent Cluster Task Execution Limit Suspend an Agent Cluster Suspend an Agent Cluster Membership
Audits	List Audit Records
Bundles and Promotion	Bundles Bundle Report Create a Bundle Delete a Bundle List Bundles Modify a Bundle Read a Bundle Promotion Bundleless Promotion Cancel a Scheduled Bundle Promotion Delete a Scheduled Bundle Promotion Promote a Bundle or Schedule a Bundle Promotion Create a Promotion Target Modify a Promotion Target List Promotion Targets Delete a Promotion Target Read a Promotion Target Refresh Target Agents
Business Services	Create a Business Service Delete a Business Service List Business Services Modify a Business Service Read a Business Service
Calendars	Add an Existing Custom Day to a Calendar Create a Calendar Delete a Calendar List Calendars Modify a Calendar Read a Calendar Read All Custom Days of a Calendar Remove a Custom Day from a Calendar
Cluster Nodes	List Cluster Nodes Read Current Cluster Node
Connections	Database Connections Email Connections Email Templates PeopleSoft Connections SAP Connections SNMP Managers
Credentials	Create a Credential Delete a Credential List Credentials Modify a Credential Read a Credential
Custom Days	Create a Custom Day Delete a Custom Day List Custom Day Qualifying Dates List Custom Day Qualifying Periods List Custom Days List Local Custom Day Qualifying Dates List Local Custom Day Qualifying Periods Modify a Custom Day Read a Custom Day
Groups	Create a Group Delete a Group List Group Modify a Group Read a Group
Monitoring	Universal Controller Metrics (Prometheus)
OAuth Clients	Create an OAuth Client Modify an OAuth Client 12386311 Delete an OAuth Client List OAuth Clients
OMS Servers	Create an OMS Server Delete an OMS Server List OMS Servers Modify an OMS Server Read an OMS Server
Passwords	Change a Universal Controller User Password Change Runtime Password on Credentials
Properties	List Properties Modify a Property Read a Property
Reports	Run Report
Scripts	Create a Script Delete a Script List Scripts Modify a Script Read a Script
Server Operations	Export and Import LDAP List/Download Logs Pause and Resume Cluster Node Roll Log Temporary Property Change
System	Retrieve System Details
Task Instances	Cancel a Task Instance Clear All Dependencies Clear Exclusive Dependencies Clear Predecessor Dependencies Clear Time Dependency Clear Virtual Resource Dependencies Delete a Task Instance Force Finish a Task Instance Force Finish/Cancel a Task Instance Hold a Task Instance Issue Set Completed Command for a Manual Task Instance Issue Set Started Command for a Manual Task Instance List Task Instances List Task Instances: Advanced List Task Instance Variables (Show Variables) Release a Task from Hold Rerun a Task Instance Retrieve Task Instance Output Set or Modify Wait Time/Duration for Task Instance Set Priority for a Task Instance Skip a Task Instance Skip a Task Instance Path Unskip a Task Instance
Tasks	Create a Task Delete a Task Launch a Task List Tasks List Tasks - Advanced Modify a Task Read a Task
Triggers	Assign an Execution User to a Trigger Create a Trigger Delete a Trigger Enable/Disable a Trigger List Trigger Qualifying Times List Triggers List Triggers - Advanced Modify a Trigger Modify Time of Time Trigger Read a Trigger Trigger Now Unassign an Execution User from a Trigger
Universal Event	Universal Event Publishing
Universal Event Templates	Create a Universal Event Template Delete a Universal Event Template List Universal Event Templates Modify a Universal Event Template Read a Universal Event Template
Universal Templates	Create a Universal Template Delete a Universal Template List Universal Templates Modify a Universal Template Read a Universal Template Restore Default Universal Template Icon Set Universal Template Icon Universal Template - Delete Extension Archive Universal Template - Download Extension Archive Universal Template - Upload Extension Archive Universal Template Export Universal Template Import
Users	Create a User Create Personal Access Token Delete a User List Personal Access Tokens List Users Modify a User Read a User Revoke Personal Access Token
Variables	Create a Global Variable Delete a Global Variable List Variables List Variables - Advanced Modify a Global Variable Read a Global Variable Set Variables
Virtual Resources	Create a Virtual Resource Delete a Virtual Resource List Virtual Resources List Virtual Resources - Advanced Modify a Virtual Resource Read a Virtual Resource Set Limit on a Virtual Resource
Workflow Task Instances	Insert a Task into a Workflow with Dependencies List Predecessors / Successors of a Task Instance in a Workflow
Workflow Tasks	Create a Workflow Modify a Workflow Read a Workflow Workflow Tasks and Dependencies

...

Method

Description

GET

Retrieves records from the Controller database.

POST

Creates, or performs an action on, a record in the Controller database.

PUT

Modifies a record in the Controller database.

Note

title	Note

PUT, by itself, actually replaces an existing record with whatever information you include in the PUT operation. If you include only partial record information in a PUT, the record in the database will then contain only that information.

In order to modify information in a record and retain all of its unmodified information, you must first GET the record from the database, modify (add/delete/change) information in the record, and then PUT the record back in the database.

DELETE

Deletes a record in the Controller database.

Authentication

Universal Controller requires Web Service requests to be authenticated using one of Basic Authentication or Personal Access Token Authentication.

For Basic Authentication, use the following Authorization header, where the username:password is base64 encoded.

Panel
`Authorization: Basic username:password`

Access to the Controller requires basic HTTP authentication over HTTPS.

The following methods are used:

...

For Personal Access Token Authentication, use the following Authorization header.

Panel
`Authorization: Bearer access-token`

While it is recommended you use the Authorization header, if required, you can alternatively pass the Personal Access Token using the access_token query parameter.

Panel
`http://hostname:port/uc/resources/task?access_token=access-token&taskname=MyTask`

Request Limits

You can implement application- and user-level concurrent request limits to control how many web service API requests can be in progress at the same time via the following Universal Controller system properties:

Web Service Application Concurrent Request Limit

Controls the number of concurrent requests for the application (that is, the Universal Controller server).

This application-level concurrent request limit cannot be less than 1 or less than the user-level concurrent request limit (if specified).

Web Service User Concurrent Request Limit

Controls the number of concurrent requests per unique user ID.

This user-level concurrent request limit cannot be less than 1 or more than the application-level concurrent request limit (if specified).

If the application-level concurrent request limit is exceeded, an HTTP Status of 429 /Too Many Requests will be returned.

...

If either restriction is in place, the following error message will be written to the Audits table and the opswise.log file when you attempt to access the RESTful Web Services API:

Panel
User <your user name> not permitted to use Web Services. Please check with your administrator.

To remove the restriction, the system administrator must either:

...

Versions Compared

Old Version 1

New Version Current

Key

Authentication

Page Comparison

Versions Compared

Old Version 1

New Version Current

Key

Authentication