@celigo/api-specs 0.2.142 → 0.2.143

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.
@@ -389,8 +389,10 @@ paths:
389
389
  account. Switches the endpoint to search mode, where `_parentId` is
390
390
  ignored and each item carries its `location`. Matches names only, not
391
391
  contents or descriptions; a query of several words matches names that
392
- contain any of them. Cannot be combined with `name`, `prefix`, or
393
- `_integrationId`.
392
+ contain any of them, and hyphens separate words too, so
393
+ `orders-2026-q3` also matches every name containing `orders`. To find
394
+ one item by its exact name, list its folder with `name`. Cannot be
395
+ combined with `name`, `prefix`, or `_integrationId`.
394
396
  schema:
395
397
  type: string
396
398
  minLength: 2
@@ -834,6 +836,10 @@ paths:
834
836
  unknown ids come back inline as
835
837
  `{_id, notFound: true, reason: "STORAGE_BATCH_ITEM_NOT_FOUND"}` entries
836
838
  alongside the found items.
839
+
840
+ Only files are looked up: a folder's id is treated as unknown, so it
841
+ fails the request or comes back as a `notFound` entry. Read folder
842
+ metadata from `GET /v1/storage/items`.
837
843
  operationId: batchGetStorageItems
838
844
  tags:
839
845
  - File Storage
@@ -1552,8 +1558,14 @@ paths:
1552
1558
  Merges the contents of a source folder into an existing destination
1553
1559
  folder, then removes the source. Runs asynchronously: the request is
1554
1560
  validated and queued, and the endpoint immediately returns `202` with a
1555
- job receipt — contents move in the background and the source folder
1556
- disappears once the merge completes. A soft-deleted source folder may be
1561
+ job receipt — contents move in the background, and the source folder
1562
+ disappears once the merge completes, without passing through the
1563
+ recycle bin. A file whose name is free in the destination moves with its
1564
+ `_id`. A file whose name the destination already holds overwrites that
1565
+ file: the destination file keeps its `_id` and takes the source file's
1566
+ content, its previous content is discarded, and the source file's `_id`
1567
+ is removed — neither goes to the recycle bin, so references to the
1568
+ source file break. A soft-deleted source folder may be
1557
1569
  merged, which restores its contents into the destination. Folders only —
1558
1570
  move individual files with the move endpoint. Requires delete access on
1559
1571
  the source folder and write access on the destination.
@@ -2746,7 +2758,10 @@ components:
2746
2758
  integration's root folder and inherited by everything created inside
2747
2759
  it; null for user-created folders and files at the account root and
2748
2760
  their descendants. Filter the list endpoint with `_integrationId` to
2749
- scope a listing to one integration.
2761
+ scope a listing to one integration. The root folder is created with
2762
+ the integration and follows it: deleting the integration sends the
2763
+ folder and everything in it to the recycle bin, and purging the
2764
+ integration purges them.
2750
2765
  examples:
2751
2766
  - 6ab1e7ab38d7733b4594d0d2
2752
2767
  integrationName:
@@ -2816,8 +2831,10 @@ components:
2816
2831
  readOnly: true
2817
2832
  description: |-
2818
2833
  When true, the platform created the item (for example a system or
2819
- integration folder) and protects it — move, content replace, copy,
2820
- delete, and purge are rejected with `STORAGE_SYSTEM_ITEM_PROTECTED`.
2834
+ integration folder) and protects it — rename, move, content replace,
2835
+ copy, delete, and purge are rejected with 403
2836
+ `STORAGE_SYSTEM_ITEM_PROTECTED` ("System items cannot be modified or
2837
+ deleted").
2821
2838
  deletedAt:
2822
2839
  type: string
2823
2840
  format: date-time
@@ -52,8 +52,10 @@ paths:
52
52
  references no file is accepted only when it is a pure constant expression. Supported
53
53
  file formats are CSV/TSV, JSON, NDJSON/JSONL, and Parquet; the reader is chosen from
54
54
  the file's extension (or its MIME type), and an explicit reader function must match
55
- it. A folder is referenced with a trailing slash and contributes its direct child
56
- files only; wildcard paths are not supported.
55
+ it. A compressed file such as `orders.csv.gz` is refused, even through a reader call
56
+ that passes `compression = 'gzip'`. A folder is referenced with a
57
+ trailing slash and contributes its direct child files only; wildcard paths are not
58
+ supported. A file whose upload has not finished yet is refused until it is active.
57
59
 
58
60
  Read options are named arguments of the reader call, checked against a per-reader
59
61
  allowlist — for `read_csv`/`read_csv_auto`: `header`, `delim`, `quote`, `escape`,
@@ -192,7 +194,10 @@ paths:
192
194
  catalog-qualified table name, or a path carrying a wildcard
193
195
  (`STORAGE_QUERY_INVALID_SOURCE`); a folder path without its trailing slash
194
196
  (`STORAGE_NOT_A_FILE`) or a file path with one (`STORAGE_ITEM_NOT_FOLDER`); an
195
- unsupported file type (`STORAGE_QUERY_UNSUPPORTED_FILE_TYPE`); a folder that is
197
+ unsupported file type (`STORAGE_QUERY_UNSUPPORTED_FILE_TYPE`) — a compressed
198
+ file is refused too, with "Querying `<name>` is not supported; supported formats
199
+ are CSV, JSON, NDJSON, and Parquet"; a file still uploading ("Upload for `<path>`
200
+ is not yet complete"); a folder that is
196
201
  empty, mixes formats, or holds too many files (`STORAGE_QUERY_FOLDER_EMPTY`,
197
202
  `STORAGE_QUERY_MIXED_FORMAT_FOLDER`, `STORAGE_QUERY_FOLDER_TOO_MANY_FILES`); too
198
203
  many distinct files (`STORAGE_QUERY_TOO_MANY_SOURCES`); or more input bytes than
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@celigo/api-specs",
3
- "version": "0.2.142",
3
+ "version": "0.2.143",
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": "54ef33c9",
4
+ "iasCommit": "eeb7fc20",
5
5
  "generatedAt": "2026-10-21"
6
6
  },
7
7
  "roots": {