uip or webhooks

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

Gerenciar webhooks do Orchestrator — Retornos de chamada HTTP disparados em eventos de plataforma (conclusão de trabalho, falha de item da fila e assim por diante). Os webhooks têm o escopo de tenant.

Para as convenções entre recursos (autenticação, tipos de chave, envelope de saída), consulte a visão geraluip or .

Resumo

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

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.

Criar

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"

Atualizar

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

Excluir

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.

Tipos de eventos

Liste cada tipo de evento que um webhook pode se inscrever. Use os nomes retornados com create --events ou update --events.

uip or webhooks event-types

Códigos de saída

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

Veja também

• Visão geraluip or — convenções compartilhadas para cada verbo uip or .
• Como fazer: gerenciar ativos e filas do Orchestrator — padrões de criação de webhooks.