orchestrator
2020.10
false
- Getting Started
- About OData and References
- Orchestrator URL
- Enumerated Types
- Authenticating
- Building API Requests
- Permissions Per Endpoint
- Response Codes
- Health Check Endpoints
- Swagger Definition
- Read Me
- Authorizing API Calls in Swagger
- Managing Logical Resources
- Orchestrator APIs
- Assets Requests
- Calendars Requests
- Environments Requests
- Folders Requests
- Generic Tasks Requests
- Jobs Requests
- Libraries Requests
- License Requests
- Packages Requests
- Permissions Requests
- Processes Requests
- Robots Requests
- Roles Requests
- Schedules Requests
- Settings Requests
- Tasks Requests
- Task Catalogs Requests
- Task Forms Requests
- Tenants Requests
- Transactions Requests
- Users Requests
- Webhooks Requests
OUT OF SUPPORT
Orchestrator API Guide
Last updated Jun 18, 2024
According to Their URL
The following example enables you to get all the webhooks that send information to the
http://documentation.azurewebsites.net/webhook/documentation URL.
GET
{OrchestratorURL}/odata/Webhooks?$filter=Url eq 'http://documentation.azurewebsites.net/webhook/documentation'
Request headers
|
Key |
Value |
|---|---|
|
Authorization |
Bearer |
Response code
200 OK
Response body
{
"@odata.context": "{OrchestratorURL}/odata/$metadata#Webhooks",
"@odata.count": 1,
"value": [{
"Url": "http://documentation.azurewebsites.net/webhook/documentation",
"Enabled": true,
"Secret": "1234567890",
"SubscribeToAllEvents": false,
"AllowInsecureSsl": false,
"Id": 4,
"Events": [{
"EventType": "job.started"
},
{
"EventType": "process.created"
},
{
"EventType": "process.deleted"
},
{
"EventType": "process.updated"
},
{
"EventType": "queue.created"
}
]
}]
}{
"@odata.context": "{OrchestratorURL}/odata/$metadata#Webhooks",
"@odata.count": 1,
"value": [{
"Url": "http://documentation.azurewebsites.net/webhook/documentation",
"Enabled": true,
"Secret": "1234567890",
"SubscribeToAllEvents": false,
"AllowInsecureSsl": false,
"Id": 4,
"Events": [{
"EventType": "job.started"
},
{
"EventType": "process.created"
},
{
"EventType": "process.deleted"
},
{
"EventType": "process.updated"
},
{
"EventType": "queue.created"
}
]
}]
}According to an Id
The following request enables you to retrieve information about a specific webhook, according to its
Id.
GET
{OrchestratorURL}/odata/Webhooks(10)
Request headers
|
Key |
Value |
|---|---|
|
Authorization |
Bearer |
Response code
200 OK
Response body
{
"@odata.context": "{OrchestratorURL}/odata/$metadata#Webhooks/$entity",
"Url": "https://orchestrator.uipath.com",
"Enabled": false,
"Secret": "1234567890",
"SubscribeToAllEvents": true,
"AllowInsecureSsl": false,
"Id": 10,
"Events": []
}{
"@odata.context": "{OrchestratorURL}/odata/$metadata#Webhooks/$entity",
"Url": "https://orchestrator.uipath.com",
"Enabled": false,
"Secret": "1234567890",
"SubscribeToAllEvents": true,
"AllowInsecureSsl": false,
"Id": 10,
"Events": []
}The example below enables you to retrieve all the event types that one can subscribe to in Orchestrator.
GET
{OrchestratorURL}/odata/Webhooks/UiPath.Server.Configuration.OData.GetEventTypes()
Request headers
|
Key |
Value |
|---|---|
|
Authorization |
Bearer |
Response code
200 OK
Response body
{
"@odata.context": "{OrchestratorURL}/odata/$metadata#Collection(UiPath.Application.Dto.Webhooks.WebhookEventTypeDto)",
"value": [
{
"Name": "process.created",
"Group": "process"
},
{
"Name": "process.updated",
"Group": "process"
},
{
"Name": "process.deleted",
"Group": "process"
},
{
"Name": "schedule.failed",
"Group": "schedule"
},
{
"Name": "robot.status",
"Group": "robot"
},
{
"Name": "job.started",
"Group": "job"
},
{
"Name": "job.completed",
"Group": "job"
},
{
"Name": "job.faulted",
"Group": "job"
},
{
"Name": "job.stopped",
"Group": "job"
},
{
"Name": "job.created",
"Group": "job"
},
{
"Name": "queue.created",
"Group": "queue"
},
{
"Name": "queue.updated",
"Group": "queue"
},
{
"Name": "queue.deleted",
"Group": "queue"
},
{
"Name": "queueItem.added",
"Group": "queueItem"
},
{
"Name": "queueItem.transactionStarted",
"Group": "queueItem"
},
{
"Name": "queueItem.transactionFailed",
"Group": "queueItem"
},
{
"Name": "queueItem.transactionCompleted",
"Group": "queueItem"
},
{
"Name": "queueItem.transactionAbandoned",
"Group": "queueItem"
},
{
"Name": "robot.created",
"Group": "robot"
},
{
"Name": "robot.updated",
"Group": "robot"
},
{
"Name": "robot.deleted",
"Group": "robot"
}
]
}{
"@odata.context": "{OrchestratorURL}/odata/$metadata#Collection(UiPath.Application.Dto.Webhooks.WebhookEventTypeDto)",
"value": [
{
"Name": "process.created",
"Group": "process"
},
{
"Name": "process.updated",
"Group": "process"
},
{
"Name": "process.deleted",
"Group": "process"
},
{
"Name": "schedule.failed",
"Group": "schedule"
},
{
"Name": "robot.status",
"Group": "robot"
},
{
"Name": "job.started",
"Group": "job"
},
{
"Name": "job.completed",
"Group": "job"
},
{
"Name": "job.faulted",
"Group": "job"
},
{
"Name": "job.stopped",
"Group": "job"
},
{
"Name": "job.created",
"Group": "job"
},
{
"Name": "queue.created",
"Group": "queue"
},
{
"Name": "queue.updated",
"Group": "queue"
},
{
"Name": "queue.deleted",
"Group": "queue"
},
{
"Name": "queueItem.added",
"Group": "queueItem"
},
{
"Name": "queueItem.transactionStarted",
"Group": "queueItem"
},
{
"Name": "queueItem.transactionFailed",
"Group": "queueItem"
},
{
"Name": "queueItem.transactionCompleted",
"Group": "queueItem"
},
{
"Name": "queueItem.transactionAbandoned",
"Group": "queueItem"
},
{
"Name": "robot.created",
"Group": "robot"
},
{
"Name": "robot.updated",
"Group": "robot"
},
{
"Name": "robot.deleted",
"Group": "robot"
}
]
}The example below changes the
Url, Enabled state, Secret, AllowInsecureSsl, and the Events the webhook with the 10 Id is subscribed to.
PUT
{OrchestratorURL}/odata/Webhooks(10)
Request headers
|
Key |
Value |
|---|---|
|
Authorization |
Bearer |
Request body
{
"Url": "https://orchestrator.uipath.com/reference",
"Enabled": false,
"Secret": "This is a new secret.",
"AllowInsecureSsl": true,
"Events": [{
"EventType": "process.created"
},
{
"EventType": "queue.created"
},
{
"EventType": "robot.deleted"
}
]
}{
"Url": "https://orchestrator.uipath.com/reference",
"Enabled": false,
"Secret": "This is a new secret.",
"AllowInsecureSsl": true,
"Events": [{
"EventType": "process.created"
},
{
"EventType": "queue.created"
},
{
"EventType": "robot.deleted"
}
]
}Response code
200 OK
Response body
{
"@odata.context": "{OrchestratorURL}/odata/$metadata#Webhooks/$entity",
"Url": "https://orchestrator.uipath.com/reference",
"Enabled": false,
"Secret": "This is a new secret.",
"SubscribeToAllEvents": false,
"AllowInsecureSsl": true,
"Id": 10,
"Events": [
{
"EventType": "process.created"
},
{
"EventType": "queue.created"
},
{
"EventType": "robot.deleted"
}
]
}{
"@odata.context": "{OrchestratorURL}/odata/$metadata#Webhooks/$entity",
"Url": "https://orchestrator.uipath.com/reference",
"Enabled": false,
"Secret": "This is a new secret.",
"SubscribeToAllEvents": false,
"AllowInsecureSsl": true,
"Id": 10,
"Events": [
{
"EventType": "process.created"
},
{
"EventType": "queue.created"
},
{
"EventType": "robot.deleted"
}
]
}The following request enables you to test the target URL, and, if successful, it returns a
ping type of event, its Id, TenantId, OrganizationUnitId, and UserId.
POST
{OrchestratorURL}/odata/Webhooks(11)/UiPath.Server.Configuration.OData.Ping
Request headers
|
Key |
Value |
|---|---|
|
Authorization |
Bearer |
Response code
200 OK
Response body
{
"@odata.context": "{OrchestratorURL}/odata/$metadata#UiPath.Webhooks.Dto.PingEventDto",
"Type": "ping",
"EventId": "c3319a2d83c44b2f989bdd7eba1f0297",
"Timestamp": "2018-11-19T14:32:47.6024779Z",
"TenantId": 57,
"OrganizationUnitId": null,
"UserId": 583
}{
"@odata.context": "{OrchestratorURL}/odata/$metadata#UiPath.Webhooks.Dto.PingEventDto",
"Type": "ping",
"EventId": "c3319a2d83c44b2f989bdd7eba1f0297",
"Timestamp": "2018-11-19T14:32:47.6024779Z",
"TenantId": 57,
"OrganizationUnitId": null,
"UserId": 583
}