uip or webhooks

Syntax and options for `uip or webhooks`, which manages Orchestrator HTTP callbacks fired on platform events.

管理 Orchestrator Webhook — 在平台事件（作业完成、队列项目失败等）时触发的 HTTP 回调。Webhook 在租户范围内。

有关跨资源约定（身份验证、密钥类型、输出信封），请参阅uip or概述。

大纲

uip or webhooks list         [-n <name>] [--enabled | --disabled] [-l, --limit <n>] [--offset <n>] [--sort-by <field>] [--all-fields]
uip or webhooks get          <webhook-key> [--all-fields]
uip or webhooks create       <name> --url <url> [-d <desc>] [--events <list>] [--secret <s>] [--allow-insecure-ssl]
uip or webhooks update       <webhook-key> [flags as for create] [--enabled | --disabled]
uip or webhooks delete       <webhook-key> --yes
uip or webhooks ping         <webhook-key>
uip or webhooks event-types

列表

List webhooks. Filters: -n, --name, --enabled, --disabled (mutually exclusive). --sort-by <field> sorts results (default Id desc); --all-fields returns the full API response.

get

Get webhook details by key, including subscribed events and SSL settings. --all-fields returns the full API response.

创建

Create a webhook. Requires <name> and --url. Optional -d, --description, --events <comma-list> (omit to subscribe to all event types), --secret, --allow-insecure-ssl.

uip or webhooks create JobAlerts \
  --url https://hooks.example.com/uipath \
  --events "job.completed,job.faulted"

更新

Update by key. Providing --events switches the webhook from subscribe-to-all to the given list. Pass --enabled or --disabled to toggle the webhook's state (mutually exclusive).

uip or webhooks update <webhook-key> --disabled

删除

Delete a webhook by key. Requires -y, --yes — the CLI never prompts for destructive operations.

uip or webhooks delete <webhook-key> --yes

Ping

Send a test ping to the webhook URL to verify connectivity. Delivery is asynchronous — a successful response means the ping was queued, not that the endpoint received it; confirm receipt on the endpoint itself.

事件类型

列出 Webhook 可以订阅的所有事件类型。将返回的名称与create --events或update --events一起使用。

uip or webhooks event-types

退出代码

See Exit codes for the shared contract. delete exits 1 if -y, --yes is omitted.

另请参阅

• uip or概述— 每个uip or动词的共享约定。
• 操作方法：管理 Orchestrator 资产和队列— Webhook 创建模式。