Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Assign an Execution User to a Webhook
  • Disable a Webhook
  • Enable a Webhook
  • Enable/Disable Multiple Webhooks
  • List Webhooks
  • Modify Webhooks
  • Read a Webhook
  • Register a Webhook
  • Unassign an Execution User from a Webhook
  • Unregister a Webhook

Formatting specifications for each web service, including details about parameter requirements, are provided.

...


 Description

URI

http://host_name/uc/resources/webhook

HTTP Method

POST

Description

Register a webhook.

Example URI

http://localhost:8080/uc/resources/webhook

Authentication

HTTP Basic

Produces Content-Type

Application/XML

Application/JSON

Consumes Content-Type

Application/XML

Application/JSON

Example Responses

  • Status 200

    • Successfully created the webhook with id {uuid}.

  • Status 400

    • Error message.

  • Status 403

    • Operation prohibited due to security constraints.

  • Status 404

    • A webhook with name “{name}” does not exist.

    • A webhook with id "{uuid}" does not exist.

  • Status 500

    • Unexpected request failure. See log(s) for more details.

Register a Webhook: Payload Properties

Property

UI Field Name

Description

Specifications

Required

name

Webhook Name

Name of the Webhook.


Y

description

Description

User-defined; description of this record.


N

opswiseGroups

Member of Business Services

Business Services that this record belongs to. 


XML


Code Block
languagetext
<opswiseGroups>
      <opswiseGroup>group1</opswiseGroup>
      <opswiseGroup>group2</opswiseGroup>
</opswiseGroups>

JSON

Code Block
languagetext
"opswiseGroups": ["group1","group2"]


N

retainSysIds

n/a

Specification for whether or not the Create a Webhook web service will persist the sysId property.

  • If retainSysIds="true" and sysId is included in the request/response, sysId will be persisted to the database.

  • If retainSysIds="false" and sysId is included in the request/response, sysId will be ignored; it will be autogenerated by the Controller.

Note

In XML web services, retainSysIds is specified as an attribute in the <webhook> element.

Valid values: true/false (default is true).

N

action

Action

Type of Action to perform

Valid Values:

  • As String = URL, As Value = 1

  • As String = Launch Task, As Value = 2

Default is URL (1).

Y

event

Event

Universal Event Template name.

XML

Code Block
languagetext
<event label="Test Event A">test_event_a</event>

 JSON

Code Block
languagetext
"event": {

    "label": "Test Event A",

    "value": "test_event_a"

}


Note

Only system level event templates will be allowed.


The label is included when reading a Webhook; however, it is ignored when creating/updating a Webhook.


Y

filter

Event Criteria

Universal Event criteria to to execute the webhook.


N

url

URL

full URL of the action to be executed. (Including parameters)


Y

(if action
= Url)

task

Task

Task of the action to be executed. (Including parameters)


Y

(if action
= Launch Taskl)

httpAuth

HTTP Authentication

HTTP authentication scheme to use.

Valid values:

  • As String = None, As Value = 0

  • As String = Basic, As Value = 1

Default is None (0).

N

httpHeaders

HTTP Headers

HTTP headers.

Format:


Code Block
languagetext
<httpHeaders>
	<httpHeader>
		<name>header1</name>
		<value>val1</value>
	</httpHeader>
	<httpHeader>
		<name>header2</name>
		<value>val2</value>
	</httpHeader>
</httpHeaders>


N

urlParameters

URL Query Parameters

Any query parameters to be encoded as a query string and appended to the URL.

Format:
 

Code Block
languagetext
<urlParameters>
      <urlParameter>
            <name>param1</name>
            <value>value1</value>
      </urlParameter>
      <urlParameter>
            <name>param2</name>
            <value>value2</value>
      </urlParameter>
</urlParameters>


N

credentials

Credentials

Credentials to be used to authenticate


N

Unassign an Execution User from a Webhook


 Description

URI

http://host_name/uc/resources/webhook/unassignexecutionuser


HTTP Method

POST

Description

Unassigns an Execution User to the specified webhook.

Example URI

http://localhost:8080/uc/resources/webhook/unassignexecutionuser?webhookid=

http://localhost:8080/uc/resources/webhook/unassignExecutionUser?webhookname=

Authentication

HTTP Basic

Consumes Content-Type

application/xml, application/json

Produces Content-Type

N/A

Example Request

See Unassign an Execution User to a Trigger: URI Parameters.

Example Response

  • Status 200 /OK
    Successfully unassigned execution user "test" to webhook "testWebhook".

...