@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.
- package/dist/filestorage.yml +24 -7
- package/dist/storagequery.yml +8 -3
- package/package.json +1 -1
- package/schemas.json +1 -1
package/dist/filestorage.yml
CHANGED
|
@@ -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
|
|
393
|
-
`
|
|
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
|
|
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,
|
|
2820
|
-
delete, and purge are rejected with
|
|
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
|
package/dist/storagequery.yml
CHANGED
|
@@ -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
|
|
56
|
-
|
|
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`)
|
|
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