@botpress/api 1.47.0 → 1.48.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (25) hide show
  1. package/.eslintrc.js +6 -0
  2. package/.turbo/turbo-openapi.log +6 -6
  3. package/dist/index.js +19056 -30211
  4. package/dist/src/gen/admin/state.d.ts +11 -1004
  5. package/dist/src/gen/files/state.d.ts +44 -3041
  6. package/dist/src/gen/runtime/state.d.ts +115 -2700
  7. package/dist/src/gen/state.d.ts +7 -0
  8. package/dist/src/gen/tables/state.d.ts +19 -2762
  9. package/dist/src/index.d.ts +10 -10
  10. package/package.json +5 -3
  11. package/src/gen/admin/metadata.json +1 -1
  12. package/src/gen/admin/openapi.json +1 -1
  13. package/src/gen/admin/state.ts +97 -1296
  14. package/src/gen/files/metadata.json +1 -1
  15. package/src/gen/files/openapi.json +1 -1
  16. package/src/gen/files/state.ts +83 -3667
  17. package/src/gen/metadata.json +1 -1
  18. package/src/gen/openapi.json +1 -1
  19. package/src/gen/runtime/metadata.json +1 -1
  20. package/src/gen/runtime/openapi.json +1 -1
  21. package/src/gen/runtime/state.ts +16 -3122
  22. package/src/gen/state.ts +12 -4
  23. package/src/gen/tables/metadata.json +1 -1
  24. package/src/gen/tables/openapi.json +1 -1
  25. package/src/gen/tables/state.ts +98 -3392
package/src/gen/tables/state.ts CHANGED
@@ -2,7 +2,7 @@
2
2
  /* eslint-disable */
3
3
  /* prettier-ignore */
4
4
  import * as opapi from '@bpinternal/opapi'
5
- export type State = opapi.State<'Bot' | 'Integration' | 'Interface' | 'Plugin' | 'Workspace' | 'WorkspaceMember' | 'Account' | 'Usage' | 'Issue' | 'IssueEvent' | 'Activity' | 'Version' | 'User' | 'Conversation' | 'Event' | 'Message' | 'State' | 'Task' | 'Workflow' | 'Table' | 'Column' | 'Row' | 'File', never, 'user' | 'conversation' | 'event' | 'message' | 'state' | 'hub' | 'action' | 'task' | 'workflow' | 'tag' | 'bot' | 'integration' | 'interface' | 'plugin' | 'workspace' | 'workspaceMember' | 'account' | 'usage' | 'quotas' | 'helper' | 'activity' | 'tables' | 'files'>
5
+ export type State = opapi.State<'Table' | 'Column' | 'Row', never, 'tables'>
6
6
  export const state = {
7
7
  "operations": {
8
8
  "listTables": {
@@ -1007,7 +1007,8 @@ export const state = {
1007
1007
  "ids": {
1008
1008
  "type": "array",
1009
1009
  "items": {
1010
- "type": "number"
1010
+ "type": "number",
1011
+ "maximum": 2147483647
1011
1012
  },
1012
1013
  "maxItems": 1000
1013
1014
  },
@@ -1067,7 +1068,8 @@ export const state = {
1067
1068
  "type": "object",
1068
1069
  "properties": {
1069
1070
  "id": {
1070
- "type": "number"
1071
+ "type": "number",
1072
+ "maximum": 2147483647
1071
1073
  }
1072
1074
  },
1073
1075
  "required": [
@@ -1149,7 +1151,8 @@ export const state = {
1149
1151
  "type": "object",
1150
1152
  "properties": {
1151
1153
  "id": {
1152
- "type": "number"
1154
+ "type": "number",
1155
+ "maximum": 2147483647
1153
1156
  }
1154
1157
  },
1155
1158
  "additionalProperties": true
@@ -1220,10 +1223,10 @@ export const state = {
1220
1223
  }
1221
1224
  },
1222
1225
  "metadata": {
1223
- "title": "Botpress API",
1224
- "description": "API for Botpress Cloud",
1226
+ "title": "Botpress Tables API",
1227
+ "description": "API for Botpress Tables",
1225
1228
  "server": "https://api.botpress.cloud",
1226
- "version": "1.47.0",
1229
+ "version": "1.48.1",
1227
1230
  "prefix": "v1"
1228
1231
  },
1229
1232
  "errors": [
@@ -1303,3104 +1306,97 @@ export const state = {
1303
1306
  "description": "The resource is current locked and cannot be operated on until the lock is released."
1304
1307
  },
1305
1308
  {
1306
- "status": 400,
1307
- "type": "ReferenceNotFound",
1308
- "description": "The provided resource reference is missing. This is usually caused when providing an invalid id inside the payload of a request."
1309
- },
1310
- {
1311
- "status": 400,
1312
- "type": "InvalidQuery",
1313
- "description": "The provided query is invalid. This is usually caused when providing an invalid parameter for querying a resource."
1314
- },
1315
- {
1316
- "status": 400,
1317
- "type": "Runtime",
1318
- "description": "An error happened during the execution of a runtime (bot or integration)."
1319
- },
1320
- {
1321
- "status": 409,
1322
- "type": "AlreadyExists",
1323
- "description": "The record attempted to be created already exists."
1324
- },
1325
- {
1326
- "status": 429,
1327
- "type": "RateLimited",
1328
- "description": "The request has been rate limited."
1329
- },
1330
- {
1331
- "status": 402,
1332
- "type": "PaymentRequired",
1333
- "description": "A payment is required to perform this request."
1334
- },
1335
- {
1336
- "status": 403,
1337
- "type": "QuotaExceeded",
1338
- "description": "The request exceeds the allowed quota. Quotas are a soft limit that can be increased."
1339
- },
1340
- {
1341
- "status": 413,
1342
- "type": "LimitExceeded",
1343
- "description": "The request exceeds the allowed limit. Limits are a hard limit that cannot be increased."
1344
- },
1345
- {
1346
- "status": 400,
1347
- "type": "BreakingChanges",
1348
- "description": "Request payload contains breaking changes which is not allowed for this resource without a version increment."
1349
- }
1350
- ],
1351
- "refs": {
1352
- "parameters": {},
1353
- "requestBodies": {
1354
- "getOrCreateTableBody": true,
1355
- "createTableBody": true,
1356
- "duplicateTableBody": true,
1357
- "importTableBody": true,
1358
- "updateTableBody": true,
1359
- "renameTableColumnBody": true,
1360
- "findTableRowsBody": true,
1361
- "createTableRowsBody": true,
1362
- "deleteTableRowsBody": true,
1363
- "updateTableRowsBody": true,
1364
- "upsertTableRowsBody": true
1365
- },
1366
- "responses": {
1367
- "listTablesResponse": true,
1368
- "getTableResponse": true,
1369
- "getOrCreateTableResponse": true,
1370
- "createTableResponse": true,
1371
- "duplicateTableResponse": true,
1372
- "exportTableResponse": true,
1373
- "getTableJobsResponse": true,
1374
- "importTableResponse": true,
1375
- "updateTableResponse": true,
1376
- "renameTableColumnResponse": true,
1377
- "deleteTableResponse": true,
1378
- "getTableRowResponse": true,
1379
- "findTableRowsResponse": true,
1380
- "createTableRowsResponse": true,
1381
- "deleteTableRowsResponse": true,
1382
- "updateTableRowsResponse": true,
1383
- "upsertTableRowsResponse": true
1309
+ "status": 410,
1310
+ "type": "ResourceGone",
1311
+ "description": "The requested resource is no longer available."
1384
1312
  },
1385
- "schemas": {
1386
- "Bot": true,
1387
- "Integration": true,
1388
- "Interface": true,
1389
- "Plugin": true,
1390
- "Workspace": true,
1391
- "WorkspaceMember": true,
1392
- "Account": true,
1393
- "Usage": true,
1394
- "Issue": true,
1395
- "IssueEvent": true,
1396
- "Activity": true,
1397
- "Version": true,
1398
- "User": true,
1399
- "Conversation": true,
1400
- "Event": true,
1401
- "Message": true,
1402
- "State": true,
1403
- "Task": true,
1404
- "Workflow": true,
1405
- "Table": true,
1406
- "Column": true,
1407
- "Row": true,
1408
- "File": true
1409
- }
1410
- },
1411
- "schemas": {
1412
- "Bot": {
1413
- "section": "bot",
1414
- "schema": {
1415
- "type": "object",
1416
- "properties": {
1417
- "id": {
1418
- "type": "string",
1419
- "minLength": 28,
1420
- "maxLength": 36,
1421
- "description": "Id of the [Bot](#schema_bot)"
1422
- },
1423
- "createdAt": {
1424
- "type": "string",
1425
- "format": "date-time",
1426
- "description": "Creation date of the [Bot](#schema_bot) in ISO 8601 format"
1427
- },
1428
- "updatedAt": {
1429
- "type": "string",
1430
- "format": "date-time",
1431
- "description": "Updating date of the [Bot](#schema_bot) in ISO 8601 format"
1432
- },
1433
- "signingSecret": {
1434
- "type": "string",
1435
- "maxLength": 2000,
1436
- "description": "Signing secret of the [Bot](#schema_bot)"
1437
- },
1438
- "integrations": {
1439
- "type": "object",
1440
- "additionalProperties": {
1441
- "type": "object",
1442
- "properties": {
1443
- "enabled": {
1444
- "type": "boolean"
1445
- },
1446
- "name": {
1447
- "type": "string",
1448
- "maxLength": 200,
1449
- "description": "Name of the [Integration](#schema_integration)"
1450
- },
1451
- "version": {
1452
- "type": "string",
1453
- "maxLength": 200,
1454
- "description": "Version of the [Integration](#schema_integration)"
1455
- },
1456
- "webhookUrl": {
1457
- "type": "string",
1458
- "maxLength": 2000
1459
- },
1460
- "webhookId": {
1461
- "type": "string",
1462
- "maxLength": 200
1463
- },
1464
- "identifier": {
1465
- "type": "string",
1466
- "maxLength": 2000
1467
- },
1468
- "configurationType": {
1469
- "type": "string",
1470
- "maxLength": 200,
1471
- "nullable": true
1472
- },
1473
- "configuration": {
1474
- "type": "object",
1475
- "additionalProperties": true
1476
- },
1477
- "status": {
1478
- "type": "string",
1479
- "enum": [
1480
- "registration_pending",
1481
- "registered",
1482
- "registration_failed",
1483
- "unregistration_pending",
1484
- "unregistered",
1485
- "unregistration_failed"
1486
- ]
1487
- },
1488
- "statusReason": {
1489
- "type": "string",
1490
- "maxLength": 2000,
1491
- "nullable": true
1492
- },
1493
- "disabledChannels": {
1494
- "type": "array",
1495
- "items": {
1496
- "type": "string",
1497
- "description": "Channel name"
1498
- },
1499
- "description": "Disabled channels for this integration"
1500
- },
1501
- "id": {
1502
- "type": "string",
1503
- "minLength": 28,
1504
- "maxLength": 36,
1505
- "description": "ID of the [Integration](#schema_integration)"
1506
- },
1507
- "createdAt": {
1508
- "type": "string",
1509
- "format": "date-time",
1510
- "description": "Creation date of the [Integration](#schema_integration) in ISO 8601 format"
1511
- },
1512
- "updatedAt": {
1513
- "type": "string",
1514
- "format": "date-time",
1515
- "description": "Updating date of the [Integration](#schema_integration) in ISO 8601 format"
1516
- },
1517
- "title": {
1518
- "type": "string",
1519
- "minLength": 1,
1520
- "maxLength": 64,
1521
- "description": "Title of the integration. This is the name that will be displayed in the UI"
1522
- },
1523
- "description": {
1524
- "type": "string",
1525
- "maxLength": 256,
1526
- "description": "Description of the integration. This is the description that will be displayed in the UI"
1527
- },
1528
- "iconUrl": {
1529
- "type": "string",
1530
- "description": "URL of the icon of the integration. This is the icon that will be displayed in the UI"
1531
- },
1532
- "public": {
1533
- "type": "boolean",
1534
- "description": "[DEPRECATED] Indicates whether the integration is public. Please use the \"visibility\" parameter instead.",
1535
- "deprecated": true
1536
- },
1537
- "visibility": {
1538
- "type": "string",
1539
- "enum": [
1540
- "public",
1541
- "private",
1542
- "unlisted"
1543
- ],
1544
- "description": "The integration's visibility. Public integrations are available to all and cannot be updated without creating a new version. Unlisted integrations behave identically to public integrations, but they are not listed in the integration hub. By default, integrations are private and only accessible to the workspace that created them."
1545
- },
1546
- "verificationStatus": {
1547
- "type": "string",
1548
- "enum": [
1549
- "unapproved",
1550
- "pending",
1551
- "approved",
1552
- "rejected"
1553
- ],
1554
- "description": "Status of the integration version verification"
1555
- }
1556
- },
1557
- "required": [
1558
- "enabled",
1559
- "name",
1560
- "version",
1561
- "webhookUrl",
1562
- "webhookId",
1563
- "configurationType",
1564
- "configuration",
1565
- "status",
1566
- "statusReason",
1567
- "disabledChannels",
1568
- "id",
1569
- "createdAt",
1570
- "updatedAt",
1571
- "title",
1572
- "description",
1573
- "iconUrl",
1574
- "public",
1575
- "visibility",
1576
- "verificationStatus"
1577
- ],
1578
- "additionalProperties": false
1579
- },
1580
- "description": "A mapping of integrations to their configuration. If the `x-multiple-integrations` header is present, this object is keyed by integration aliases. Otherwise, this object is keyed by integration ids."
1581
- },
1582
- "plugins": {
1583
- "type": "object",
1584
- "additionalProperties": {
1585
- "type": "object",
1586
- "properties": {
1587
- "enabled": {
1588
- "type": "boolean"
1589
- },
1590
- "name": {
1591
- "type": "string",
1592
- "maxLength": 200,
1593
- "description": "Name of the [Plugin](#schema_plugin)"
1594
- },
1595
- "version": {
1596
- "type": "string",
1597
- "maxLength": 200,
1598
- "description": "Version of the [Plugin](#schema_plugin)"
1599
- },
1600
- "configuration": {
1601
- "type": "object",
1602
- "additionalProperties": true
1603
- },
1604
- "interfaces": {
1605
- "type": "object",
1606
- "additionalProperties": {
1607
- "type": "object",
1608
- "properties": {
1609
- "integrationId": {
1610
- "type": "string",
1611
- "minLength": 28,
1612
- "maxLength": 36
1613
- },
1614
- "integrationAlias": {
1615
- "type": "string",
1616
- "maxLength": 200
1617
- },
1618
- "integrationInterfaceAlias": {
1619
- "type": "string",
1620
- "maxLength": 200
1621
- },
1622
- "interfaceId": {
1623
- "type": "string",
1624
- "minLength": 28,
1625
- "maxLength": 36
1626
- }
1627
- },
1628
- "required": [
1629
- "integrationId",
1630
- "integrationAlias",
1631
- "interfaceId"
1632
- ],
1633
- "additionalProperties": false
1634
- },
1635
- "description": "A mapping of plugin interface aliases to their backing integrations"
1636
- },
1637
- "integrations": {
1638
- "type": "object",
1639
- "additionalProperties": {
1640
- "type": "object",
1641
- "properties": {
1642
- "integrationId": {
1643
- "type": "string",
1644
- "minLength": 28,
1645
- "maxLength": 36
1646
- },
1647
- "integrationAlias": {
1648
- "type": "string",
1649
- "maxLength": 200
1650
- }
1651
- },
1652
- "required": [
1653
- "integrationId",
1654
- "integrationAlias"
1655
- ],
1656
- "additionalProperties": false
1657
- },
1658
- "description": "A mapping of plugin integration aliases to their backing integrations"
1659
- },
1660
- "id": {
1661
- "type": "string",
1662
- "minLength": 28,
1663
- "maxLength": 36,
1664
- "description": "ID of the [Plugin](#schema_plugin)"
1665
- },
1666
- "createdAt": {
1667
- "type": "string",
1668
- "format": "date-time",
1669
- "description": "Creation date of the [Plugin](#schema_plugin) in ISO 8601 format"
1670
- },
1671
- "updatedAt": {
1672
- "type": "string",
1673
- "format": "date-time",
1674
- "description": "Updating date of the [Plugin](#schema_plugin) in ISO 8601 format"
1675
- },
1676
- "title": {
1677
- "type": "string",
1678
- "minLength": 1,
1679
- "maxLength": 64,
1680
- "description": "Title of the plugin. This is the name that will be displayed in the UI"
1681
- },
1682
- "description": {
1683
- "type": "string",
1684
- "maxLength": 256,
1685
- "description": "Description of the plugin. This is the description that will be displayed in the UI"
1686
- },
1687
- "iconUrl": {
1688
- "type": "string",
1689
- "description": "URL of the icon of the plugin. This is the icon that will be displayed in the UI"
1690
- },
1691
- "readmeUrl": {
1692
- "type": "string",
1693
- "description": "URL of the readme of the plugin. This is the readme that will be displayed in the UI"
1694
- },
1695
- "public": {
1696
- "type": "boolean",
1697
- "description": "Indicates if the plugin is public. Public plugins are available to all and cannot be updated without creating a new version."
1698
- }
1699
- },
1700
- "required": [
1701
- "enabled",
1702
- "name",
1703
- "version",
1704
- "configuration",
1705
- "id",
1706
- "createdAt",
1707
- "updatedAt",
1708
- "title",
1709
- "description",
1710
- "iconUrl",
1711
- "readmeUrl",
1712
- "public"
1713
- ],
1714
- "additionalProperties": false
1715
- },
1716
- "description": "A mapping of plugin aliases to their configuration"
1717
- },
1718
- "maxExecutionTime": {
1719
- "type": "number",
1720
- "description": "Maximum execution time of the bot (in seconds)."
1721
- },
1722
- "user": {
1723
- "type": "object",
1724
- "properties": {
1725
- "tags": {
1726
- "type": "object",
1727
- "additionalProperties": {
1728
- "type": "object",
1729
- "properties": {
1730
- "title": {
1731
- "type": "string",
1732
- "maxLength": 64,
1733
- "description": "Title of the tag"
1734
- },
1735
- "description": {
1736
- "type": "string",
1737
- "maxLength": 256,
1738
- "description": "Description of the tag"
1739
- }
1740
- },
1741
- "description": "Definition of a tag that can be provided on the object",
1742
- "additionalProperties": false
1743
- }
1744
- }
1745
- },
1746
- "required": [
1747
- "tags"
1748
- ],
1749
- "description": "User object configuration",
1750
- "additionalProperties": false
1751
- },
1752
- "conversation": {
1753
- "type": "object",
1754
- "properties": {
1755
- "tags": {
1756
- "type": "object",
1757
- "additionalProperties": {
1758
- "type": "object",
1759
- "properties": {
1760
- "title": {
1761
- "type": "string",
1762
- "maxLength": 64,
1763
- "description": "Title of the tag"
1764
- },
1765
- "description": {
1766
- "type": "string",
1767
- "maxLength": 256,
1768
- "description": "Description of the tag"
1769
- }
1770
- },
1771
- "description": "Definition of a tag that can be provided on the object",
1772
- "additionalProperties": false
1773
- }
1774
- }
1775
- },
1776
- "required": [
1777
- "tags"
1778
- ],
1779
- "description": "Conversation object configuration",
1780
- "additionalProperties": false
1781
- },
1782
- "message": {
1783
- "type": "object",
1784
- "properties": {
1785
- "tags": {
1786
- "type": "object",
1787
- "additionalProperties": {
1788
- "type": "object",
1789
- "properties": {
1790
- "title": {
1791
- "type": "string",
1792
- "maxLength": 64,
1793
- "description": "Title of the tag"
1794
- },
1795
- "description": {
1796
- "type": "string",
1797
- "maxLength": 256,
1798
- "description": "Description of the tag"
1799
- }
1800
- },
1801
- "description": "Definition of a tag that can be provided on the object",
1802
- "additionalProperties": false
1803
- }
1804
- }
1805
- },
1806
- "required": [
1807
- "tags"
1808
- ],
1809
- "description": "Message object configuration",
1810
- "additionalProperties": false
1811
- },
1812
- "states": {
1813
- "type": "object",
1814
- "additionalProperties": {
1815
- "type": "object",
1816
- "properties": {
1817
- "type": {
1818
- "type": "string",
1819
- "enum": [
1820
- "conversation",
1821
- "user",
1822
- "bot",
1823
- "task"
1824
- ],
1825
- "description": "Type of the [State](#schema_state) (`conversation`, `user`, `bot` or `task`)"
1826
- },
1827
- "schema": {
1828
- "type": "object",
1829
- "additionalProperties": true,
1830
- "description": "Schema of the [State](#schema_state) in the `JSON schema` format. This `JSON schema` is going to be used for validating the state data."
1831
- },
1832
- "expiry": {
1833
- "type": "number",
1834
- "minimum": 1,
1835
- "description": "Expiry of the [State](#schema_state) in milliseconds. The state will expire if it is idle for the configured value. By default, a state doesn't expire."
1836
- }
1837
- },
1838
- "required": [
1839
- "type",
1840
- "schema"
1841
- ],
1842
- "additionalProperties": false
1843
- },
1844
- "description": "A mapping of states to their definition"
1845
- },
1846
- "configuration": {
1847
- "type": "object",
1848
- "properties": {
1849
- "data": {
1850
- "type": "object",
1851
- "additionalProperties": true,
1852
- "description": "Configuration data"
1853
- },
1854
- "schema": {
1855
- "type": "object",
1856
- "additionalProperties": true,
1857
- "description": "Schema of the configuration in the `JSON schema` format. The configuration data is validated against this `JSON schema`."
1858
- }
1859
- },
1860
- "required": [
1861
- "data",
1862
- "schema"
1863
- ],
1864
- "description": "Configuration of the bot",
1865
- "additionalProperties": false
1866
- },
1867
- "events": {
1868
- "type": "object",
1869
- "additionalProperties": {
1870
- "type": "object",
1871
- "properties": {
1872
- "title": {
1873
- "type": "string",
1874
- "maxLength": 64,
1875
- "description": "Title of the event"
1876
- },
1877
- "description": {
1878
- "type": "string",
1879
- "maxLength": 256,
1880
- "description": "Description of the event"
1881
- },
1882
- "schema": {
1883
- "type": "object",
1884
- "additionalProperties": true
1885
- },
1886
- "attributes": {
1887
- "type": "object",
1888
- "additionalProperties": {
1889
- "type": "string",
1890
- "maxLength": 200
1891
- },
1892
- "description": "Optional attributes"
1893
- }
1894
- },
1895
- "required": [
1896
- "schema"
1897
- ],
1898
- "description": "Event Definition",
1899
- "additionalProperties": false
1900
- },
1901
- "description": "Events definition"
1902
- },
1903
- "recurringEvents": {
1904
- "type": "object",
1905
- "additionalProperties": {
1906
- "type": "object",
1907
- "properties": {
1908
- "schedule": {
1909
- "type": "object",
1910
- "properties": {
1911
- "cron": {
1912
- "type": "string",
1913
- "maxLength": 200
1914
- }
1915
- },
1916
- "required": [
1917
- "cron"
1918
- ],
1919
- "additionalProperties": false
1920
- },
1921
- "type": {
1922
- "type": "string",
1923
- "maxLength": 200
1924
- },
1925
- "payload": {
1926
- "type": "object",
1927
- "additionalProperties": true
1928
- },
1929
- "failedAttempts": {
1930
- "type": "number",
1931
- "description": "The number of times the recurring event failed to run. This counter resets once the recurring event runs successfully."
1932
- },
1933
- "lastFailureReason": {
1934
- "type": "string",
1935
- "maxLength": 2000,
1936
- "description": "The reason why the recurring event failed to run in the last attempt.",
1937
- "nullable": true
1938
- }
1939
- },
1940
- "required": [
1941
- "schedule",
1942
- "type",
1943
- "payload",
1944
- "failedAttempts",
1945
- "lastFailureReason"
1946
- ],
1947
- "additionalProperties": false
1948
- },
1949
- "description": "Recurring events"
1950
- },
1951
- "subscriptions": {
1952
- "type": "object",
1953
- "properties": {
1954
- "events": {
1955
- "type": "object",
1956
- "additionalProperties": {
1957
- "type": "object",
1958
- "additionalProperties": false
1959
- },
1960
- "nullable": true,
1961
- "description": "Events that the bot is currently subscribed on (ex: \"slack:reactionAdded\"). If null, the bot is subscribed to all events."
1962
- }
1963
- },
1964
- "required": [
1965
- "events"
1966
- ],
1967
- "description": "Subscriptions of the bot",
1968
- "additionalProperties": false
1969
- },
1970
- "actions": {
1971
- "type": "object",
1972
- "additionalProperties": {
1973
- "type": "object",
1974
- "properties": {
1975
- "title": {
1976
- "type": "string",
1977
- "maxLength": 64,
1978
- "description": "Title of the action"
1979
- },
1980
- "description": {
1981
- "type": "string",
1982
- "maxLength": 256,
1983
- "description": "Description of the action"
1984
- },
1985
- "billable": {
1986
- "type": "boolean"
1987
- },
1988
- "cacheable": {
1989
- "type": "boolean"
1990
- },
1991
- "input": {
1992
- "type": "object",
1993
- "properties": {
1994
- "schema": {
1995
- "type": "object",
1996
- "additionalProperties": true
1997
- }
1998
- },
1999
- "required": [
2000
- "schema"
2001
- ],
2002
- "additionalProperties": false
2003
- },
2004
- "output": {
2005
- "type": "object",
2006
- "properties": {
2007
- "schema": {
2008
- "type": "object",
2009
- "additionalProperties": true
2010
- }
2011
- },
2012
- "required": [
2013
- "schema"
2014
- ],
2015
- "additionalProperties": false
2016
- },
2017
- "attributes": {
2018
- "type": "object",
2019
- "additionalProperties": {
2020
- "type": "string",
2021
- "maxLength": 200
2022
- },
2023
- "description": "Optional attributes"
2024
- }
2025
- },
2026
- "required": [
2027
- "input",
2028
- "output"
2029
- ],
2030
- "description": "Action definition",
2031
- "additionalProperties": false
2032
- },
2033
- "description": "Actions definition"
2034
- },
2035
- "tags": {
2036
- "type": "object",
2037
- "additionalProperties": {
2038
- "type": "string"
2039
- },
2040
- "description": "Tags of [Bot](#schema_bot)"
2041
- },
2042
- "name": {
2043
- "type": "string",
2044
- "description": "Name of the [Bot](#schema_bot)"
2045
- },
2046
- "deployedAt": {
2047
- "type": "string",
2048
- "format": "date-time",
2049
- "description": "Last deployment date of the [Bot](#schema_bot) in the ISO 8601 format"
2050
- },
2051
- "dev": {
2052
- "type": "boolean",
2053
- "description": "Indicates if the [Bot](#schema_bot) is a development bot; Development bots run locally and can install dev integrations"
2054
- },
2055
- "createdBy": {
2056
- "type": "string",
2057
- "description": "Id of the user that created the bot"
2058
- },
2059
- "alwaysAlive": {
2060
- "type": "boolean",
2061
- "description": "Indicates if the [Bot](#schema_bot) should be in always alive mode"
2062
- },
2063
- "status": {
2064
- "type": "string",
2065
- "enum": [
2066
- "active",
2067
- "deploying"
2068
- ],
2069
- "description": "Status of the bot"
2070
- },
2071
- "medias": {
2072
- "type": "array",
2073
- "items": {
2074
- "type": "object",
2075
- "properties": {
2076
- "url": {
2077
- "type": "string",
2078
- "description": "URL of the media file"
2079
- },
2080
- "name": {
2081
- "type": "string",
2082
- "description": "Name of the media file"
2083
- }
2084
- },
2085
- "required": [
2086
- "url",
2087
- "name"
2088
- ]
2089
- },
2090
- "description": "Media files associated with the [Bot](#schema_bot)"
2091
- }
2092
- },
2093
- "required": [
2094
- "id",
2095
- "createdAt",
2096
- "updatedAt",
2097
- "signingSecret",
2098
- "integrations",
2099
- "plugins",
2100
- "user",
2101
- "conversation",
2102
- "message",
2103
- "states",
2104
- "configuration",
2105
- "events",
2106
- "recurringEvents",
2107
- "subscriptions",
2108
- "actions",
2109
- "tags",
2110
- "name",
2111
- "dev",
2112
- "alwaysAlive",
2113
- "status",
2114
- "medias"
2115
- ],
2116
- "additionalProperties": false
2117
- }
2118
- },
2119
- "Integration": {
2120
- "section": "integration",
2121
- "schema": {
2122
- "type": "object",
2123
- "properties": {
2124
- "id": {
2125
- "type": "string",
2126
- "minLength": 28,
2127
- "maxLength": 36,
2128
- "description": "ID of the [Integration](#schema_integration)"
2129
- },
2130
- "createdAt": {
2131
- "type": "string",
2132
- "format": "date-time",
2133
- "description": "Creation date of the [Integration](#schema_integration) in ISO 8601 format"
2134
- },
2135
- "updatedAt": {
2136
- "type": "string",
2137
- "format": "date-time",
2138
- "description": "Updating date of the [Integration](#schema_integration) in ISO 8601 format"
2139
- },
2140
- "identifier": {
2141
- "type": "object",
2142
- "properties": {
2143
- "fallbackHandlerScript": {
2144
- "type": "string",
2145
- "maxLength": 2000,
2146
- "description": "VRL Script of the [Integration](#schema_integration) to handle incoming requests for a request that doesn't have an identifier"
2147
- },
2148
- "extractScript": {
2149
- "type": "string",
2150
- "maxLength": 2000,
2151
- "description": "VRL Script of the [Integration](#schema_integration) to extract the identifier from an incoming webhook often use for OAuth"
2152
- }
2153
- },
2154
- "description": "Global identifier configuration of the [Integration](#schema_integration)",
2155
- "additionalProperties": false
2156
- },
2157
- "sandbox": {
2158
- "type": "object",
2159
- "properties": {
2160
- "identifierExtractScript": {
2161
- "type": "string",
2162
- "maxLength": 2000,
2163
- "description": "VRL Script of the [Integration](#schema_integration) to extract the identifier from an incoming webhook used specifically for the sandbox"
2164
- },
2165
- "messageExtractScript": {
2166
- "type": "string",
2167
- "maxLength": 2000,
2168
- "description": "VRL Script of the [Integration](#schema_integration) to extract the message from an incoming webhook used specifically for the sandbox"
2169
- }
2170
- },
2171
- "additionalProperties": false
2172
- },
2173
- "maxExecutionTime": {
2174
- "type": "number",
2175
- "description": "Maximum execution time of the integration (in seconds)."
2176
- },
2177
- "url": {
2178
- "type": "string",
2179
- "maxLength": 2000,
2180
- "description": "URL of the [Integration](#schema_integration)"
2181
- },
2182
- "name": {
2183
- "type": "string",
2184
- "maxLength": 200,
2185
- "description": "Name of the [Integration](#schema_integration)"
2186
- },
2187
- "version": {
2188
- "type": "string",
2189
- "maxLength": 200,
2190
- "description": "Version of the [Integration](#schema_integration)"
2191
- },
2192
- "interfaces": {
2193
- "type": "object",
2194
- "additionalProperties": {
2195
- "type": "object",
2196
- "properties": {
2197
- "id": {
2198
- "type": "string",
2199
- "minLength": 28,
2200
- "maxLength": 36,
2201
- "description": "ID of the interface"
2202
- },
2203
- "name": {
2204
- "type": "string",
2205
- "maxLength": 200,
2206
- "description": "Name of the interface"
2207
- },
2208
- "version": {
2209
- "type": "string",
2210
- "maxLength": 200,
2211
- "description": "Version of the interface"
2212
- },
2213
- "entities": {
2214
- "type": "object",
2215
- "additionalProperties": {
2216
- "type": "object",
2217
- "properties": {
2218
- "name": {
2219
- "type": "string",
2220
- "maxLength": 200
2221
- }
2222
- },
2223
- "required": [
2224
- "name"
2225
- ],
2226
- "additionalProperties": false
2227
- }
2228
- },
2229
- "actions": {
2230
- "type": "object",
2231
- "additionalProperties": {
2232
- "type": "object",
2233
- "properties": {
2234
- "name": {
2235
- "type": "string",
2236
- "maxLength": 200
2237
- }
2238
- },
2239
- "required": [
2240
- "name"
2241
- ],
2242
- "additionalProperties": false
2243
- }
2244
- },
2245
- "events": {
2246
- "type": "object",
2247
- "additionalProperties": {
2248
- "type": "object",
2249
- "properties": {
2250
- "name": {
2251
- "type": "string",
2252
- "maxLength": 200
2253
- }
2254
- },
2255
- "required": [
2256
- "name"
2257
- ],
2258
- "additionalProperties": false
2259
- }
2260
- },
2261
- "channels": {
2262
- "type": "object",
2263
- "additionalProperties": {
2264
- "type": "object",
2265
- "properties": {
2266
- "name": {
2267
- "type": "string",
2268
- "maxLength": 200
2269
- }
2270
- },
2271
- "required": [
2272
- "name"
2273
- ],
2274
- "additionalProperties": false
2275
- }
2276
- }
2277
- },
2278
- "required": [
2279
- "id",
2280
- "name",
2281
- "version",
2282
- "entities",
2283
- "actions",
2284
- "events",
2285
- "channels"
2286
- ],
2287
- "additionalProperties": false
2288
- }
2289
- },
2290
- "configuration": {
2291
- "type": "object",
2292
- "properties": {
2293
- "title": {
2294
- "type": "string",
2295
- "maxLength": 64,
2296
- "description": "Title of the configuration"
2297
- },
2298
- "description": {
2299
- "type": "string",
2300
- "maxLength": 256,
2301
- "description": "Description of the configuration"
2302
- },
2303
- "identifier": {
2304
- "type": "object",
2305
- "properties": {
2306
- "linkTemplateScript": {
2307
- "type": "string",
2308
- "maxLength": 2000
2309
- },
2310
- "required": {
2311
- "type": "boolean"
2312
- }
2313
- },
2314
- "required": [
2315
- "required"
2316
- ],
2317
- "description": "Identifier configuration of the [Integration](#schema_integration)",
2318
- "additionalProperties": false
2319
- },
2320
- "schema": {
2321
- "type": "object",
2322
- "additionalProperties": true,
2323
- "description": "Schema of the configuration in the `JSON schema` format. The configuration data is validated against this `JSON schema`."
2324
- }
2325
- },
2326
- "required": [
2327
- "identifier",
2328
- "schema"
2329
- ],
2330
- "description": "Configuration definition",
2331
- "additionalProperties": false
2332
- },
2333
- "configurations": {
2334
- "type": "object",
2335
- "additionalProperties": {
2336
- "type": "object",
2337
- "properties": {
2338
- "title": {
2339
- "type": "string",
2340
- "maxLength": 64,
2341
- "description": "Title of the configuration"
2342
- },
2343
- "description": {
2344
- "type": "string",
2345
- "maxLength": 256,
2346
- "description": "Description of the configuration"
2347
- },
2348
- "identifier": {
2349
- "type": "object",
2350
- "properties": {
2351
- "linkTemplateScript": {
2352
- "type": "string",
2353
- "maxLength": 2000
2354
- },
2355
- "required": {
2356
- "type": "boolean"
2357
- }
2358
- },
2359
- "required": [
2360
- "required"
2361
- ],
2362
- "description": "Identifier configuration of the [Integration](#schema_integration)",
2363
- "additionalProperties": false
2364
- },
2365
- "schema": {
2366
- "type": "object",
2367
- "additionalProperties": true,
2368
- "description": "Schema of the configuration in the `JSON schema` format. The configuration data is validated against this `JSON schema`."
2369
- }
2370
- },
2371
- "required": [
2372
- "identifier",
2373
- "schema"
2374
- ],
2375
- "description": "Configuration definition",
2376
- "additionalProperties": false
2377
- }
2378
- },
2379
- "channels": {
2380
- "type": "object",
2381
- "additionalProperties": {
2382
- "type": "object",
2383
- "properties": {
2384
- "title": {
2385
- "type": "string",
2386
- "maxLength": 64,
2387
- "description": "Title of the channel"
2388
- },
2389
- "description": {
2390
- "type": "string",
2391
- "maxLength": 256,
2392
- "description": "Description of the channel"
2393
- },
2394
- "messages": {
2395
- "type": "object",
2396
- "additionalProperties": {
2397
- "type": "object",
2398
- "properties": {
2399
- "schema": {
2400
- "type": "object",
2401
- "additionalProperties": true
2402
- }
2403
- },
2404
- "required": [
2405
- "schema"
2406
- ],
2407
- "description": "Message definition",
2408
- "additionalProperties": false
2409
- }
2410
- },
2411
- "conversation": {
2412
- "type": "object",
2413
- "properties": {
2414
- "tags": {
2415
- "type": "object",
2416
- "additionalProperties": {
2417
- "type": "object",
2418
- "properties": {
2419
- "title": {
2420
- "type": "string",
2421
- "maxLength": 64,
2422
- "description": "Title of the tag"
2423
- },
2424
- "description": {
2425
- "type": "string",
2426
- "maxLength": 256,
2427
- "description": "Description of the tag"
2428
- }
2429
- },
2430
- "description": "Definition of a tag that can be provided on the object",
2431
- "additionalProperties": false
2432
- }
2433
- },
2434
- "creation": {
2435
- "type": "object",
2436
- "properties": {
2437
- "enabled": {
2438
- "type": "boolean",
2439
- "description": "Enable conversation creation"
2440
- },
2441
- "requiredTags": {
2442
- "type": "array",
2443
- "items": {
2444
- "type": "string"
2445
- },
2446
- "description": "The list of tags that are required to be specified when calling the API directly to create a conversation."
2447
- }
2448
- },
2449
- "required": [
2450
- "enabled",
2451
- "requiredTags"
2452
- ],
2453
- "description": "The conversation creation setting determines how to create a conversation through the API directly. The integration will have to implement the `createConversation` functionality to support this setting.",
2454
- "additionalProperties": false
2455
- }
2456
- },
2457
- "required": [
2458
- "tags",
2459
- "creation"
2460
- ],
2461
- "description": "Conversation object configuration",
2462
- "additionalProperties": false
2463
- },
2464
- "message": {
2465
- "type": "object",
2466
- "properties": {
2467
- "tags": {
2468
- "type": "object",
2469
- "additionalProperties": {
2470
- "type": "object",
2471
- "properties": {
2472
- "title": {
2473
- "type": "string",
2474
- "maxLength": 64,
2475
- "description": "Title of the tag"
2476
- },
2477
- "description": {
2478
- "type": "string",
2479
- "maxLength": 256,
2480
- "description": "Description of the tag"
2481
- }
2482
- },
2483
- "description": "Definition of a tag that can be provided on the object",
2484
- "additionalProperties": false
2485
- }
2486
- }
2487
- },
2488
- "required": [
2489
- "tags"
2490
- ],
2491
- "description": "Message object configuration",
2492
- "additionalProperties": false
2493
- }
2494
- },
2495
- "required": [
2496
- "messages",
2497
- "conversation",
2498
- "message"
2499
- ],
2500
- "description": "Channel definition",
2501
- "additionalProperties": false
2502
- }
2503
- },
2504
- "states": {
2505
- "type": "object",
2506
- "additionalProperties": {
2507
- "type": "object",
2508
- "properties": {
2509
- "type": {
2510
- "type": "string",
2511
- "enum": [
2512
- "conversation",
2513
- "user",
2514
- "integration"
2515
- ],
2516
- "description": "Type of the [State](#schema_state) (`conversation`, `user` or `integration`)"
2517
- },
2518
- "schema": {
2519
- "type": "object",
2520
- "additionalProperties": true,
2521
- "description": "Schema of the [State](#schema_state) in the `JSON schema` format. This `JSON schema` is going to be used for validating the state data."
2522
- }
2523
- },
2524
- "required": [
2525
- "type",
2526
- "schema"
2527
- ],
2528
- "description": "State definition",
2529
- "additionalProperties": false
2530
- }
2531
- },
2532
- "events": {
2533
- "type": "object",
2534
- "additionalProperties": {
2535
- "type": "object",
2536
- "properties": {
2537
- "title": {
2538
- "type": "string",
2539
- "maxLength": 64,
2540
- "description": "Title of the event"
2541
- },
2542
- "description": {
2543
- "type": "string",
2544
- "maxLength": 256,
2545
- "description": "Description of the event"
2546
- },
2547
- "schema": {
2548
- "type": "object",
2549
- "additionalProperties": true
2550
- },
2551
- "attributes": {
2552
- "type": "object",
2553
- "additionalProperties": {
2554
- "type": "string",
2555
- "maxLength": 200
2556
- },
2557
- "description": "Optional attributes"
2558
- }
2559
- },
2560
- "required": [
2561
- "schema"
2562
- ],
2563
- "description": "Event Definition",
2564
- "additionalProperties": false
2565
- }
2566
- },
2567
- "actions": {
2568
- "type": "object",
2569
- "additionalProperties": {
2570
- "type": "object",
2571
- "properties": {
2572
- "title": {
2573
- "type": "string",
2574
- "maxLength": 64,
2575
- "description": "Title of the action"
2576
- },
2577
- "description": {
2578
- "type": "string",
2579
- "maxLength": 256,
2580
- "description": "Description of the action"
2581
- },
2582
- "billable": {
2583
- "type": "boolean"
2584
- },
2585
- "cacheable": {
2586
- "type": "boolean"
2587
- },
2588
- "input": {
2589
- "type": "object",
2590
- "properties": {
2591
- "schema": {
2592
- "type": "object",
2593
- "additionalProperties": true
2594
- }
2595
- },
2596
- "required": [
2597
- "schema"
2598
- ],
2599
- "additionalProperties": false
2600
- },
2601
- "output": {
2602
- "type": "object",
2603
- "properties": {
2604
- "schema": {
2605
- "type": "object",
2606
- "additionalProperties": true
2607
- }
2608
- },
2609
- "required": [
2610
- "schema"
2611
- ],
2612
- "additionalProperties": false
2613
- },
2614
- "attributes": {
2615
- "type": "object",
2616
- "additionalProperties": {
2617
- "type": "string",
2618
- "maxLength": 200
2619
- },
2620
- "description": "Optional attributes"
2621
- }
2622
- },
2623
- "required": [
2624
- "input",
2625
- "output"
2626
- ],
2627
- "description": "Action definition",
2628
- "additionalProperties": false
2629
- }
2630
- },
2631
- "user": {
2632
- "type": "object",
2633
- "properties": {
2634
- "tags": {
2635
- "type": "object",
2636
- "additionalProperties": {
2637
- "type": "object",
2638
- "properties": {
2639
- "title": {
2640
- "type": "string",
2641
- "maxLength": 64,
2642
- "description": "Title of the tag"
2643
- },
2644
- "description": {
2645
- "type": "string",
2646
- "maxLength": 256,
2647
- "description": "Description of the tag"
2648
- }
2649
- },
2650
- "description": "Definition of a tag that can be provided on the object",
2651
- "additionalProperties": false
2652
- }
2653
- },
2654
- "creation": {
2655
- "type": "object",
2656
- "properties": {
2657
- "enabled": {
2658
- "type": "boolean",
2659
- "description": "Enable user creation"
2660
- },
2661
- "requiredTags": {
2662
- "type": "array",
2663
- "items": {
2664
- "type": "string"
2665
- },
2666
- "description": "The list of tags that are required to be specified when calling the API directly to create a user."
2667
- }
2668
- },
2669
- "required": [
2670
- "enabled",
2671
- "requiredTags"
2672
- ],
2673
- "description": "The user creation setting determines how to create a user through the API directly. The integration will have to implement the `createUser` functionality to support this setting.",
2674
- "additionalProperties": false
2675
- }
2676
- },
2677
- "required": [
2678
- "tags",
2679
- "creation"
2680
- ],
2681
- "description": "User object configuration",
2682
- "additionalProperties": false
2683
- },
2684
- "entities": {
2685
- "type": "object",
2686
- "additionalProperties": {
2687
- "type": "object",
2688
- "properties": {
2689
- "title": {
2690
- "type": "string",
2691
- "maxLength": 64,
2692
- "description": "Title of the entity"
2693
- },
2694
- "description": {
2695
- "type": "string",
2696
- "maxLength": 256,
2697
- "description": "Description of the entity"
2698
- },
2699
- "schema": {
2700
- "type": "object",
2701
- "additionalProperties": true
2702
- }
2703
- },
2704
- "required": [
2705
- "schema"
2706
- ],
2707
- "description": "Entity definition",
2708
- "additionalProperties": false
2709
- }
2710
- },
2711
- "attributes": {
2712
- "type": "object",
2713
- "additionalProperties": {
2714
- "type": "string",
2715
- "maxLength": 200
2716
- },
2717
- "description": "Optional attributes"
2718
- },
2719
- "dev": {
2720
- "type": "boolean",
2721
- "description": "Indicates if the integration is a development integration; Dev integrations run locally"
2722
- },
2723
- "title": {
2724
- "type": "string",
2725
- "minLength": 1,
2726
- "maxLength": 64,
2727
- "description": "Title of the integration. This is the name that will be displayed in the UI"
2728
- },
2729
- "description": {
2730
- "type": "string",
2731
- "maxLength": 256,
2732
- "description": "Description of the integration. This is the description that will be displayed in the UI"
2733
- },
2734
- "iconUrl": {
2735
- "type": "string",
2736
- "description": "URL of the icon of the integration. This is the icon that will be displayed in the UI"
2737
- },
2738
- "readmeUrl": {
2739
- "type": "string",
2740
- "description": "URL of the readme of the integration. This is the readme that will be displayed in the UI"
2741
- },
2742
- "public": {
2743
- "type": "boolean",
2744
- "description": "[DEPRECATED] Indicates whether the integration is public. Please use the \"visibility\" parameter instead.",
2745
- "deprecated": true
2746
- },
2747
- "visibility": {
2748
- "type": "string",
2749
- "enum": [
2750
- "public",
2751
- "private",
2752
- "unlisted"
2753
- ],
2754
- "description": "The integration's visibility. Public integrations are available to all and cannot be updated without creating a new version. Unlisted integrations behave identically to public integrations, but they are not listed in the integration hub. By default, integrations are private and only accessible to the workspace that created them."
2755
- },
2756
- "verificationStatus": {
2757
- "type": "string",
2758
- "enum": [
2759
- "unapproved",
2760
- "pending",
2761
- "approved",
2762
- "rejected"
2763
- ],
2764
- "description": "Status of the integration version verification"
2765
- },
2766
- "secrets": {
2767
- "type": "array",
2768
- "items": {
2769
- "type": "string"
2770
- },
2771
- "description": "Secrets are integration-wide values available in the code via environment variables formatted with a SECRET_ prefix followed by your secret name. A secret name must respect SCREAMING_SNAKE casing."
2772
- }
2773
- },
2774
- "required": [
2775
- "id",
2776
- "createdAt",
2777
- "updatedAt",
2778
- "identifier",
2779
- "url",
2780
- "name",
2781
- "version",
2782
- "interfaces",
2783
- "configuration",
2784
- "configurations",
2785
- "channels",
2786
- "states",
2787
- "events",
2788
- "actions",
2789
- "user",
2790
- "entities",
2791
- "dev",
2792
- "title",
2793
- "description",
2794
- "iconUrl",
2795
- "readmeUrl",
2796
- "public",
2797
- "visibility",
2798
- "verificationStatus",
2799
- "secrets"
2800
- ],
2801
- "additionalProperties": false
2802
- }
2803
- },
2804
- "Interface": {
2805
- "section": "interface",
2806
- "schema": {
2807
- "type": "object",
2808
- "properties": {
2809
- "id": {
2810
- "type": "string",
2811
- "minLength": 28,
2812
- "maxLength": 36,
2813
- "description": "ID of the [Interface](#schema_interface)"
2814
- },
2815
- "createdAt": {
2816
- "type": "string",
2817
- "format": "date-time",
2818
- "description": "Creation date of the [Interface](#schema_interface) in ISO 8601 format"
2819
- },
2820
- "updatedAt": {
2821
- "type": "string",
2822
- "format": "date-time",
2823
- "description": "Updating date of the [Interface](#schema_interface) in ISO 8601 format"
2824
- },
2825
- "name": {
2826
- "type": "string",
2827
- "maxLength": 200,
2828
- "description": "Name of the [Interface](#schema_interface)"
2829
- },
2830
- "version": {
2831
- "type": "string",
2832
- "maxLength": 200,
2833
- "description": "Version of the [Interface](#schema_interface)"
2834
- },
2835
- "entities": {
2836
- "type": "object",
2837
- "additionalProperties": {
2838
- "type": "object",
2839
- "properties": {
2840
- "title": {
2841
- "type": "string",
2842
- "maxLength": 64,
2843
- "description": "Title of the entity"
2844
- },
2845
- "description": {
2846
- "type": "string",
2847
- "maxLength": 256,
2848
- "description": "Description of the entity"
2849
- },
2850
- "schema": {
2851
- "type": "object",
2852
- "additionalProperties": true
2853
- }
2854
- },
2855
- "required": [
2856
- "schema"
2857
- ],
2858
- "description": "Entity definition",
2859
- "additionalProperties": false
2860
- }
2861
- },
2862
- "events": {
2863
- "type": "object",
2864
- "additionalProperties": {
2865
- "type": "object",
2866
- "properties": {
2867
- "title": {
2868
- "type": "string",
2869
- "maxLength": 64,
2870
- "description": "Title of the event"
2871
- },
2872
- "description": {
2873
- "type": "string",
2874
- "maxLength": 256,
2875
- "description": "Description of the event"
2876
- },
2877
- "schema": {
2878
- "type": "object",
2879
- "additionalProperties": true
2880
- },
2881
- "attributes": {
2882
- "type": "object",
2883
- "additionalProperties": {
2884
- "type": "string",
2885
- "maxLength": 200
2886
- },
2887
- "description": "Optional attributes"
2888
- }
2889
- },
2890
- "required": [
2891
- "schema"
2892
- ],
2893
- "description": "Event Definition",
2894
- "additionalProperties": false
2895
- }
2896
- },
2897
- "actions": {
2898
- "type": "object",
2899
- "additionalProperties": {
2900
- "type": "object",
2901
- "properties": {
2902
- "title": {
2903
- "type": "string",
2904
- "maxLength": 64,
2905
- "description": "Title of the action"
2906
- },
2907
- "description": {
2908
- "type": "string",
2909
- "maxLength": 256,
2910
- "description": "Description of the action"
2911
- },
2912
- "billable": {
2913
- "type": "boolean"
2914
- },
2915
- "cacheable": {
2916
- "type": "boolean"
2917
- },
2918
- "input": {
2919
- "type": "object",
2920
- "properties": {
2921
- "schema": {
2922
- "type": "object",
2923
- "additionalProperties": true
2924
- }
2925
- },
2926
- "required": [
2927
- "schema"
2928
- ],
2929
- "additionalProperties": false
2930
- },
2931
- "output": {
2932
- "type": "object",
2933
- "properties": {
2934
- "schema": {
2935
- "type": "object",
2936
- "additionalProperties": true
2937
- }
2938
- },
2939
- "required": [
2940
- "schema"
2941
- ],
2942
- "additionalProperties": false
2943
- },
2944
- "attributes": {
2945
- "type": "object",
2946
- "additionalProperties": {
2947
- "type": "string",
2948
- "maxLength": 200
2949
- },
2950
- "description": "Optional attributes"
2951
- }
2952
- },
2953
- "required": [
2954
- "input",
2955
- "output"
2956
- ],
2957
- "description": "Action definition",
2958
- "additionalProperties": false
2959
- }
2960
- },
2961
- "channels": {
2962
- "type": "object",
2963
- "additionalProperties": {
2964
- "type": "object",
2965
- "properties": {
2966
- "title": {
2967
- "type": "string",
2968
- "maxLength": 64,
2969
- "description": "Title of the channel"
2970
- },
2971
- "description": {
2972
- "type": "string",
2973
- "maxLength": 256,
2974
- "description": "Description of the channel"
2975
- },
2976
- "messages": {
2977
- "type": "object",
2978
- "additionalProperties": {
2979
- "type": "object",
2980
- "properties": {
2981
- "schema": {
2982
- "type": "object",
2983
- "additionalProperties": true
2984
- }
2985
- },
2986
- "required": [
2987
- "schema"
2988
- ],
2989
- "description": "Message definition",
2990
- "additionalProperties": false
2991
- }
2992
- }
2993
- },
2994
- "required": [
2995
- "messages"
2996
- ],
2997
- "additionalProperties": false
2998
- }
2999
- },
3000
- "nameTemplate": {
3001
- "type": "object",
3002
- "properties": {
3003
- "script": {
3004
- "type": "string",
3005
- "maxLength": 2000
3006
- },
3007
- "language": {
3008
- "type": "string",
3009
- "maxLength": 200
3010
- }
3011
- },
3012
- "required": [
3013
- "script",
3014
- "language"
3015
- ],
3016
- "description": "Template string optionaly used at build time by integrations implementing this interface to pick a name for actions and events.",
3017
- "additionalProperties": false
3018
- },
3019
- "attributes": {
3020
- "type": "object",
3021
- "additionalProperties": {
3022
- "type": "string",
3023
- "maxLength": 200
3024
- },
3025
- "description": "Optional attributes"
3026
- },
3027
- "title": {
3028
- "type": "string",
3029
- "minLength": 1,
3030
- "maxLength": 64,
3031
- "description": "Title of the interface. This is the name that will be displayed in the UI"
3032
- },
3033
- "description": {
3034
- "type": "string",
3035
- "maxLength": 256,
3036
- "description": "Description of the interface. This is the description that will be displayed in the UI"
3037
- },
3038
- "iconUrl": {
3039
- "type": "string",
3040
- "description": "URL of the icon of the interface. This is the icon that will be displayed in the UI"
3041
- },
3042
- "readmeUrl": {
3043
- "type": "string",
3044
- "description": "URL of the readme of the interface. This is the readme that will be displayed in the UI"
3045
- },
3046
- "public": {
3047
- "type": "boolean",
3048
- "description": "Indicates if the interface is public. Public interfaces are available to all and cannot be updated without creating a new version."
3049
- }
3050
- },
3051
- "required": [
3052
- "id",
3053
- "createdAt",
3054
- "updatedAt",
3055
- "name",
3056
- "version",
3057
- "entities",
3058
- "events",
3059
- "actions",
3060
- "channels",
3061
- "title",
3062
- "description",
3063
- "iconUrl",
3064
- "readmeUrl",
3065
- "public"
3066
- ],
3067
- "additionalProperties": false
3068
- }
3069
- },
3070
- "Plugin": {
3071
- "section": "plugin",
3072
- "schema": {
3073
- "type": "object",
3074
- "properties": {
3075
- "id": {
3076
- "type": "string",
3077
- "minLength": 28,
3078
- "maxLength": 36,
3079
- "description": "ID of the [Plugin](#schema_plugin)"
3080
- },
3081
- "name": {
3082
- "type": "string",
3083
- "maxLength": 200,
3084
- "description": "Name of the [Plugin](#schema_plugin)"
3085
- },
3086
- "version": {
3087
- "type": "string",
3088
- "maxLength": 200,
3089
- "description": "Version of the [Plugin](#schema_plugin)"
3090
- },
3091
- "createdAt": {
3092
- "type": "string",
3093
- "format": "date-time",
3094
- "description": "Creation date of the [Plugin](#schema_plugin) in ISO 8601 format"
3095
- },
3096
- "updatedAt": {
3097
- "type": "string",
3098
- "format": "date-time",
3099
- "description": "Updating date of the [Plugin](#schema_plugin) in ISO 8601 format"
3100
- },
3101
- "configuration": {
3102
- "type": "object",
3103
- "properties": {
3104
- "title": {
3105
- "type": "string",
3106
- "maxLength": 64,
3107
- "description": "Title of the configuration"
3108
- },
3109
- "description": {
3110
- "type": "string",
3111
- "maxLength": 256,
3112
- "description": "Description of the configuration"
3113
- },
3114
- "schema": {
3115
- "type": "object",
3116
- "additionalProperties": true,
3117
- "description": "Schema of the configuration in the `JSON schema` format. The configuration data is validated against this `JSON schema`."
3118
- }
3119
- },
3120
- "required": [
3121
- "schema"
3122
- ],
3123
- "description": "Configuration definition",
3124
- "additionalProperties": false
3125
- },
3126
- "states": {
3127
- "type": "object",
3128
- "additionalProperties": {
3129
- "type": "object",
3130
- "properties": {
3131
- "type": {
3132
- "type": "string",
3133
- "enum": [
3134
- "conversation",
3135
- "user",
3136
- "bot",
3137
- "task"
3138
- ],
3139
- "description": "Type of the [State](#schema_state) (`conversation`, `user`, `bot` or `task`)"
3140
- },
3141
- "schema": {
3142
- "type": "object",
3143
- "additionalProperties": true,
3144
- "description": "Schema of the [State](#schema_state) in the `JSON schema` format. This `JSON schema` is going to be used for validating the state data."
3145
- },
3146
- "expiry": {
3147
- "type": "number",
3148
- "minimum": 1,
3149
- "description": "Expiry of the [State](#schema_state) in milliseconds. The state will expire if it is idle for the configured value. By default, a state doesn't expire."
3150
- }
3151
- },
3152
- "required": [
3153
- "type",
3154
- "schema"
3155
- ],
3156
- "additionalProperties": false
3157
- }
3158
- },
3159
- "events": {
3160
- "type": "object",
3161
- "additionalProperties": {
3162
- "type": "object",
3163
- "properties": {
3164
- "title": {
3165
- "type": "string",
3166
- "maxLength": 64,
3167
- "description": "Title of the event"
3168
- },
3169
- "description": {
3170
- "type": "string",
3171
- "maxLength": 256,
3172
- "description": "Description of the event"
3173
- },
3174
- "schema": {
3175
- "type": "object",
3176
- "additionalProperties": true
3177
- },
3178
- "attributes": {
3179
- "type": "object",
3180
- "additionalProperties": {
3181
- "type": "string",
3182
- "maxLength": 200
3183
- },
3184
- "description": "Optional attributes"
3185
- }
3186
- },
3187
- "required": [
3188
- "schema"
3189
- ],
3190
- "description": "Event Definition",
3191
- "additionalProperties": false
3192
- }
3193
- },
3194
- "actions": {
3195
- "type": "object",
3196
- "additionalProperties": {
3197
- "type": "object",
3198
- "properties": {
3199
- "title": {
3200
- "type": "string",
3201
- "maxLength": 64,
3202
- "description": "Title of the action"
3203
- },
3204
- "description": {
3205
- "type": "string",
3206
- "maxLength": 256,
3207
- "description": "Description of the action"
3208
- },
3209
- "billable": {
3210
- "type": "boolean"
3211
- },
3212
- "cacheable": {
3213
- "type": "boolean"
3214
- },
3215
- "input": {
3216
- "type": "object",
3217
- "properties": {
3218
- "schema": {
3219
- "type": "object",
3220
- "additionalProperties": true
3221
- }
3222
- },
3223
- "required": [
3224
- "schema"
3225
- ],
3226
- "additionalProperties": false
3227
- },
3228
- "output": {
3229
- "type": "object",
3230
- "properties": {
3231
- "schema": {
3232
- "type": "object",
3233
- "additionalProperties": true
3234
- }
3235
- },
3236
- "required": [
3237
- "schema"
3238
- ],
3239
- "additionalProperties": false
3240
- },
3241
- "attributes": {
3242
- "type": "object",
3243
- "additionalProperties": {
3244
- "type": "string",
3245
- "maxLength": 200
3246
- },
3247
- "description": "Optional attributes"
3248
- }
3249
- },
3250
- "required": [
3251
- "input",
3252
- "output"
3253
- ],
3254
- "description": "Action definition",
3255
- "additionalProperties": false
3256
- }
3257
- },
3258
- "dependencies": {
3259
- "type": "object",
3260
- "properties": {
3261
- "interfaces": {
3262
- "type": "object",
3263
- "additionalProperties": {
3264
- "type": "object",
3265
- "properties": {
3266
- "id": {
3267
- "type": "string",
3268
- "minLength": 28,
3269
- "maxLength": 36
3270
- },
3271
- "name": {
3272
- "type": "string",
3273
- "maxLength": 200
3274
- },
3275
- "version": {
3276
- "type": "string",
3277
- "maxLength": 200
3278
- }
3279
- },
3280
- "required": [
3281
- "id",
3282
- "name",
3283
- "version"
3284
- ],
3285
- "additionalProperties": false
3286
- }
3287
- },
3288
- "integrations": {
3289
- "type": "object",
3290
- "additionalProperties": {
3291
- "type": "object",
3292
- "properties": {
3293
- "id": {
3294
- "type": "string",
3295
- "minLength": 28,
3296
- "maxLength": 36
3297
- },
3298
- "name": {
3299
- "type": "string",
3300
- "maxLength": 200
3301
- },
3302
- "version": {
3303
- "type": "string",
3304
- "maxLength": 200
3305
- }
3306
- },
3307
- "required": [
3308
- "id",
3309
- "name",
3310
- "version"
3311
- ],
3312
- "additionalProperties": false
3313
- }
3314
- }
3315
- },
3316
- "required": [
3317
- "interfaces",
3318
- "integrations"
3319
- ],
3320
- "additionalProperties": false
3321
- },
3322
- "user": {
3323
- "type": "object",
3324
- "properties": {
3325
- "tags": {
3326
- "type": "object",
3327
- "additionalProperties": {
3328
- "type": "object",
3329
- "properties": {
3330
- "title": {
3331
- "type": "string",
3332
- "maxLength": 64,
3333
- "description": "Title of the tag"
3334
- },
3335
- "description": {
3336
- "type": "string",
3337
- "maxLength": 256,
3338
- "description": "Description of the tag"
3339
- }
3340
- },
3341
- "description": "Definition of a tag that can be provided on the object",
3342
- "additionalProperties": false
3343
- }
3344
- }
3345
- },
3346
- "required": [
3347
- "tags"
3348
- ],
3349
- "description": "User object configuration",
3350
- "additionalProperties": false
3351
- },
3352
- "conversation": {
3353
- "type": "object",
3354
- "properties": {
3355
- "tags": {
3356
- "type": "object",
3357
- "additionalProperties": {
3358
- "type": "object",
3359
- "properties": {
3360
- "title": {
3361
- "type": "string",
3362
- "maxLength": 64,
3363
- "description": "Title of the tag"
3364
- },
3365
- "description": {
3366
- "type": "string",
3367
- "maxLength": 256,
3368
- "description": "Description of the tag"
3369
- }
3370
- },
3371
- "description": "Definition of a tag that can be provided on the object",
3372
- "additionalProperties": false
3373
- }
3374
- }
3375
- },
3376
- "required": [
3377
- "tags"
3378
- ],
3379
- "description": "Conversation object configuration",
3380
- "additionalProperties": false
3381
- },
3382
- "attributes": {
3383
- "type": "object",
3384
- "additionalProperties": {
3385
- "type": "string",
3386
- "maxLength": 200
3387
- },
3388
- "description": "Optional attributes"
3389
- },
3390
- "title": {
3391
- "type": "string",
3392
- "minLength": 1,
3393
- "maxLength": 64,
3394
- "description": "Title of the plugin. This is the name that will be displayed in the UI"
3395
- },
3396
- "description": {
3397
- "type": "string",
3398
- "maxLength": 256,
3399
- "description": "Description of the plugin. This is the description that will be displayed in the UI"
3400
- },
3401
- "iconUrl": {
3402
- "type": "string",
3403
- "description": "URL of the icon of the plugin. This is the icon that will be displayed in the UI"
3404
- },
3405
- "readmeUrl": {
3406
- "type": "string",
3407
- "description": "URL of the readme of the plugin. This is the readme that will be displayed in the UI"
3408
- },
3409
- "public": {
3410
- "type": "boolean",
3411
- "description": "Indicates if the plugin is public. Public plugins are available to all and cannot be updated without creating a new version."
3412
- }
3413
- },
3414
- "required": [
3415
- "id",
3416
- "name",
3417
- "version",
3418
- "createdAt",
3419
- "updatedAt",
3420
- "configuration",
3421
- "states",
3422
- "events",
3423
- "actions",
3424
- "dependencies",
3425
- "user",
3426
- "conversation",
3427
- "title",
3428
- "description",
3429
- "iconUrl",
3430
- "readmeUrl",
3431
- "public"
3432
- ],
3433
- "additionalProperties": false
3434
- }
3435
- },
3436
- "Workspace": {
3437
- "section": "workspace",
3438
- "schema": {
3439
- "type": "object",
3440
- "properties": {
3441
- "id": {
3442
- "type": "string"
3443
- },
3444
- "name": {
3445
- "type": "string"
3446
- },
3447
- "ownerId": {
3448
- "type": "string"
3449
- },
3450
- "createdAt": {
3451
- "type": "string"
3452
- },
3453
- "updatedAt": {
3454
- "type": "string"
3455
- },
3456
- "botCount": {
3457
- "type": "number"
3458
- },
3459
- "billingVersion": {
3460
- "type": "string",
3461
- "enum": [
3462
- "v1",
3463
- "v2",
3464
- "v3"
3465
- ]
3466
- },
3467
- "plan": {
3468
- "type": "string",
3469
- "enum": [
3470
- "community",
3471
- "team",
3472
- "enterprise",
3473
- "plus"
3474
- ]
3475
- },
3476
- "blocked": {
3477
- "type": "boolean"
3478
- },
3479
- "spendingLimit": {
3480
- "type": "number"
3481
- },
3482
- "about": {
3483
- "default": "",
3484
- "type": "string"
3485
- },
3486
- "profilePicture": {
3487
- "default": "",
3488
- "type": "string"
3489
- },
3490
- "contactEmail": {
3491
- "default": "",
3492
- "type": "string"
3493
- },
3494
- "website": {
3495
- "default": "",
3496
- "type": "string"
3497
- },
3498
- "socialAccounts": {
3499
- "default": [],
3500
- "type": "array",
3501
- "items": {
3502
- "type": "string"
3503
- }
3504
- },
3505
- "isPublic": {
3506
- "type": "boolean"
3507
- },
3508
- "handle": {
3509
- "type": "string"
3510
- },
3511
- "activeTrialId": {
3512
- "type": "string",
3513
- "nullable": true
3514
- }
3515
- },
3516
- "required": [
3517
- "id",
3518
- "name",
3519
- "ownerId",
3520
- "createdAt",
3521
- "updatedAt",
3522
- "botCount",
3523
- "billingVersion",
3524
- "plan",
3525
- "blocked",
3526
- "spendingLimit",
3527
- "activeTrialId"
3528
- ],
3529
- "title": "updateWorkspaceResponse",
3530
- "additionalProperties": false
3531
- }
3532
- },
3533
- "WorkspaceMember": {
3534
- "section": "workspaceMember",
3535
- "schema": {
3536
- "type": "object",
3537
- "properties": {
3538
- "id": {
3539
- "type": "string"
3540
- },
3541
- "userId": {
3542
- "type": "string",
3543
- "format": "uuid"
3544
- },
3545
- "email": {
3546
- "type": "string"
3547
- },
3548
- "createdAt": {
3549
- "type": "string"
3550
- },
3551
- "role": {
3552
- "type": "string",
3553
- "enum": [
3554
- "viewer",
3555
- "billing",
3556
- "developer",
3557
- "manager",
3558
- "administrator",
3559
- "owner"
3560
- ]
3561
- },
3562
- "profilePicture": {
3563
- "type": "string"
3564
- },
3565
- "displayName": {
3566
- "type": "string",
3567
- "maxLength": 100
3568
- }
3569
- },
3570
- "required": [
3571
- "id",
3572
- "email",
3573
- "createdAt",
3574
- "role"
3575
- ],
3576
- "title": "updateWorkspaceMemberResponse",
3577
- "additionalProperties": false
3578
- }
3579
- },
3580
- "Account": {
3581
- "section": "account",
3582
- "schema": {
3583
- "type": "object",
3584
- "properties": {
3585
- "id": {
3586
- "type": "string"
3587
- },
3588
- "email": {
3589
- "type": "string"
3590
- },
3591
- "displayName": {
3592
- "type": "string",
3593
- "maxLength": 100
3594
- },
3595
- "emailVerified": {
3596
- "type": "boolean"
3597
- },
3598
- "profilePicture": {
3599
- "type": "string"
3600
- },
3601
- "createdAt": {
3602
- "type": "string",
3603
- "format": "date-time",
3604
- "description": "Creation date of the [Account](#schema_account) in ISO 8601 format"
3605
- }
3606
- },
3607
- "required": [
3608
- "id",
3609
- "email",
3610
- "emailVerified",
3611
- "createdAt"
3612
- ],
3613
- "additionalProperties": false
3614
- }
3615
- },
3616
- "Usage": {
3617
- "section": "usage",
3618
- "schema": {
3619
- "type": "object",
3620
- "properties": {
3621
- "id": {
3622
- "type": "string",
3623
- "description": "Id of the usage that it is linked to. It can either be a workspace id or a bot id"
3624
- },
3625
- "period": {
3626
- "type": "string",
3627
- "description": "Period of the quota that it is applied to"
3628
- },
3629
- "value": {
3630
- "type": "number",
3631
- "description": "Value of the current usage"
3632
- },
3633
- "quota": {
3634
- "type": "number",
3635
- "description": "Quota of the current usage"
3636
- },
3637
- "type": {
3638
- "type": "string",
3639
- "enum": [
3640
- "invocation_timeout",
3641
- "invocation_calls",
3642
- "storage_count",
3643
- "bot_count",
3644
- "knowledgebase_vector_storage",
3645
- "workspace_ratelimit",
3646
- "table_row_count",
3647
- "workspace_member_count",
3648
- "integrations_owned_count",
3649
- "ai_spend",
3650
- "openai_spend",
3651
- "bing_search_spend",
3652
- "always_alive"
3653
- ],
3654
- "description": "Usage type that can be used"
3655
- }
3656
- },
3657
- "required": [
3658
- "id",
3659
- "period",
3660
- "value",
3661
- "quota",
3662
- "type"
3663
- ],
3664
- "additionalProperties": false
3665
- }
3666
- },
3667
- "Issue": {
3668
- "section": "bot",
3669
- "schema": {
3670
- "type": "object",
3671
- "properties": {
3672
- "id": {
3673
- "type": "string"
3674
- },
3675
- "code": {
3676
- "type": "string"
3677
- },
3678
- "createdAt": {
3679
- "type": "string",
3680
- "format": "date-time"
3681
- },
3682
- "lastSeenAt": {
3683
- "type": "string",
3684
- "format": "date-time"
3685
- },
3686
- "title": {
3687
- "type": "string"
3688
- },
3689
- "description": {
3690
- "type": "string"
3691
- },
3692
- "groupedData": {
3693
- "type": "object",
3694
- "additionalProperties": {
3695
- "type": "object",
3696
- "properties": {
3697
- "raw": {
3698
- "type": "string"
3699
- },
3700
- "pretty": {
3701
- "type": "string"
3702
- }
3703
- },
3704
- "required": [
3705
- "raw"
3706
- ],
3707
- "additionalProperties": false
3708
- }
3709
- },
3710
- "eventsCount": {
3711
- "type": "number"
3712
- },
3713
- "category": {
3714
- "type": "string",
3715
- "enum": [
3716
- "user_code",
3717
- "limits",
3718
- "configuration",
3719
- "other"
3720
- ]
3721
- },
3722
- "resolutionLink": {
3723
- "type": "string",
3724
- "nullable": true
3725
- }
3726
- },
3727
- "required": [
3728
- "id",
3729
- "code",
3730
- "createdAt",
3731
- "lastSeenAt",
3732
- "title",
3733
- "description",
3734
- "groupedData",
3735
- "eventsCount",
3736
- "category",
3737
- "resolutionLink"
3738
- ],
3739
- "additionalProperties": false
3740
- }
3741
- },
3742
- "IssueEvent": {
3743
- "section": "bot",
3744
- "schema": {
3745
- "type": "object",
3746
- "properties": {
3747
- "id": {
3748
- "type": "string"
3749
- },
3750
- "createdAt": {
3751
- "type": "string",
3752
- "format": "date-time"
3753
- },
3754
- "data": {
3755
- "type": "object",
3756
- "additionalProperties": {
3757
- "type": "object",
3758
- "properties": {
3759
- "raw": {
3760
- "type": "string"
3761
- },
3762
- "pretty": {
3763
- "type": "string"
3764
- }
3765
- },
3766
- "required": [
3767
- "raw"
3768
- ],
3769
- "additionalProperties": false
3770
- }
3771
- }
3772
- },
3773
- "required": [
3774
- "id",
3775
- "createdAt",
3776
- "data"
3777
- ],
3778
- "additionalProperties": false
3779
- }
3780
- },
3781
- "Activity": {
3782
- "section": "activity",
3783
- "schema": {
3784
- "type": "object",
3785
- "properties": {
3786
- "id": {
3787
- "type": "string"
3788
- },
3789
- "description": {
3790
- "type": "string"
3791
- },
3792
- "taskId": {
3793
- "type": "string"
3794
- },
3795
- "category": {
3796
- "type": "string",
3797
- "enum": [
3798
- "unknown",
3799
- "capture",
3800
- "bot_message",
3801
- "user_message",
3802
- "agent_message",
3803
- "event",
3804
- "action",
3805
- "task_status",
3806
- "subtask_status",
3807
- "exception"
3808
- ]
3809
- },
3810
- "data": {
3811
- "type": "object",
3812
- "additionalProperties": true
3813
- },
3814
- "createdAt": {
3815
- "type": "string",
3816
- "format": "date-time",
3817
- "description": "Creation date of the activity in ISO 8601 format"
3818
- }
3819
- },
3820
- "required": [
3821
- "id",
3822
- "description",
3823
- "taskId",
3824
- "category",
3825
- "data",
3826
- "createdAt"
3827
- ],
3828
- "additionalProperties": false
3829
- }
3830
- },
3831
- "Version": {
3832
- "section": "bot",
3833
- "schema": {
3834
- "type": "object",
3835
- "properties": {
3836
- "id": {
3837
- "type": "string"
3838
- },
3839
- "name": {
3840
- "type": "string"
3841
- },
3842
- "description": {
3843
- "type": "string"
3844
- }
3845
- },
3846
- "required": [
3847
- "id",
3848
- "name"
3849
- ],
3850
- "additionalProperties": false
3851
- }
3852
- },
3853
- "User": {
3854
- "section": "user",
3855
- "schema": {
3856
- "type": "object",
3857
- "properties": {
3858
- "id": {
3859
- "type": "string",
3860
- "minLength": 28,
3861
- "maxLength": 36,
3862
- "description": "Id of the [User](#schema_user)"
3863
- },
3864
- "createdAt": {
3865
- "type": "string",
3866
- "format": "date-time",
3867
- "description": "Creation date of the [User](#schema_user) in ISO 8601 format"
3868
- },
3869
- "updatedAt": {
3870
- "type": "string",
3871
- "format": "date-time",
3872
- "description": "Updating date of the [User](#schema_user) in ISO 8601 format"
3873
- },
3874
- "tags": {
3875
- "type": "object",
3876
- "additionalProperties": {
3877
- "type": "string"
3878
- },
3879
- "description": "Set of [Tags](/docs/developers/concepts/tags) that you can attach to a [User](#schema_user). The set of [Tags](/docs/developers/concepts/tags) available on a [User](#schema_user) is restricted by the list of [Tags](/docs/developers/concepts/tags) defined previously by the [Bot](#schema_bot). Individual keys can be unset by posting an empty value to them."
3880
- },
3881
- "name": {
3882
- "type": "string",
3883
- "maxLength": 200,
3884
- "description": "Name of the [User](#schema_user)"
3885
- },
3886
- "pictureUrl": {
3887
- "type": "string",
3888
- "maxLength": 40000,
3889
- "description": "Picture URL of the [User](#schema_user)"
3890
- }
3891
- },
3892
- "required": [
3893
- "id",
3894
- "createdAt",
3895
- "updatedAt",
3896
- "tags"
3897
- ],
3898
- "description": "The user object represents someone interacting with the bot within a specific integration. The same person interacting with a bot in slack and messenger will be represented with two different users.",
3899
- "additionalProperties": false
3900
- }
3901
- },
3902
- "Conversation": {
3903
- "section": "conversation",
3904
- "schema": {
3905
- "type": "object",
3906
- "properties": {
3907
- "id": {
3908
- "type": "string",
3909
- "minLength": 28,
3910
- "maxLength": 36,
3911
- "description": "Id of the [Conversation](#schema_conversation)"
3912
- },
3913
- "currentTaskId": {
3914
- "type": "string",
3915
- "minLength": 28,
3916
- "maxLength": 36,
3917
- "description": "Id of the current [Task](#schema_task)"
3918
- },
3919
- "currentWorkflowId": {
3920
- "type": "string",
3921
- "minLength": 28,
3922
- "maxLength": 36,
3923
- "description": "Id of the current [Workflow](#schema_workflow)"
3924
- },
3925
- "createdAt": {
3926
- "type": "string",
3927
- "format": "date-time",
3928
- "description": "Creation date of the [Conversation](#schema_conversation) in ISO 8601 format"
3929
- },
3930
- "updatedAt": {
3931
- "type": "string",
3932
- "format": "date-time",
3933
- "description": "Updating date of the [Conversation](#schema_conversation) in ISO 8601 format"
3934
- },
3935
- "channel": {
3936
- "type": "string",
3937
- "description": "Name of the channel where the [Conversation](#schema_conversation) is happening"
3938
- },
3939
- "integration": {
3940
- "type": "string",
3941
- "description": "Name of the integration that created the [Conversation](#schema_conversation)"
3942
- },
3943
- "tags": {
3944
- "type": "object",
3945
- "additionalProperties": {
3946
- "type": "string"
3947
- },
3948
- "description": "Set of [Tags](/docs/developers/concepts/tags) that you can attach to a [Conversation](#schema_conversation). The set of [Tags](/docs/developers/concepts/tags) available on a [Conversation](#schema_conversation) is restricted by the list of [Tags](/docs/developers/concepts/tags) defined previously by the [Bot](#schema_bot). Individual keys can be unset by posting an empty value to them."
3949
- }
3950
- },
3951
- "required": [
3952
- "id",
3953
- "createdAt",
3954
- "updatedAt",
3955
- "channel",
3956
- "integration",
3957
- "tags"
3958
- ],
3959
- "description": "The [Conversation](#schema_conversation) object represents an exchange of messages between one or more users. A [Conversation](#schema_conversation) is always linked to an integration's channels. For example, a Slack channel represents a conversation.",
3960
- "additionalProperties": false
3961
- }
3962
- },
3963
- "Event": {
3964
- "section": "event",
3965
- "schema": {
3966
- "type": "object",
3967
- "properties": {
3968
- "id": {
3969
- "type": "string",
3970
- "minLength": 28,
3971
- "maxLength": 36,
3972
- "description": "Id of the [Event](#schema_event)"
3973
- },
3974
- "createdAt": {
3975
- "type": "string",
3976
- "format": "date-time",
3977
- "description": "Creation date of the [Event](#schema_event) in ISO 8601 format"
3978
- },
3979
- "type": {
3980
- "type": "string",
3981
- "maxLength": 200,
3982
- "description": "Type of the [Event](#schema_event)."
3983
- },
3984
- "payload": {
3985
- "type": "object",
3986
- "additionalProperties": true,
3987
- "description": "Payload is the content of the event defined by the integration installed on your bot or one of the default events created by our api."
3988
- },
3989
- "conversationId": {
3990
- "type": "string",
3991
- "minLength": 28,
3992
- "maxLength": 36,
3993
- "description": "ID of the [Conversation](#schema_conversation) to link the event to."
3994
- },
3995
- "userId": {
3996
- "type": "string",
3997
- "minLength": 28,
3998
- "maxLength": 36,
3999
- "description": "ID of the [User](#schema_user) to link the event to."
4000
- },
4001
- "messageId": {
4002
- "type": "string",
4003
- "minLength": 28,
4004
- "maxLength": 36,
4005
- "description": "ID of the [Message](#schema_message) to link the event to."
4006
- },
4007
- "status": {
4008
- "type": "string",
4009
- "enum": [
4010
- "pending",
4011
- "processed",
4012
- "ignored",
4013
- "failed",
4014
- "scheduled"
4015
- ]
4016
- },
4017
- "failureReason": {
4018
- "type": "string",
4019
- "maxLength": 2000,
4020
- "nullable": true,
4021
- "description": "Reason why the event failed to be processed"
4022
- }
4023
- },
4024
- "required": [
4025
- "id",
4026
- "createdAt",
4027
- "type",
4028
- "payload",
4029
- "status",
4030
- "failureReason"
4031
- ],
4032
- "description": "The event object represents an action or an occurrence.",
4033
- "additionalProperties": false
4034
- }
4035
- },
4036
- "Message": {
4037
- "section": "message",
4038
- "schema": {
4039
- "type": "object",
4040
- "properties": {
4041
- "id": {
4042
- "type": "string",
4043
- "minLength": 28,
4044
- "maxLength": 36,
4045
- "description": "Id of the [Message](#schema_message)"
4046
- },
4047
- "createdAt": {
4048
- "type": "string",
4049
- "format": "date-time",
4050
- "description": "Creation date of the [Message](#schema_message) in ISO 8601 format"
4051
- },
4052
- "updatedAt": {
4053
- "type": "string",
4054
- "format": "date-time",
4055
- "description": "Update date of the [Message](#schema_message) in ISO 8601 format"
4056
- },
4057
- "type": {
4058
- "type": "string",
4059
- "maxLength": 200,
4060
- "description": "Type of the [Message](#schema_message) represents the resource type that the message is related to"
4061
- },
4062
- "payload": {
4063
- "type": "object",
4064
- "additionalProperties": true,
4065
- "description": "Payload is the content type of the message. Accepted payload options: Text, Image, Choice, Dropdown, Card, Carousel, File, Audio, Video, Location"
4066
- },
4067
- "direction": {
4068
- "type": "string",
4069
- "enum": [
4070
- "incoming",
4071
- "outgoing"
4072
- ],
4073
- "description": "Direction of the message (`incoming` or `outgoing`)."
4074
- },
4075
- "userId": {
4076
- "type": "string",
4077
- "minLength": 28,
4078
- "maxLength": 36,
4079
- "description": "ID of the [User](#schema_user)"
4080
- },
4081
- "conversationId": {
4082
- "type": "string",
4083
- "minLength": 28,
4084
- "maxLength": 36,
4085
- "description": "ID of the [Conversation](#schema_conversation)"
4086
- },
4087
- "tags": {
4088
- "type": "object",
4089
- "additionalProperties": {
4090
- "type": "string"
4091
- },
4092
- "description": "Set of [Tags](/docs/developers/concepts/tags) that you can attach to a [Conversation](#schema_conversation). The set of [Tags](/docs/developers/concepts/tags) available on a [Conversation](#schema_conversation) is restricted by the list of [Tags](/docs/developers/concepts/tags) defined previously by the [Bot](#schema_bot). Individual keys can be unset by posting an empty value to them."
4093
- },
4094
- "origin": {
4095
- "type": "string",
4096
- "enum": [
4097
- "synthetic"
4098
- ],
4099
- "description": "Origin of the message (`synthetic`)."
4100
- }
4101
- },
4102
- "required": [
4103
- "id",
4104
- "createdAt",
4105
- "updatedAt",
4106
- "type",
4107
- "payload",
4108
- "direction",
4109
- "userId",
4110
- "conversationId",
4111
- "tags"
4112
- ],
4113
- "description": "The Message object represents a message in a [Conversation](#schema_conversation) for a specific [User](#schema_user).",
4114
- "additionalProperties": false
4115
- }
4116
- },
4117
- "State": {
4118
- "section": "state",
4119
- "schema": {
4120
- "type": "object",
4121
- "properties": {
4122
- "id": {
4123
- "type": "string",
4124
- "minLength": 28,
4125
- "maxLength": 36,
4126
- "description": "Id of the [State](#schema_state)"
4127
- },
4128
- "createdAt": {
4129
- "type": "string",
4130
- "format": "date-time",
4131
- "description": "Creation date of the [State](#schema_state) in ISO 8601 format"
4132
- },
4133
- "updatedAt": {
4134
- "type": "string",
4135
- "format": "date-time",
4136
- "description": "Updating date of the [State](#schema_state) in ISO 8601 format"
4137
- },
4138
- "botId": {
4139
- "type": "string",
4140
- "minLength": 28,
4141
- "maxLength": 36,
4142
- "description": "Id of the [Bot](#schema_bot)"
4143
- },
4144
- "conversationId": {
4145
- "type": "string",
4146
- "minLength": 28,
4147
- "maxLength": 36,
4148
- "description": "Id of the [Conversation](#schema_conversation)"
4149
- },
4150
- "userId": {
4151
- "type": "string",
4152
- "minLength": 28,
4153
- "maxLength": 36,
4154
- "description": "Id of the [User](#schema_user)"
4155
- },
4156
- "name": {
4157
- "type": "string",
4158
- "maxLength": 200,
4159
- "description": "Name of the [State](#schema_state) which is declared inside the bot definition"
4160
- },
4161
- "type": {
4162
- "type": "string",
4163
- "enum": [
4164
- "conversation",
4165
- "user",
4166
- "bot",
4167
- "task",
4168
- "integration",
4169
- "workflow"
4170
- ],
4171
- "description": "Type of the [State](#schema_state) represents the resource type (`conversation`, `user`, `bot`, `task`, `integration` or `workflow`) that the state is related to"
4172
- },
4173
- "payload": {
4174
- "type": "object",
4175
- "additionalProperties": true,
4176
- "description": "Payload is the content of the state defined by your bot."
4177
- }
4178
- },
4179
- "required": [
4180
- "id",
4181
- "createdAt",
4182
- "updatedAt",
4183
- "botId",
4184
- "name",
4185
- "type",
4186
- "payload"
4187
- ],
4188
- "description": "The state object represents the current payload. A state is always linked to either a bot, a conversation or a user.",
4189
- "additionalProperties": false
4190
- }
4191
- },
4192
- "Task": {
4193
- "section": "task",
4194
- "schema": {
4195
- "type": "object",
4196
- "properties": {
4197
- "id": {
4198
- "type": "string",
4199
- "minLength": 28,
4200
- "maxLength": 36,
4201
- "description": "Id of the [Task](#schema_task)"
4202
- },
4203
- "title": {
4204
- "type": "string",
4205
- "maxLength": 64,
4206
- "description": "Title describing the task"
4207
- },
4208
- "description": {
4209
- "type": "string",
4210
- "maxLength": 256,
4211
- "description": "All the notes related to the execution of the current task"
4212
- },
4213
- "type": {
4214
- "type": "string",
4215
- "description": "Type of the task"
4216
- },
4217
- "data": {
4218
- "type": "object",
4219
- "additionalProperties": true,
4220
- "description": "Content related to the task"
4221
- },
4222
- "status": {
4223
- "type": "string",
4224
- "enum": [
4225
- "pending",
4226
- "in_progress",
4227
- "failed",
4228
- "completed",
4229
- "blocked",
4230
- "paused",
4231
- "timeout",
4232
- "cancelled"
4233
- ],
4234
- "description": "Status of the task"
4235
- },
4236
- "parentTaskId": {
4237
- "type": "string",
4238
- "minLength": 28,
4239
- "maxLength": 36,
4240
- "description": "Parent task id is the parent task that created this task"
4241
- },
4242
- "conversationId": {
4243
- "type": "string",
4244
- "minLength": 28,
4245
- "maxLength": 36,
4246
- "description": "Conversation id related to this task"
4247
- },
4248
- "userId": {
4249
- "type": "string",
4250
- "minLength": 28,
4251
- "maxLength": 36,
4252
- "description": "Specific user related to this task"
4253
- },
4254
- "timeoutAt": {
4255
- "type": "string",
4256
- "format": "date-time",
4257
- "description": "The timeout date where the task should be failed in the ISO 8601 format"
4258
- },
4259
- "createdAt": {
4260
- "type": "string",
4261
- "format": "date-time",
4262
- "description": "Creation date of the task in ISO 8601 format"
4263
- },
4264
- "updatedAt": {
4265
- "type": "string",
4266
- "format": "date-time",
4267
- "description": "Updating date of the task in ISO 8601 format"
4268
- },
4269
- "failureReason": {
4270
- "type": "string",
4271
- "maxLength": 2000,
4272
- "description": "If the task fails this is the reason behind it"
4273
- },
4274
- "tags": {
4275
- "type": "object",
4276
- "additionalProperties": {
4277
- "type": "string"
4278
- },
4279
- "description": "Set of [Tags](/docs/developers/concepts/tags) that you can attach to a [Task](#schema_task). Individual keys can be unset by posting an empty value to them."
4280
- }
4281
- },
4282
- "required": [
4283
- "id",
4284
- "title",
4285
- "description",
4286
- "type",
4287
- "data",
4288
- "status",
4289
- "timeoutAt",
4290
- "createdAt",
4291
- "updatedAt",
4292
- "tags"
4293
- ],
4294
- "description": "Task definition",
4295
- "additionalProperties": false
4296
- }
1313
+ {
1314
+ "status": 400,
1315
+ "type": "ReferenceNotFound",
1316
+ "description": "The provided resource reference is missing. This is usually caused when providing an invalid id inside the payload of a request."
4297
1317
  },
4298
- "Workflow": {
4299
- "section": "workflow",
4300
- "schema": {
4301
- "type": "object",
4302
- "properties": {
4303
- "id": {
4304
- "type": "string",
4305
- "minLength": 28,
4306
- "maxLength": 36,
4307
- "description": "Id of the [Workflow](#schema_workflow)"
4308
- },
4309
- "name": {
4310
- "type": "string",
4311
- "maxLength": 200,
4312
- "description": "Name of the workflow"
4313
- },
4314
- "status": {
4315
- "type": "string",
4316
- "enum": [
4317
- "pending",
4318
- "in_progress",
4319
- "failed",
4320
- "completed",
4321
- "listening",
4322
- "paused",
4323
- "timedout",
4324
- "cancelled"
4325
- ],
4326
- "description": "Status of the [Workflow](#schema_workflow)"
4327
- },
4328
- "input": {
4329
- "type": "object",
4330
- "additionalProperties": true,
4331
- "description": "Input provided to the [Workflow](#schema_workflow)"
4332
- },
4333
- "output": {
4334
- "type": "object",
4335
- "additionalProperties": true,
4336
- "description": "Data returned by the [Workflow](#schema_workflow) output"
4337
- },
4338
- "parentWorkflowId": {
4339
- "type": "string",
4340
- "minLength": 28,
4341
- "maxLength": 36,
4342
- "description": "Parent [Workflow](#schema_workflow) id is the parent [Workflow](#schema_workflow) that created this [Workflow](#schema_workflow)"
4343
- },
4344
- "conversationId": {
4345
- "type": "string",
4346
- "minLength": 28,
4347
- "maxLength": 36,
4348
- "description": "Conversation id related to this [Workflow](#schema_workflow)"
4349
- },
4350
- "userId": {
4351
- "type": "string",
4352
- "minLength": 28,
4353
- "maxLength": 36,
4354
- "description": "User id related to this [Workflow](#schema_workflow)"
4355
- },
4356
- "createdAt": {
4357
- "type": "string",
4358
- "format": "date-time",
4359
- "description": "Creation date of the [Workflow](#schema_workflow) in ISO 8601 format"
4360
- },
4361
- "updatedAt": {
4362
- "type": "string",
4363
- "format": "date-time",
4364
- "description": "Updating date of the [Workflow](#schema_workflow) in ISO 8601 format"
4365
- },
4366
- "completedAt": {
4367
- "type": "string",
4368
- "format": "date-time",
4369
- "description": "The date when the [Workflow](#schema_workflow) completed in ISO 8601 format"
4370
- },
4371
- "failureReason": {
4372
- "type": "string",
4373
- "maxLength": 2000,
4374
- "description": "If the [Workflow](#schema_workflow) fails this is the reason behind it"
4375
- },
4376
- "timeoutAt": {
4377
- "type": "string",
4378
- "format": "date-time",
4379
- "description": "The timeout date when the [Workflow](#schema_workflow) will fail in the ISO 8601 format"
4380
- },
4381
- "tags": {
4382
- "type": "object",
4383
- "additionalProperties": {
4384
- "type": "string"
4385
- },
4386
- "description": "Set of [Tags](/docs/developers/concepts/tags) that you can attach to a [Workflow](#schema_workflow). Individual keys can be unset by posting an empty value to them."
4387
- }
4388
- },
4389
- "required": [
4390
- "id",
4391
- "name",
4392
- "status",
4393
- "input",
4394
- "output",
4395
- "createdAt",
4396
- "updatedAt",
4397
- "timeoutAt",
4398
- "tags"
4399
- ],
4400
- "description": "Workflow definition",
4401
- "additionalProperties": false
4402
- }
1318
+ {
1319
+ "status": 400,
1320
+ "type": "InvalidQuery",
1321
+ "description": "The provided query is invalid. This is usually caused when providing an invalid parameter for querying a resource."
1322
+ },
1323
+ {
1324
+ "status": 400,
1325
+ "type": "Runtime",
1326
+ "description": "An error happened during the execution of a runtime (bot or integration)."
1327
+ },
1328
+ {
1329
+ "status": 409,
1330
+ "type": "AlreadyExists",
1331
+ "description": "The record attempted to be created already exists."
1332
+ },
1333
+ {
1334
+ "status": 429,
1335
+ "type": "RateLimited",
1336
+ "description": "The request has been rate limited."
1337
+ },
1338
+ {
1339
+ "status": 402,
1340
+ "type": "PaymentRequired",
1341
+ "description": "A payment is required to perform this request."
1342
+ },
1343
+ {
1344
+ "status": 403,
1345
+ "type": "QuotaExceeded",
1346
+ "description": "The request exceeds the allowed quota. Quotas are a soft limit that can be increased."
1347
+ },
1348
+ {
1349
+ "status": 413,
1350
+ "type": "LimitExceeded",
1351
+ "description": "The request exceeds the allowed limit. Limits are a hard limit that cannot be increased."
1352
+ },
1353
+ {
1354
+ "status": 400,
1355
+ "type": "BreakingChanges",
1356
+ "description": "Request payload contains breaking changes which is not allowed for this resource without a version increment."
1357
+ }
1358
+ ],
1359
+ "refs": {
1360
+ "parameters": {},
1361
+ "requestBodies": {
1362
+ "getOrCreateTableBody": true,
1363
+ "createTableBody": true,
1364
+ "duplicateTableBody": true,
1365
+ "importTableBody": true,
1366
+ "updateTableBody": true,
1367
+ "renameTableColumnBody": true,
1368
+ "findTableRowsBody": true,
1369
+ "createTableRowsBody": true,
1370
+ "deleteTableRowsBody": true,
1371
+ "updateTableRowsBody": true,
1372
+ "upsertTableRowsBody": true
1373
+ },
1374
+ "responses": {
1375
+ "listTablesResponse": true,
1376
+ "getTableResponse": true,
1377
+ "getOrCreateTableResponse": true,
1378
+ "createTableResponse": true,
1379
+ "duplicateTableResponse": true,
1380
+ "exportTableResponse": true,
1381
+ "getTableJobsResponse": true,
1382
+ "importTableResponse": true,
1383
+ "updateTableResponse": true,
1384
+ "renameTableColumnResponse": true,
1385
+ "deleteTableResponse": true,
1386
+ "getTableRowResponse": true,
1387
+ "findTableRowsResponse": true,
1388
+ "createTableRowsResponse": true,
1389
+ "deleteTableRowsResponse": true,
1390
+ "updateTableRowsResponse": true,
1391
+ "upsertTableRowsResponse": true
4403
1392
  },
1393
+ "schemas": {
1394
+ "Table": true,
1395
+ "Column": true,
1396
+ "Row": true
1397
+ }
1398
+ },
1399
+ "schemas": {
4404
1400
  "Table": {
4405
1401
  "section": "tables",
4406
1402
  "schema": {
@@ -4826,292 +1822,9 @@ export const state = {
4826
1822
  ],
4827
1823
  "additionalProperties": true
4828
1824
  }
4829
- },
4830
- "File": {
4831
- "section": "files",
4832
- "schema": {
4833
- "type": "object",
4834
- "properties": {
4835
- "id": {
4836
- "type": "string",
4837
- "description": "File ID"
4838
- },
4839
- "botId": {
4840
- "type": "string",
4841
- "description": "The ID of the bot the file belongs to"
4842
- },
4843
- "key": {
4844
- "type": "string",
4845
- "description": "Unique key for the file. Must be unique across the bot (and the integration, when applicable)."
4846
- },
4847
- "url": {
4848
- "type": "string",
4849
- "description": "URL to retrieve the file content. This URL will be ready to use once the file is uploaded.\n\nIf the file has a `public_content` policy, this will contain the permanent public URL to retrieve the file, otherwise this will contain a temporary pre-signed URL to download the file which should be used shortly after retrieving and should not be stored long-term as the URL will expire after a short timeframe."
4850
- },
4851
- "size": {
4852
- "type": "number",
4853
- "description": "File size in bytes. Non-null if file upload status is \"COMPLETE\".",
4854
- "nullable": true
4855
- },
4856
- "contentType": {
4857
- "type": "string",
4858
- "description": "MIME type of the file's content"
4859
- },
4860
- "tags": {
4861
- "type": "object",
4862
- "additionalProperties": {
4863
- "type": "string",
4864
- "maxLength": 1000
4865
- },
4866
- "description": "The tags of the file as an object of key/value pairs"
4867
- },
4868
- "metadata": {
4869
- "type": "object",
4870
- "additionalProperties": {
4871
- "nullable": true
4872
- },
4873
- "description": "Metadata of the file as an object of key/value pairs. The values can be of any type."
4874
- },
4875
- "createdAt": {
4876
- "type": "string",
4877
- "description": "File creation timestamp in ISO 8601 format"
4878
- },
4879
- "updatedAt": {
4880
- "type": "string",
4881
- "description": "File last update timestamp in ISO 8601 format"
4882
- },
4883
- "accessPolicies": {
4884
- "type": "array",
4885
- "items": {
4886
- "type": "string",
4887
- "enum": [
4888
- "integrations",
4889
- "public_content"
4890
- ]
4891
- },
4892
- "description": "Access policies configured for the file."
4893
- },
4894
- "index": {
4895
- "type": "boolean",
4896
- "description": "Whether the file was requested to be indexed for search or not."
4897
- },
4898
- "status": {
4899
- "type": "string",
4900
- "enum": [
4901
- "upload_pending",
4902
- "upload_failed",
4903
- "upload_completed",
4904
- "indexing_pending",
4905
- "indexing_failed",
4906
- "indexing_completed"
4907
- ],
4908
- "description": "Status of the file. If the status is `upload_pending`, the file content has not been uploaded yet. The status will be set to `upload_completed` once the file content has been uploaded successfully.\n\nIf the upload failed for any reason (e.g. exceeding the storage quota or the maximum file size limit) the status will be set to `upload_failed` and the reason for the failure will be available in the `failedStatusReason` field of the file.\n\nHowever, if the file has been uploaded and the `index` attribute was set to `true` on the file, the status will immediately transition to the `indexing_pending` status (the `upload_completed` status step will be skipped).\n\nOnce the indexing is completed and the file is ready to be used for searching its status will be set to `indexing_completed`. If the indexing failed the status will be set to `indexing_failed` and the reason for the failure will be available in the `failedStatusReason` field."
4909
- },
4910
- "failedStatusReason": {
4911
- "type": "string",
4912
- "description": "If the file status is `upload_failed` or `indexing_failed` this will contain the reason of the failure."
4913
- },
4914
- "expiresAt": {
4915
- "type": "string",
4916
- "description": "File expiry timestamp in ISO 8601 format"
4917
- },
4918
- "owner": {
4919
- "type": "object",
4920
- "properties": {
4921
- "type": {
4922
- "type": "string",
4923
- "enum": [
4924
- "bot",
4925
- "integration",
4926
- "user"
4927
- ]
4928
- },
4929
- "id": {
4930
- "type": "string",
4931
- "description": "This field is present if `type` is \"user\" or \"bot\". If `type` is \"user\", this is the user ID. If `type` is \"bot\", this is the bot ID."
4932
- },
4933
- "name": {
4934
- "type": "string",
4935
- "description": "This field is present if the `type` is \"integration\". If `type` is \"integration\", this is the integration name."
4936
- }
4937
- },
4938
- "required": [
4939
- "type"
4940
- ],
4941
- "additionalProperties": false
4942
- },
4943
- "indexingStack": {
4944
- "type": "string",
4945
- "enum": [
4946
- "v1",
4947
- "v2"
4948
- ],
4949
- "description": "Indicates the indexing stack used to index this file. Present only when file has been successfully indexed. A value of \"v2\" denotes the latest stack, \"v1\" denotes the legacy stack."
4950
- }
4951
- },
4952
- "required": [
4953
- "id",
4954
- "botId",
4955
- "key",
4956
- "url",
4957
- "size",
4958
- "contentType",
4959
- "tags",
4960
- "metadata",
4961
- "createdAt",
4962
- "updatedAt",
4963
- "accessPolicies",
4964
- "index",
4965
- "status",
4966
- "owner"
4967
- ],
4968
- "additionalProperties": false
4969
- }
4970
1825
  }
4971
1826
  },
4972
1827
  "sections": [
4973
- {
4974
- "description": "",
4975
- "title": "User",
4976
- "name": "user",
4977
- "operations": [],
4978
- "schema": "User"
4979
- },
4980
- {
4981
- "description": "",
4982
- "title": "Conversation",
4983
- "name": "conversation",
4984
- "operations": [],
4985
- "schema": "Conversation"
4986
- },
4987
- {
4988
- "description": "",
4989
- "title": "Event",
4990
- "name": "event",
4991
- "operations": [],
4992
- "schema": "Event"
4993
- },
4994
- {
4995
- "description": "",
4996
- "title": "Message",
4997
- "name": "message",
4998
- "operations": [],
4999
- "schema": "Message"
5000
- },
5001
- {
5002
- "description": "",
5003
- "title": "State",
5004
- "name": "state",
5005
- "operations": [],
5006
- "schema": "State"
5007
- },
5008
- {
5009
- "title": "Hub",
5010
- "description": "",
5011
- "name": "hub",
5012
- "operations": []
5013
- },
5014
- {
5015
- "description": "",
5016
- "title": "Action",
5017
- "name": "action",
5018
- "operations": []
5019
- },
5020
- {
5021
- "description": "",
5022
- "title": "Task",
5023
- "name": "task",
5024
- "operations": [],
5025
- "schema": "Task"
5026
- },
5027
- {
5028
- "description": "",
5029
- "title": "Workflow",
5030
- "name": "workflow",
5031
- "operations": [],
5032
- "schema": "Workflow"
5033
- },
5034
- {
5035
- "description": "",
5036
- "title": "Tag",
5037
- "name": "tag",
5038
- "operations": []
5039
- },
5040
- {
5041
- "title": "Bot",
5042
- "description": "",
5043
- "name": "bot",
5044
- "operations": [],
5045
- "schema": "Bot"
5046
- },
5047
- {
5048
- "title": "Integration",
5049
- "description": "",
5050
- "name": "integration",
5051
- "operations": [],
5052
- "schema": "Integration"
5053
- },
5054
- {
5055
- "title": "Interface",
5056
- "description": "",
5057
- "name": "interface",
5058
- "operations": [],
5059
- "schema": "Interface"
5060
- },
5061
- {
5062
- "title": "Plugin",
5063
- "description": "",
5064
- "name": "plugin",
5065
- "operations": [],
5066
- "schema": "Plugin"
5067
- },
5068
- {
5069
- "title": "Workspace",
5070
- "description": "",
5071
- "name": "workspace",
5072
- "operations": [],
5073
- "schema": "Workspace"
5074
- },
5075
- {
5076
- "title": "Workspace Member",
5077
- "description": "",
5078
- "name": "workspaceMember",
5079
- "operations": [],
5080
- "schema": "WorkspaceMember"
5081
- },
5082
- {
5083
- "title": "Account",
5084
- "description": "",
5085
- "name": "account",
5086
- "operations": [],
5087
- "schema": "Account"
5088
- },
5089
- {
5090
- "title": "Usage",
5091
- "description": "",
5092
- "name": "usage",
5093
- "operations": [],
5094
- "schema": "Usage"
5095
- },
5096
- {
5097
- "title": "Quotas",
5098
- "description": "",
5099
- "name": "quotas",
5100
- "operations": []
5101
- },
5102
- {
5103
- "title": "Helper",
5104
- "description": "",
5105
- "name": "helper",
5106
- "operations": []
5107
- },
5108
- {
5109
- "title": "Activity",
5110
- "description": "",
5111
- "name": "activity",
5112
- "operations": [],
5113
- "schema": "Activity"
5114
- },
5115
1828
  {
5116
1829
  "title": "Tables",
5117
1830
  "description": "Manage and interact with table structures, including creation, updates, and querying of tables and their rows.",
@@ -5136,13 +1849,6 @@ export const state = {
5136
1849
  "upsertTableRows"
5137
1850
  ],
5138
1851
  "schema": "Table"
5139
- },
5140
- {
5141
- "title": "Files",
5142
- "description": "The Files API allows you to create, manage, and index files that can be used by your bots and integrations. Files can be in any text or binary format, and documents (such as PDF, Microsoft Word, HTML, Markdown, etc.) can be indexed to be used for semantic search in RAG (Retrieval Augmented Generation) implementations. Files are private by default but can be made publicly accessible through a permanent URL that's unique for each file.",
5143
- "name": "files",
5144
- "operations": [],
5145
- "schema": "File"
5146
1852
  }
5147
1853
  ],
5148
1854
  "options": {