@celigo/api-specs 0.2.94 → 0.2.95

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.
@@ -5116,17 +5116,19 @@ components:
5116
5116
  - 6aab2870265e1cf39fcbee4d
5117
5117
  draft:
5118
5118
  type: boolean
5119
- readOnly: true
5120
5119
  description: |-
5121
- When true, the topic was created as a draft by the AI-assisted builder and has not been
5122
- confirmed yet. Absent on ordinary topics.
5120
+ When true, the topic is an unconfirmed draft (created with `draft: true`, typically by
5121
+ the AI-assisted builder) that auto-deletes at `draftExpiresAt`. Absent on ordinary
5122
+ topics and once a `PUT` with `draft: false` promotes the draft.
5123
5123
  examples:
5124
5124
  - true
5125
5125
  draftExpiresAt:
5126
5126
  type: string
5127
5127
  format: date-time
5128
5128
  readOnly: true
5129
- description: Timestamp when an unconfirmed draft is deleted automatically. Present only when `draft` is true.
5129
+ description: |-
5130
+ Timestamp when an unconfirmed draft is deleted automatically — 48 hours after
5131
+ creation. Present only while `draft` is true; cleared together with it.
5130
5132
  examples:
5131
5133
  - '2026-09-24T03:30:27.432Z'
5132
5134
  createdAt:
@@ -5212,6 +5214,21 @@ components:
5212
5214
  `GET /v1/topics?externalId=…`. Integration Apps use it to locate a topic across installs.
5213
5215
  examples:
5214
5216
  - erp-orders-created
5217
+ draft:
5218
+ type: boolean
5219
+ description: |-
5220
+ When true, the topic is a draft that auto-deletes 48 hours after creation
5221
+ (`draftExpiresAt` in the response). Set at creation; an update can clear the
5222
+ flag but never set it, and a PUT that omits it leaves an existing draft as is —
5223
+ the one field the whole-document PUT does not clear.
5224
+ x-celigo-ai-guidance:
5225
+ - |-
5226
+ POST with `draft: true` arms the 48-hour TTL (the server computes `draftExpiresAt`).
5227
+ PUT with `draft: false` clears the flag and the expiry, promoting the draft to a
5228
+ permanent topic. PUT with `draft: true` on a non-draft topic is silently ignored,
5229
+ and a PUT that omits the field leaves an existing draft flag unchanged.
5230
+ examples:
5231
+ - true
5215
5232
  __integrationIds:
5216
5233
  type: array
5217
5234
  maxItems: 100
@@ -2669,6 +2669,9 @@ components:
2669
2669
  every other field is taken from the stored row, and a write that includes
2670
2670
  `upstreamMcpConnections` re-approves the current upstream definitions
2671
2671
  (`approvedDefinitionHash` is re-pinned and `changedSinceApproval` reset).
2672
+ Each attachment whitelists at most 500 rows across `tools`, `prompts`,
2673
+ and `resources` combined; a larger whitelist is rejected with 422
2674
+ `mcp_upstream_max_capabilities`.
2672
2675
  x-celigo-ai-guidance:
2673
2676
  - |-
2674
2677
  Attach only connections of type "mcp" that belong to this account: any
@@ -2679,6 +2682,16 @@ components:
2679
2682
  To edit one row (enable, disable, rename, retitle) send the complete
2680
2683
  upstreamMcpConnections array back via PUT: the array is preserved when
2681
2684
  omitted, and PATCH reaches only /upstreamMcpConnections/{index}/alias.
2685
+ - |-
2686
+ Keep each attachment at 500 rows or fewer across tools, prompts, and
2687
+ resources combined: the 501st row fails the whole PUT with 422
2688
+ "mcp_upstream_max_capabilities" on upstreamMcpConnections[{index}].
2689
+ The cap is per attachment, so a second connection gets its own 500.
2690
+ - |-
2691
+ Set alias explicitly when the connection name is longer than 32
2692
+ characters: the alias derived from the name on first attach fails the
2693
+ PUT with 422 "size_limit_exceeded" on upstreamMcpConnections.{index}.alias,
2694
+ the same response an explicit alias of 33 or more characters gets.
2682
2695
  required:
2683
2696
  - _connectionId
2684
2697
  properties:
@@ -2699,8 +2712,10 @@ components:
2699
2712
  Short handle that namespaces the upstream's capabilities on this
2700
2713
  server. Lowercased on save and unique per server (case-insensitive) —
2701
2714
  a duplicate is rejected with 422 `mcp_upstream_duplicate_alias`, an
2702
- invalid character with 422 `mcp_upstream_invalid_alias_charset`.
2703
- Derived from the connection name when omitted on the first attach.
2715
+ invalid character with 422 `mcp_upstream_invalid_alias_charset`, and
2716
+ an over-long value with 422 `size_limit_exceeded`.
2717
+ Derived from the connection name when omitted on the first attach, so
2718
+ a name longer than the alias cap needs an explicit alias.
2704
2719
  examples:
2705
2720
  - deepwiki
2706
2721
  - crm_tools
@@ -285,7 +285,21 @@ paths:
285
285
  connections:
286
286
  - _id: 62ac9ab6cd606e428737008e
287
287
  name: HubSpot (Production)
288
+ - type: http
289
+ _httpConnectorId: 6425e536bd748551c63024bc
290
+ connections:
291
+ - _id: 68ae48d6b5f755d2dd38c294
292
+ name: OpenAI
293
+ - type: ftp
294
+ hostURI: sftp.example.com
295
+ port: 22
296
+ connections:
297
+ - _id: 62ac8142839f01546de4db2a
298
+ name: Warehouse SFTP
288
299
  - type: rdbms
300
+ rdbms:
301
+ type: snowflake
302
+ host: celigo_partner
289
303
  connections:
290
304
  - _id: 69d096cd4e0c505cda036a3a
291
305
  name: Snowflake DW
@@ -1235,14 +1249,20 @@ components:
1235
1249
  type: string
1236
1250
  description: Integration name.
1237
1251
  example: POC – HubSpot → Snowflake
1252
+ isDeleted:
1253
+ type: boolean
1254
+ description: When true, the parent integration has been soft-deleted and sits in the recycle bin. Absent while the integration is live.
1255
+ example: true
1238
1256
  EndpointUsage:
1239
1257
  type: object
1240
1258
  description: |-
1241
1259
  Endpoint entitlement usage for the requesting environment. An endpoint is a connected
1242
1260
  application, not a connection record: connections that share a Celigo-managed application
1243
- profile (`assistant`) are one endpoint, generic HTTP connections without one are grouped by
1244
- `baseURI`, databases by `rdbms` engine and host, and other adaptor types by their own connection
1245
- identity (for example host and port). Each `endpoints[]` entry carries the fields it was grouped by.
1261
+ profile (`assistant`) are one endpoint, HTTP connections linked to an HTTP connector but without
1262
+ an `assistant` are grouped by `_httpConnectorId`, generic HTTP connections by `baseURI`,
1263
+ databases by `rdbms` engine and host, FTP servers by `hostURI` and `port`, and other adaptor
1264
+ types by their own connection identity. Each `endpoints[]` entry carries the fields it was
1265
+ grouped by.
1246
1266
  properties:
1247
1267
  numConsumed:
1248
1268
  type: integer
@@ -1271,10 +1291,29 @@ components:
1271
1291
  type: string
1272
1292
  description: Application assistant identifier, if the connection uses a Celigo-managed application profile (e.g., `hubspot`, `netsuite`). Connections sharing an assistant are one endpoint.
1273
1293
  example: hubspot
1294
+ _httpConnectorId:
1295
+ type: string
1296
+ format: objectId
1297
+ x-celigo-refModel: httpconnectors
1298
+ description: |-
1299
+ HTTP connector the endpoint's connections are linked to. Present when `type` is `http`
1300
+ and the connections carry `http._httpConnectorId` without an `assistant`; connections
1301
+ sharing the connector are one endpoint.
1302
+ example: 6425e536bd748551c63024bc
1274
1303
  baseURI:
1275
1304
  type: string
1276
- description: Base URI that identifies this endpoint for generic HTTP connections (those without an `assistant`); connections whose base URIs differ are separate endpoints.
1305
+ description: Base URI that identifies this endpoint for generic HTTP connections (those without an `assistant` or an HTTP connector); connections whose base URIs differ are separate endpoints.
1277
1306
  example: https://api.hubspot.com
1307
+ hostURI:
1308
+ type: string
1309
+ description: |-
1310
+ Server host the endpoint's connections point at. Present when `type` is `ftp`; with
1311
+ `port` it is the identity FTP endpoints are grouped by.
1312
+ example: sftp.example.com
1313
+ port:
1314
+ type: integer
1315
+ description: Server port the endpoint's connections use. Present when `type` is `ftp` and the connections set one.
1316
+ example: 22
1278
1317
  rdbms:
1279
1318
  type: object
1280
1319
  description: Database connection details. Present when `type` is `rdbms`.
package/dist/topic.yml CHANGED
@@ -1286,17 +1286,19 @@ components:
1286
1286
  - 6aab2870265e1cf39fcbee4d
1287
1287
  draft:
1288
1288
  type: boolean
1289
- readOnly: true
1290
1289
  description: |-
1291
- When true, the topic was created as a draft by the AI-assisted builder and has not been
1292
- confirmed yet. Absent on ordinary topics.
1290
+ When true, the topic is an unconfirmed draft (created with `draft: true`, typically by
1291
+ the AI-assisted builder) that auto-deletes at `draftExpiresAt`. Absent on ordinary
1292
+ topics and once a `PUT` with `draft: false` promotes the draft.
1293
1293
  examples:
1294
1294
  - true
1295
1295
  draftExpiresAt:
1296
1296
  type: string
1297
1297
  format: date-time
1298
1298
  readOnly: true
1299
- description: Timestamp when an unconfirmed draft is deleted automatically. Present only when `draft` is true.
1299
+ description: |-
1300
+ Timestamp when an unconfirmed draft is deleted automatically — 48 hours after
1301
+ creation. Present only while `draft` is true; cleared together with it.
1300
1302
  examples:
1301
1303
  - '2026-09-24T03:30:27.432Z'
1302
1304
  createdAt:
@@ -1422,6 +1424,21 @@ components:
1422
1424
  `GET /v1/topics?externalId=…`. Integration Apps use it to locate a topic across installs.
1423
1425
  examples:
1424
1426
  - erp-orders-created
1427
+ draft:
1428
+ type: boolean
1429
+ description: |-
1430
+ When true, the topic is a draft that auto-deletes 48 hours after creation
1431
+ (`draftExpiresAt` in the response). Set at creation; an update can clear the
1432
+ flag but never set it, and a PUT that omits it leaves an existing draft as is —
1433
+ the one field the whole-document PUT does not clear.
1434
+ x-celigo-ai-guidance:
1435
+ - |-
1436
+ POST with `draft: true` arms the 48-hour TTL (the server computes `draftExpiresAt`).
1437
+ PUT with `draft: false` clears the flag and the expiry, promoting the draft to a
1438
+ permanent topic. PUT with `draft: true` on a non-draft topic is silently ignored,
1439
+ and a PUT that omits the field leaves an existing draft flag unchanged.
1440
+ examples:
1441
+ - true
1425
1442
  __integrationIds:
1426
1443
  type: array
1427
1444
  maxItems: 100
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@celigo/api-specs",
3
- "version": "0.2.94",
3
+ "version": "0.2.95",
4
4
  "private": false,
5
5
  "description": "Public OpenAPI bundles (dist/) and the celigo-cli lint schema pack (schemas.json).",
6
6
  "keywords": [
package/schemas.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "provenance": {
3
3
  "repo": "celigo/integrator-api-specs",
4
- "iasCommit": "29615c6c",
4
+ "iasCommit": "cb3fa5ae",
5
5
  "generatedAt": "2026-10-12"
6
6
  },
7
7
  "roots": {