@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.
- package/dist/integration.yml +21 -4
- package/dist/mcp-server.yml +17 -2
- package/dist/subscription.yml +43 -4
- package/dist/topic.yml +21 -4
- package/package.json +1 -1
- package/schemas.json +1 -1
package/dist/integration.yml
CHANGED
|
@@ -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
|
|
5122
|
-
|
|
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:
|
|
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
|
package/dist/mcp-server.yml
CHANGED
|
@@ -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
|
-
|
|
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
|
package/dist/subscription.yml
CHANGED
|
@@ -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,
|
|
1244
|
-
|
|
1245
|
-
|
|
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
|
|
1292
|
-
|
|
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:
|
|
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