@qlik/api 1.20.0 → 1.22.0

package/webhooks.d.ts

@@ -1,4 +1,4 @@
-import { A as ApiCallOptions } from './global.types--37uwGji.js';
+import { A as ApiCallOptions } from './global.types-qsBNouXJ.js';
 import './auth-types-PkN9CAF_.js';
 
 type Delivery = {
@@ -84,7 +84,7 @@ type WebhookBase = {
     readonly disabledReasonCode?: string;
     /** Whether the webhook is active and sending requests */
     enabled?: boolean;
-    /** Types of events for which the webhook should trigger. */
+    /** Types of events for which the webhook should trigger. Retrieve available types from `/v1/webhooks/event-types`. */
     eventTypes?: string[];
     /** Filter that should match for a webhook to be triggered.
      * Supported common attribute names are 'id', 'spaceId' and 'topLevelResourceId', beside the common attributes the "com.qlik.v1.app.reload.finished" event also supports "data.status" that could be either "ok" or "error" but can't be used together with other event types.
@@ -140,7 +140,7 @@ type WebhookResponse = WebhookBase & {
     readonly origin?: "api" | "automations" | "management-console";
 };
 /**
- * Retrieves all webhooks entries for a tenant
+ * Retrieves all webhooks entries for a tenant that the user has access to. Users assigned the `TenantAdmin` role can retrieve all webhooks. A user can have up to 150 webhooks at one time.
  *
  * @param query an object with query parameters
  * @throws GetWebhooksHttpError
@@ -186,7 +186,7 @@ type GetWebhooksHttpError = {
     status: number;
 };
 /**
- * Creates a new webhook
+ * Creates a new webhook. User must be assigned the `TenantAdmin` role to create `tenant` level webhooks.
  *
  * @param body an object with the body content
  * @throws CreateWebhookHttpError
@@ -203,7 +203,7 @@ type CreateWebhookHttpError = {
     status: number;
 };
 /**
- * List of event-types that are possible to subscribe to.
+ * Lists event-types that are possible to subscribe to.
  *
  * @throws GetWebhookEventTypesHttpError
  */
@@ -219,7 +219,7 @@ type GetWebhookEventTypesHttpError = {
     status: number;
 };
 /**
- * Deletes a specific webhook
+ * Deletes a specific webhook.
  *
  * @param id The webhook's unique identifier.
  * @throws DeleteWebhookHttpError
@@ -236,7 +236,7 @@ type DeleteWebhookHttpError = {
     status: number;
 };
 /**
- * Returns details for a specific webhook
+ * Returns details for a specific webhook.
  *
  * @param id The webhook's unique identifier.
  * @throws GetWebhookHttpError
@@ -253,7 +253,7 @@ type GetWebhookHttpError = {
     status: number;
 };
 /**
- * Patches a webhook
+ * Patches a webhook to update one or more properties.
  *
  * @param id The webhook's unique identifier.
  * @param body an object with the body content
@@ -271,7 +271,7 @@ type PatchWebhookHttpError = {
     status: number;
 };
 /**
- * Updates a webhook
+ * Updates a webhook, any omitted fields will be cleared, returns updated webhook.
  *
  * @param id The webhook's unique identifier.
  * @param body an object with the body content
@@ -289,7 +289,7 @@ type UpdateWebhookHttpError = {
     status: number;
 };
 /**
- * Returns deliveries for a specific webhook
+ * Returns deliveries for a specific webhook. Delivery history is stored for 1 week.
  *
  * @param id The webhook's unique identifier.
  * @param query an object with query parameters
@@ -322,7 +322,7 @@ type GetWebhookDeliveriesHttpError = {
     status: number;
 };
 /**
- * Returns details for a specific delivery
+ * Returns details for a specific delivery.
  *
  * @param id The webhook's unique identifier.
  * @param deliveryId The delivery's unique identifier.
@@ -340,7 +340,7 @@ type GetWebhookDeliveryHttpError = {
     status: number;
 };
 /**
- * Resend the delivery with the same payload
+ * Resends the delivery with the same payload.
  *
  * @param id The webhook's unique identifier.
  * @param deliveryId The delivery's unique identifier.
@@ -363,41 +363,41 @@ type ResendWebhookDeliveryHttpError = {
 declare function clearCache(): void;
 interface WebhooksAPI {
     /**
-     * Retrieves all webhooks entries for a tenant
+     * Retrieves all webhooks entries for a tenant that the user has access to. Users assigned the `TenantAdmin` role can retrieve all webhooks. A user can have up to 150 webhooks at one time.
      *
      * @param query an object with query parameters
      * @throws GetWebhooksHttpError
      */
     getWebhooks: typeof getWebhooks;
     /**
-     * Creates a new webhook
+     * Creates a new webhook. User must be assigned the `TenantAdmin` role to create `tenant` level webhooks.
      *
      * @param body an object with the body content
      * @throws CreateWebhookHttpError
      */
     createWebhook: typeof createWebhook;
     /**
-     * List of event-types that are possible to subscribe to.
+     * Lists event-types that are possible to subscribe to.
      *
      * @throws GetWebhookEventTypesHttpError
      */
     getWebhookEventTypes: typeof getWebhookEventTypes;
     /**
-     * Deletes a specific webhook
+     * Deletes a specific webhook.
      *
      * @param id The webhook's unique identifier.
      * @throws DeleteWebhookHttpError
      */
     deleteWebhook: typeof deleteWebhook;
     /**
-     * Returns details for a specific webhook
+     * Returns details for a specific webhook.
      *
      * @param id The webhook's unique identifier.
      * @throws GetWebhookHttpError
      */
     getWebhook: typeof getWebhook;
     /**
-     * Patches a webhook
+     * Patches a webhook to update one or more properties.
      *
      * @param id The webhook's unique identifier.
      * @param body an object with the body content
@@ -405,7 +405,7 @@ interface WebhooksAPI {
      */
     patchWebhook: typeof patchWebhook;
     /**
-     * Updates a webhook
+     * Updates a webhook, any omitted fields will be cleared, returns updated webhook.
      *
      * @param id The webhook's unique identifier.
      * @param body an object with the body content
@@ -413,7 +413,7 @@ interface WebhooksAPI {
      */
     updateWebhook: typeof updateWebhook;
     /**
-     * Returns deliveries for a specific webhook
+     * Returns deliveries for a specific webhook. Delivery history is stored for 1 week.
      *
      * @param id The webhook's unique identifier.
      * @param query an object with query parameters
@@ -421,7 +421,7 @@ interface WebhooksAPI {
      */
     getWebhookDeliveries: typeof getWebhookDeliveries;
     /**
-     * Returns details for a specific delivery
+     * Returns details for a specific delivery.
      *
      * @param id The webhook's unique identifier.
      * @param deliveryId The delivery's unique identifier.
@@ -429,7 +429,7 @@ interface WebhooksAPI {
      */
     getWebhookDelivery: typeof getWebhookDelivery;
     /**
-     * Resend the delivery with the same payload
+     * Resends the delivery with the same payload.
      *
      * @param id The webhook's unique identifier.
      * @param deliveryId The delivery's unique identifier.

package/webhooks.js

@@ -1,8 +1,8 @@
 import {
   clearApiCache,
   invokeFetch
-} from "./chunks/T6AQ34ZJ.js";
-import "./chunks/IMLCMV4X.js";
+} from "./chunks/TUPLQG25.js";
+import "./chunks/SNQHDUYY.js";
 import "./chunks/2ZQ3ZX7F.js";
 
 // src/public/rest/webhooks.ts