@botpress/api 0.12.5 → 0.13.0

package/dist/gen/state.d.ts

@@ -252,6 +252,155 @@ export declare const state: {
                 };
             };
         };
+        listParticipants: {
+            name: string;
+            description: string;
+            method: "get";
+            path: string;
+            parameters: {
+                nextToken: {
+                    in: "query";
+                    description: string;
+                    type: "string";
+                };
+                id: {
+                    in: "path";
+                    type: "string";
+                    description: string;
+                };
+            };
+            section: "conversation";
+            response: {
+                description: string;
+                schema: {
+                    type: "object";
+                    properties: {
+                        participants: {
+                            type: "array";
+                            items: {
+                                $ref: string;
+                            };
+                        };
+                        meta: {
+                            type: "object";
+                            properties: {
+                                nextToken: {
+                                    type: "string";
+                                    description: string;
+                                };
+                            };
+                            additionalProperties: false;
+                        };
+                    };
+                    required: string[];
+                    title: string;
+                    additionalProperties: false;
+                };
+            };
+        };
+        addParticipant: {
+            name: string;
+            description: string;
+            method: "post";
+            path: string;
+            parameters: {
+                id: {
+                    in: "path";
+                    type: "string";
+                    description: string;
+                };
+            };
+            requestBody: {
+                description: string;
+                schema: {
+                    type: "object";
+                    properties: {
+                        userId: {
+                            type: "string";
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                    title: string;
+                    additionalProperties: false;
+                };
+            };
+            section: "conversation";
+            response: {
+                description: string;
+                schema: {
+                    type: "object";
+                    properties: {
+                        participant: {
+                            $ref: string;
+                        };
+                    };
+                    required: string[];
+                    title: string;
+                    additionalProperties: false;
+                };
+            };
+        };
+        getParticipant: {
+            name: string;
+            description: string;
+            method: "get";
+            path: string;
+            parameters: {
+                id: {
+                    in: "path";
+                    type: "string";
+                    description: string;
+                };
+                userId: {
+                    in: "path";
+                    type: "string";
+                    description: string;
+                };
+            };
+            section: "conversation";
+            response: {
+                description: string;
+                schema: {
+                    type: "object";
+                    properties: {
+                        participant: {
+                            $ref: string;
+                        };
+                    };
+                    required: string[];
+                    title: string;
+                    additionalProperties: false;
+                };
+            };
+        };
+        removeParticipant: {
+            name: string;
+            description: string;
+            method: "delete";
+            path: string;
+            parameters: {
+                id: {
+                    in: "path";
+                    type: "string";
+                    description: string;
+                };
+                userId: {
+                    in: "path";
+                    type: "string";
+                    description: string;
+                };
+            };
+            section: "conversation";
+            response: {
+                description: string;
+                schema: {
+                    type: "object";
+                    title: string;
+                    additionalProperties: false;
+                };
+            };
+        };
         createEvent: {
             name: string;
             description: string;
@@ -3840,6 +3989,9 @@ export declare const state: {
                         identifier: {
                             type: "object";
                             properties: {
+                                fallbackHandlerScript: {
+                                    type: "string";
+                                };
                                 extractScript: {
                                     type: "string";
                                 };
@@ -4208,6 +4360,10 @@ export declare const state: {
                                     type: "string";
                                     nullable: true;
                                 };
+                                fallbackHandlerScript: {
+                                    type: "string";
+                                    nullable: true;
+                                };
                             };
                             additionalProperties: false;
                         };
@@ -4984,6 +5140,7 @@ export declare const state: {
             createConversationBody: true;
             getOrCreateConversationBody: true;
             updateConversationBody: true;
+            addParticipantBody: true;
             createEventBody: true;
             createMessageBody: true;
             getOrCreateMessageBody: true;
@@ -5018,6 +5175,10 @@ export declare const state: {
             getOrCreateConversationResponse: true;
             updateConversationResponse: true;
             deleteConversationResponse: true;
+            listParticipantsResponse: true;
+            addParticipantResponse: true;
+            getParticipantResponse: true;
+            removeParticipantResponse: true;
             createEventResponse: true;
             getEventResponse: true;
             listEventsResponse: true;
@@ -5449,6 +5610,10 @@ export declare const state: {
                     identifier: {
                         type: "object";
                         properties: {
+                            fallbackHandlerScript: {
+                                type: "string";
+                                description: string;
+                            };
                             extractScript: {
                                 type: "string";
                                 description: string;

package/dist/index.js

@@ -426136,6 +426136,155 @@ var state = {
         }
       }
     },
+    listParticipants: {
+      name: "listParticipants",
+      description: "Retrieves a list of [Participant](#schema_participant) for a given [Conversation](#schema_conversation).",
+      method: "get",
+      path: "/v1/chat/conversations/{id}/participants",
+      parameters: {
+        nextToken: {
+          in: "query",
+          description: "Provide the `meta.nextToken` value provided in the last API response to retrieve the next page of results",
+          type: "string"
+        },
+        id: {
+          in: "path",
+          type: "string",
+          description: "Conversation id"
+        }
+      },
+      section: "conversation",
+      response: {
+        description: "Returns a list of [Participant](#schema_participant) objects",
+        schema: {
+          type: "object",
+          properties: {
+            participants: {
+              type: "array",
+              items: {
+                $ref: "#/components/schemas/User"
+              }
+            },
+            meta: {
+              type: "object",
+              properties: {
+                nextToken: {
+                  type: "string",
+                  description: "The token to use to retrieve the next page of results, passed as a query string parameter (value should be URL-encoded) to this API endpoint."
+                }
+              },
+              additionalProperties: false
+            }
+          },
+          required: ["participants", "meta"],
+          title: "listParticipantsResponse",
+          additionalProperties: false
+        }
+      }
+    },
+    addParticipant: {
+      name: "addParticipant",
+      description: "Add a [Participant](#schema_participant) to a [Conversation](#schema_conversation).",
+      method: "post",
+      path: "/v1/chat/conversations/{id}/participants",
+      parameters: {
+        id: {
+          in: "path",
+          type: "string",
+          description: "Conversation id"
+        }
+      },
+      requestBody: {
+        description: "Participant data",
+        schema: {
+          type: "object",
+          properties: {
+            userId: {
+              type: "string",
+              description: "User id"
+            }
+          },
+          required: ["userId"],
+          title: "addParticipantBody",
+          additionalProperties: false
+        }
+      },
+      section: "conversation",
+      response: {
+        description: "Returns the [Participant](#schema_participant) object",
+        schema: {
+          type: "object",
+          properties: {
+            participant: {
+              $ref: "#/components/schemas/User"
+            }
+          },
+          required: ["participant"],
+          title: "addParticipantResponse",
+          additionalProperties: false
+        }
+      }
+    },
+    getParticipant: {
+      name: "getParticipant",
+      description: "Retrieves a [Participant](#schema_participant) from a [Conversation](#schema_conversation).",
+      method: "get",
+      path: "/v1/chat/conversations/{id}/participants/{userId}",
+      parameters: {
+        id: {
+          in: "path",
+          type: "string",
+          description: "Conversation id"
+        },
+        userId: {
+          in: "path",
+          type: "string",
+          description: "User id"
+        }
+      },
+      section: "conversation",
+      response: {
+        description: "Returns the [Participant](#schema_participant) object",
+        schema: {
+          type: "object",
+          properties: {
+            participant: {
+              $ref: "#/components/schemas/User"
+            }
+          },
+          required: ["participant"],
+          title: "getParticipantResponse",
+          additionalProperties: false
+        }
+      }
+    },
+    removeParticipant: {
+      name: "removeParticipant",
+      description: "Remove a [Participant](#schema_participant) from a [Conversation](#schema_conversation).",
+      method: "delete",
+      path: "/v1/chat/conversations/{id}/participants/{userId}",
+      parameters: {
+        id: {
+          in: "path",
+          type: "string",
+          description: "Conversation id"
+        },
+        userId: {
+          in: "path",
+          type: "string",
+          description: "User id"
+        }
+      },
+      section: "conversation",
+      response: {
+        description: "Returns an empty object",
+        schema: {
+          type: "object",
+          title: "removeParticipantResponse",
+          additionalProperties: false
+        }
+      }
+    },
     createEvent: {
       name: "createEvent",
       description: "Creates a new [Event](#schema_event). When creating a new [Event](#schema_event), the required tags must be provided. See the specific integration for more details.",
@@ -427298,7 +427447,7 @@ var state = {
                 properties: {
                   id: {
                     type: "string",
-                    description: "Id of the [Integration](#schema_integration)"
+                    description: "ID of the [Integration](#schema_integration)"
                   },
                   name: {
                     type: "string",
@@ -429942,6 +430091,9 @@ var state = {
             identifier: {
               type: "object",
               properties: {
+                fallbackHandlerScript: {
+                  type: "string"
+                },
                 extractScript: {
                   type: "string"
                 }
@@ -430309,6 +430461,10 @@ var state = {
                 extractScript: {
                   type: "string",
                   nullable: true
+                },
+                fallbackHandlerScript: {
+                  type: "string",
+                  nullable: true
                 }
               },
               additionalProperties: false
@@ -430533,7 +430689,7 @@ var state = {
                 properties: {
                   id: {
                     type: "string",
-                    description: "Id of the [Integration](#schema_integration)"
+                    description: "ID of the [Integration](#schema_integration)"
                   },
                   name: {
                     type: "string",
@@ -431065,7 +431221,7 @@ var state = {
     title: "Botpress API",
     description: "API for Botpress Cloud",
     server: "https://api.botpress.cloud",
-    version: "0.12.5",
+    version: "0.13.0",
     prefix: "v1"
   },
   errors: [
@@ -431181,6 +431337,7 @@ var state = {
       createConversationBody: true,
       getOrCreateConversationBody: true,
       updateConversationBody: true,
+      addParticipantBody: true,
       createEventBody: true,
       createMessageBody: true,
       getOrCreateMessageBody: true,
@@ -431215,6 +431372,10 @@ var state = {
       getOrCreateConversationResponse: true,
       updateConversationResponse: true,
       deleteConversationResponse: true,
+      listParticipantsResponse: true,
+      addParticipantResponse: true,
+      getParticipantResponse: true,
+      removeParticipantResponse: true,
       createEventResponse: true,
       getEventResponse: true,
       listEventsResponse: true,
@@ -431376,7 +431537,7 @@ var state = {
                 },
                 id: {
                   type: "string",
-                  description: "Id of the [Integration](#schema_integration)"
+                  description: "ID of the [Integration](#schema_integration)"
                 },
                 createdAt: {
                   type: "string",
@@ -431669,7 +431830,7 @@ var state = {
         properties: {
           id: {
             type: "string",
-            description: "Id of the [Integration](#schema_integration)"
+            description: "ID of the [Integration](#schema_integration)"
           },
           createdAt: {
             type: "string",
@@ -431684,6 +431845,10 @@ var state = {
           identifier: {
             type: "object",
             properties: {
+              fallbackHandlerScript: {
+                type: "string",
+                description: "VRL Script of the [Integration](#schema_integration) to handle incoming requests for a request that doesn't have an identifier"
+              },
               extractScript: {
                 type: "string",
                 description: "VRL Script of the [Integration](#schema_integration) to extract the identifier from an incoming webhook often use for OAuth"
@@ -432580,7 +432745,11 @@ var state = {
         "listConversations",
         "getOrCreateConversation",
         "updateConversation",
-        "deleteConversation"
+        "deleteConversation",
+        "listParticipants",
+        "addParticipant",
+        "getParticipant",
+        "removeParticipant"
       ],
       schema: "Conversation"
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botpress/api",
-  "version": "0.12.5",
+  "version": "0.13.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/gen/metadata.json

@@ -1 +1 @@
-{"sections":[{"description":"","title":"User","name":"user","operations":["createUser","getUser","listUsers","getOrCreateUser","updateUser","deleteUser"],"schema":"User"},{"description":"","title":"Conversation","name":"conversation","operations":["createConversation","getConversation","listConversations","getOrCreateConversation","updateConversation","deleteConversation"],"schema":"Conversation"},{"description":"","title":"Event","name":"event","operations":["createEvent","getEvent","listEvents"],"schema":"Event"},{"description":"","title":"Message","name":"message","operations":["createMessage","getOrCreateMessage","getMessage","updateMessage","listMessages","deleteMessage"],"schema":"Message"},{"description":"","title":"File","name":"file","operations":["createFile","getFile","downloadFile","deleteFile","listFiles"],"schema":"File"},{"description":"","title":"State","name":"state","operations":["getState","setState","patchState"],"schema":"State"},{"description":"","title":"Hub","name":"hub","operations":["listPublicIntegrations","getPublicIntegrationById","getPublicIntegration"]},{"description":"","title":"Action","name":"action","operations":["callAction"]},{"description":"","title":"Bot","name":"bot","operations":["createBot","updateBot","transferBot","listBots","getBot","deleteBot","getBotLogs","getBotWebchat","getBotAnalytics","listBotIssues","deleteBotIssue","listBotIssueEvents"],"schema":"Bot"},{"description":"","title":"Integration","name":"integration","operations":["createIntegration","updateIntegration","listIntegrations","getIntegration","getIntegrationLogs","getIntegrationByName","deleteIntegration"],"schema":"Integration"},{"description":"","title":"Workspace","name":"workspace","operations":["getWorkspaceBillingDetails","setWorkspacePaymentMethod","listWorkspaceInvoices","chargeWorkspaceUnpaidInvoices","createWorkspace","getWorkspace","listWorkspaceUsages","getWorkspaceQuota","listWorkspaceQuotas","updateWorkspace","listWorkspaces","changeWorkspacePlan","deleteWorkspace","getAuditRecords"],"schema":"Workspace"},{"description":"","title":"Workspace Member","name":"workspaceMember","operations":["listWorkspaceMembers","deleteWorkspaceMember","createWorkspaceMember","updateWorkspaceMember"],"schema":"WorkspaceMember"},{"description":"","title":"Account","name":"account","operations":["getAccount","listPersonalAccessTokens","createPersonalAccessToken","deletePersonalAccessToken"],"schema":"Account"},{"description":"","title":"Usage","name":"usage","operations":["getUsage"],"schema":"Usage"}],"errors":[{"status":500,"type":"Unknown","description":"An unknown error occurred"},{"status":500,"type":"Internal","description":"An internal error occurred"},{"status":401,"type":"Unauthorized","description":"The request requires to be authenticated."},{"status":403,"type":"Forbidden","description":"The requested action can't be peform by this resource."},{"status":413,"type":"PayloadTooLarge","description":"The request payload is too large."},{"status":400,"type":"InvalidPayload","description":"The request payload is invalid."},{"status":415,"type":"UnsupportedMediaType","description":"The request is invalid because the content-type is not supported."},{"status":405,"type":"MethodNotFound","description":"The requested method does not exist."},{"status":404,"type":"ResourceNotFound","description":"The requested resource does not exist."},{"status":400,"type":"InvalidJsonSchema","description":"The provided JSON schema is invalid."},{"status":400,"type":"InvalidDataFormat","description":"The provided data doesn't respect the provided JSON schema."},{"status":400,"type":"InvalidIdentifier","description":"The provided identifier is not valid. An identifier must start with a lowercase letter, be between 2 and 100 characters long and use only alphanumeric characters."},{"status":409,"type":"RelationConflict","description":"The resource is not related with another resource. This is usually caused when providing two resources that aren't linked together."},{"status":400,"type":"ReferenceNotFound","description":"The provided resource reference is missing. This is usually caused when providing an invalid id inside the payload of a request."},{"status":400,"type":"InvalidQuery","description":"The provided query is invalid. This is usually caused when providing an invalid parameter for querying a resource."},{"status":400,"type":"Runtime","description":"An error happened during the execution of a runtime (bot or integration)."},{"status":409,"type":"AlreadyExists","description":"The record attempted to be created already exists."},{"status":429,"type":"RateLimited","description":"The request has been rate limited."},{"status":402,"type":"PaymentRequired","description":"A payment is required to perform this request."},{"status":403,"type":"QuotaExceeded","description":"The request exceeds the allowed quota. Quotas are a soft limit that can be increased."},{"status":413,"type":"LimitExceeded","description":"The request exceeds the allowed limit. Limits are a hard limit that cannot be increased."}]}
+{"sections":[{"description":"","title":"User","name":"user","operations":["createUser","getUser","listUsers","getOrCreateUser","updateUser","deleteUser"],"schema":"User"},{"description":"","title":"Conversation","name":"conversation","operations":["createConversation","getConversation","listConversations","getOrCreateConversation","updateConversation","deleteConversation","listParticipants","addParticipant","getParticipant","removeParticipant"],"schema":"Conversation"},{"description":"","title":"Event","name":"event","operations":["createEvent","getEvent","listEvents"],"schema":"Event"},{"description":"","title":"Message","name":"message","operations":["createMessage","getOrCreateMessage","getMessage","updateMessage","listMessages","deleteMessage"],"schema":"Message"},{"description":"","title":"File","name":"file","operations":["createFile","getFile","downloadFile","deleteFile","listFiles"],"schema":"File"},{"description":"","title":"State","name":"state","operations":["getState","setState","patchState"],"schema":"State"},{"description":"","title":"Hub","name":"hub","operations":["listPublicIntegrations","getPublicIntegrationById","getPublicIntegration"]},{"description":"","title":"Action","name":"action","operations":["callAction"]},{"description":"","title":"Bot","name":"bot","operations":["createBot","updateBot","transferBot","listBots","getBot","deleteBot","getBotLogs","getBotWebchat","getBotAnalytics","listBotIssues","deleteBotIssue","listBotIssueEvents"],"schema":"Bot"},{"description":"","title":"Integration","name":"integration","operations":["createIntegration","updateIntegration","listIntegrations","getIntegration","getIntegrationLogs","getIntegrationByName","deleteIntegration"],"schema":"Integration"},{"description":"","title":"Workspace","name":"workspace","operations":["getWorkspaceBillingDetails","setWorkspacePaymentMethod","listWorkspaceInvoices","chargeWorkspaceUnpaidInvoices","createWorkspace","getWorkspace","listWorkspaceUsages","getWorkspaceQuota","listWorkspaceQuotas","updateWorkspace","listWorkspaces","changeWorkspacePlan","deleteWorkspace","getAuditRecords"],"schema":"Workspace"},{"description":"","title":"Workspace Member","name":"workspaceMember","operations":["listWorkspaceMembers","deleteWorkspaceMember","createWorkspaceMember","updateWorkspaceMember"],"schema":"WorkspaceMember"},{"description":"","title":"Account","name":"account","operations":["getAccount","listPersonalAccessTokens","createPersonalAccessToken","deletePersonalAccessToken"],"schema":"Account"},{"description":"","title":"Usage","name":"usage","operations":["getUsage"],"schema":"Usage"}],"errors":[{"status":500,"type":"Unknown","description":"An unknown error occurred"},{"status":500,"type":"Internal","description":"An internal error occurred"},{"status":401,"type":"Unauthorized","description":"The request requires to be authenticated."},{"status":403,"type":"Forbidden","description":"The requested action can't be peform by this resource."},{"status":413,"type":"PayloadTooLarge","description":"The request payload is too large."},{"status":400,"type":"InvalidPayload","description":"The request payload is invalid."},{"status":415,"type":"UnsupportedMediaType","description":"The request is invalid because the content-type is not supported."},{"status":405,"type":"MethodNotFound","description":"The requested method does not exist."},{"status":404,"type":"ResourceNotFound","description":"The requested resource does not exist."},{"status":400,"type":"InvalidJsonSchema","description":"The provided JSON schema is invalid."},{"status":400,"type":"InvalidDataFormat","description":"The provided data doesn't respect the provided JSON schema."},{"status":400,"type":"InvalidIdentifier","description":"The provided identifier is not valid. An identifier must start with a lowercase letter, be between 2 and 100 characters long and use only alphanumeric characters."},{"status":409,"type":"RelationConflict","description":"The resource is not related with another resource. This is usually caused when providing two resources that aren't linked together."},{"status":400,"type":"ReferenceNotFound","description":"The provided resource reference is missing. This is usually caused when providing an invalid id inside the payload of a request."},{"status":400,"type":"InvalidQuery","description":"The provided query is invalid. This is usually caused when providing an invalid parameter for querying a resource."},{"status":400,"type":"Runtime","description":"An error happened during the execution of a runtime (bot or integration)."},{"status":409,"type":"AlreadyExists","description":"The record attempted to be created already exists."},{"status":429,"type":"RateLimited","description":"The request has been rate limited."},{"status":402,"type":"PaymentRequired","description":"A payment is required to perform this request."},{"status":403,"type":"QuotaExceeded","description":"The request exceeds the allowed quota. Quotas are a soft limit that can be increased."},{"status":413,"type":"LimitExceeded","description":"The request exceeds the allowed limit. Limits are a hard limit that cannot be increased."}]}