uip or webhooks

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

Gérer les webhooks Orchestrator — Rappels HTTP déclenchés sur les événements de la plateforme (achèvement de la tâche, échec de l'élément de la file d'attente, etc.). Les Webhooks sont à l’échelle du locataire.

Pour les conventions multi-ressources (authentification, types de clés, enveloppe de sortie), consultez la vue d’ensembleuip or .

Synthèse

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.

Créer

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"

Mettre à jour

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

Supprimer (Delete)

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

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

Résolution des problèmes

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.

Types d'événements

Répertorie chaque type d’événement auquel un Webhook peut s’abonner. Utilisez les noms renvoyés avec create --events ou update --events.

uip or webhooks event-types

Codes de sortie

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

Voir également

• Vue d’ensemble deuip or — conventions partagées pour chaque uip or verbe.
• Procédures: gérer les ressources et les files d'attente Orchestrator — modèles de création de webhook.