@celigo/api-specs 0.2.47 → 0.2.49

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.
@@ -809,9 +809,10 @@ components:
809
809
  sender/receiver IDs and control numbers — see individual field
810
810
  descriptions.
811
811
 
812
- Transaction records are retained for a license-dependent window (30, 60,
813
- or 180 days after last modification) and then expire; expired transactions
814
- no longer appear in query results. Unlike most resources, these records
812
+ Transaction records are retained for the account's data retention period
813
+ (`dataRetentionPeriod` on account settings: 30, 60, 90 or 180 days after
814
+ last modification; the license sets the ceiling) and then expire; expired
815
+ transactions no longer appear in query results. Unlike most resources, these records
815
816
  are not soft-deleted into the recycle bin, and `createdAt` / `deletedAt`
816
817
  are not returned.
817
818
  properties:
@@ -828,7 +829,10 @@ components:
828
829
  readOnly: true
829
830
  description: |-
830
831
  Timestamp when the record was last updated (e.g. by an faStatus
831
- change). Also restarts the retention window.
832
+ change). Also restarts the retention window — the record is kept for
833
+ the account's `dataRetentionPeriod` (30, 60, 90 or 180 days) after
834
+ this timestamp, so a record can outlive the raw file behind it, whose
835
+ period counts from when the file was stored.
832
836
  examples:
833
837
  - '2026-04-15T14:30:15.123Z'
834
838
  _userId:
@@ -515,8 +515,11 @@ paths:
515
515
  array, `add` works at `/policies/-` or an index, and `replace` works at
516
516
  an index or a sub-path such as `/policies/0/config/limit`; `remove` at
517
517
  an array index is rejected with 422 `Remove at array index is not
518
- supported`. The resulting array is validated as a whole, and an invalid
519
- policy rejects the entire patch. `/_networkPolicyId` takes `add`,
518
+ supported`. The resulting array is validated as a whole, and a policy
519
+ with invalid `config` (422 `policy_config_invalid`), a missing `name`,
520
+ or a second policy of the same `type` and `keyResolver` (422
521
+ `mcp_server_duplicate_policy`) rejects the entire patch.
522
+ `/_networkPolicyId` takes `add`,
520
523
  `replace` (a policy in the same environment, else 422 `invalid_ref`),
521
524
  and `remove` to unassign — `replace` with a `null` value is rejected
522
525
  with 422 `missing 'value' property`. Setting `/disabled` to `false` is rejected
@@ -2762,17 +2765,21 @@ components:
2762
2765
  server (`keyResolver` `endpoint`) or separately for each OAuth end user
2763
2766
  (`keyResolver` `consumer`); a `quota` caps cumulative calls over a UTC
2764
2767
  calendar DAY, WEEK, or MONTH across every consumer. A call must pass every
2765
- enabled policy. A rejected call is not executed and receives HTTP 429 with
2766
- a `Retry-After` header (seconds until the allowance refills or the quota
2768
+ enabled policy. A second policy of the same `type` and `keyResolver` is
2769
+ rejected with 422 `mcp_server_duplicate_policy`. A rejected call is not
2770
+ executed, does not count toward usage, and receives HTTP 429 with a
2771
+ `Retry-After` header (seconds until the allowance refills or the quota
2767
2772
  period resets), an `X-RateLimit-Limit` header, and a JSON-RPC error
2768
2773
  (code -32004) whose message names the policy: `Rate limit exceeded: <name>`
2769
- or `Usage quota exceeded: <name>`.
2774
+ or `Usage quota exceeded: <name>`. A quota counts only calls accepted after
2775
+ it was added; editing the limit keeps the running count for the current UTC
2776
+ period, and removing then re-adding the quota starts a new count.
2770
2777
  x-celigo-ai-guidance:
2771
2778
  - |-
2772
2779
  Configure one policy per kind — one server-level rate limit, one per-user
2773
- rate limit (`keyResolver` `consumer`), one quota. The API does not reject a
2774
- second policy of the same kind; both are then enforced against the same
2775
- traffic, which makes the effective limit hard to reason about.
2780
+ rate limit (`keyResolver` `consumer`), one quota. A second policy of the
2781
+ same `type` and `keyResolver` is rejected with 422
2782
+ `mcp_server_duplicate_policy`.
2776
2783
  - |-
2777
2784
  A `tools/call` counts against every enabled policy, even when the named tool
2778
2785
  does not exist; `initialize`, `tools/list`, `prompts/list`, and `resources/list`
@@ -2785,9 +2792,10 @@ components:
2785
2792
  - |-
2786
2793
  A rate limit keeps its allowance state when its `limit` is changed, so raising
2787
2794
  a limit right after it tripped admits nothing until tokens refill at the new
2788
- rate. A quota counts every call the server accepted in the current UTC period,
2789
- including calls made before the quota was configured — a quota below the
2790
- period's current count rejects every call until the period resets.
2795
+ rate. A quota counts calls accepted after it was added in the current UTC
2796
+ period; editing the limit keeps the running count, and removing then
2797
+ re-adding the quota starts a new count. Calls rejected by a traffic limit
2798
+ do not consume quota, so raising a quota mid-period takes effect immediately.
2791
2799
  required:
2792
2800
  - type
2793
2801
  - name
@@ -2809,10 +2817,11 @@ components:
2809
2817
  - rate-limit
2810
2818
  name:
2811
2819
  type: string
2812
- maxLength: 100
2820
+ maxLength: 200
2813
2821
  description: |-
2814
- Label for the limit, echoed verbatim in the 429 error message that
2815
- rejected clients receive — name it the way consumers should read it.
2822
+ Required label for the limit, echoed verbatim in the 429 error message
2823
+ that rejected clients receive — name it the way consumers should read
2824
+ it. A missing or empty name is rejected with 422.
2816
2825
  examples:
2817
2826
  - Server-level rate limit
2818
2827
  - Per-user rate limit
@@ -3253,10 +3262,15 @@ components:
3253
3262
  description: |-
3254
3263
  Traffic limits enforced on this server before a tool runs — a
3255
3264
  server-level rate limit, a per-user rate limit, and a usage quota, each
3256
- optional and independent. An empty array (the default) means unlimited.
3257
- Always returned; servers saved before traffic limits existed return an
3258
- empty array. Omitting the field on PUT clears every limit — send the
3259
- complete array back, or edit it with PATCH.
3265
+ optional and independent. At most one policy per `type` and
3266
+ `keyResolver` is allowed; a second is rejected with 422
3267
+ `mcp_server_duplicate_policy`. An empty array (the default) means
3268
+ unlimited. Always returned; servers saved before traffic limits existed
3269
+ return an empty array. Omitting the field on PUT clears every limit —
3270
+ send the complete array back, or edit it with PATCH. A quota counts
3271
+ calls accepted after it is saved; edits that keep the same `type` and
3272
+ `keyResolver` keep counting from the original add time, and removing
3273
+ the quota (then adding it again) starts a new count.
3260
3274
  x-celigo-ai-guidance:
3261
3275
  - |-
3262
3276
  Leave `policies` empty unless the user asks for a limit — that is today's
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@celigo/api-specs",
3
- "version": "0.2.47",
3
+ "version": "0.2.49",
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,8 +1,8 @@
1
1
  {
2
2
  "provenance": {
3
3
  "repo": "celigo/integrator-api-specs",
4
- "iasCommit": "f237220",
5
- "generatedAt": "2026-09-23"
4
+ "iasCommit": "f1b9b36",
5
+ "generatedAt": "2026-09-24"
6
6
  },
7
7
  "roots": {
8
8
  "aiagent": 133,