cloudpdf 3.0.0.alpha.17 → 3.0.0.alpha.18

data/reference.md

@@ -855,6 +855,14 @@ client.shares.create(
 <dl>
 <dd>
 
+**identity:** `CloudPDF::Types::Identity` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **scope:** `Internal::Types::Array[String]` 
     
 </dd>
@@ -1112,6 +1120,14 @@ client.shares.update(
 <dl>
 <dd>
 
+**identity:** `CloudPDF::Types::Identity` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **scope:** `Internal::Types::Array[String]` 
     
 </dd>
@@ -1709,7 +1725,39 @@ client.documents.list(tenant_id: "tenantId")
 <dl>
 <dd>
 
-**state:** `CloudPDF::Documents::Types::ListDocumentsRequestState` 
+**state:** `CloudPDF::Documents::Types::ListDocumentsRequestState` — Only documents in this state. Without it, every state except deleting.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**q:** `String` — Only documents whose name contains this text, ignoring case.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**folder_id:** `String` — Only documents directly in this folder (root: the top level). Without it, documents in every folder.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**sort:** `CloudPDF::Documents::Types::ListDocumentsRequestSort` — createdAt (default), name (ignoring case), or size (stored bytes; 0 while pending).
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**order:** `CloudPDF::Documents::Types::ListDocumentsRequestOrder` — Defaults to the reading order of the sort: A to Z for name, newest and largest first otherwise.
     
 </dd>
 </dl>
@@ -1786,40 +1834,650 @@ client.documents.get(
 
 </dd>
 </dl>
-</details>
+</details>
+
+<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">delete</a>(tenant_id:, id:) -> </code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.documents.delete(
+  tenant_id: "tenantId",
+  id: "id"
+)
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**tenant_id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `CloudPDF::Documents::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">update</a>(tenant_id:, id:, request) -> CloudPDF::Types::DocumentsUpdate200Response</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+A document that is being deleted answers 404.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.documents.update(
+  tenant_id: "tenantId",
+  id: "id",
+  name: "name"
+)
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**tenant_id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**name:** `String` — What people call the document: shown in dashboards, searched and sorted by. 1 to 255 characters, no control characters, no leading or trailing whitespace. Names need not be unique.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `CloudPDF::Documents::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">commit</a>(tenant_id:, id:, request) -> CloudPDF::Types::DocumentsCommit200Response</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.documents.commit(
+  tenant_id: "tenantId",
+  id: "id",
+  sha256: "sha256"
+)
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**tenant_id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**sha256:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `CloudPDF::Documents::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">download</a>(tenant_id:, id:) -> String</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.documents.download(
+  tenant_id: "tenantId",
+  id: "id"
+)
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**tenant_id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `CloudPDF::Documents::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">thumbnail</a>(tenant_id:, id:) -> String</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.documents.thumbnail(
+  tenant_id: "tenantId",
+  id: "id"
+)
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**tenant_id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `CloudPDF::Documents::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">upload_proxy</a>(tenant_id:, id:, request) -> CloudPDF::Types::DocumentsUploadProxy200Response</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+This bounded origin-mediated fallback must only be used after documents.init returns upload.kind=proxy. Auto mode prefers a presigned object-store PUT whenever available.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+File.open("document.pdf", "rb") do |file|
+  client.documents.upload_proxy(
+    tenant_id: "tenantId",
+    id: "id",
+    file: file
+  )
+end
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**tenant_id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `CloudPDF::Documents::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">import_from</a>(tenant_id:, request) -> CloudPDF::Types::DocumentsImportFrom200Response</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Default mode is synchronous and bounded: the response returns only after the transfer verified and committed (or failed). mode=async (connection sources only) answers 202 immediately and an in-process worker performs the transfer with leased, fenced retries; poll the document until ready/failed. The deployment import policy gates scheme, network range, and size; sources must declare a length. CloudPDF copies and owns the bytes — the source is never referenced in place. A 502 marks a retryable upstream failure: retry with the same idempotencyKey to resume the same document. URL sources are capabilities and never echoed back. Connection sources name operator-registered storage (bucket/prefix scope, allowed credential classes, and tenant bindings are deployment configuration); `revision` is provider-interpreted (S3 VersionId, GCS generation, Azure version id).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.documents.import_from(tenant_id: "tenantId")
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**tenant_id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**source:** `CloudPDF::Documents::Types::DocumentsImportFromRequestSource` — Where CloudPDF pulls the bytes from. The two shapes differ in who supplies the authority to read, not in which storage vendor holds the file.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**expected:** `CloudPDF::Documents::Types::DocumentsImportFromRequestExpected` — Integrity pins, enforced when present. When absent, the server-observed values become authoritative.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**name:** `String` — What people call the document: shown in dashboards, searched and sorted by. 1 to 255 characters, no control characters, no leading or trailing whitespace. Names need not be unique.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**folder_id:** `String` — A folder id, or root for the top level.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**metadata:** `Internal::Types::Hash[String, Object]` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**idempotency_key:** `String` — Retrying with the same key resumes the same document rather than importing a second copy — including after a 502.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**dedup_mode:** `CloudPDF::Documents::Types::DocumentsImportFromRequestDedupMode` — always-create (default) creates a new document every time. reuse-existing returns a document that already holds the same content instead of storing it twice.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**doc_id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**mode:** `CloudPDF::Documents::Types::DocumentsImportFromRequestMode` — sync (default) holds the response open for the whole transfer. async answers 202 with the document pending and transfers in the background; it requires a connection source, and filesystem connections additionally require expected.sha256.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `CloudPDF::Documents::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">init</a>(tenant_id:, request) -> CloudPDF::Types::DocumentsInit200Response</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.documents.init(
+  tenant_id: "tenantId",
+  content_length: 1.1,
+  content_sha256: "contentSha256"
+)
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**tenant_id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**content_length:** `Integer` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**content_sha256:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**name:** `String` — What people call the document: shown in dashboards, searched and sorted by. 1 to 255 characters, no control characters, no leading or trailing whitespace. Names need not be unique.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**folder_id:** `String` — A folder id, or root for the top level.
+    
+</dd>
+</dl>
 
-<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">delete</a>(tenant_id:, id:) -> </code></summary>
 <dl>
 <dd>
 
-#### 🔌 Usage
+**metadata:** `Internal::Types::Hash[String, Object]` 
+    
+</dd>
+</dl>
 
 <dl>
 <dd>
 
+**idempotency_key:** `String` 
+    
+</dd>
+</dl>
+
 <dl>
 <dd>
 
-```ruby
-client.documents.delete(
-  tenant_id: "tenantId",
-  id: "id"
-)
-```
-</dd>
-</dl>
+**dedup_mode:** `CloudPDF::Documents::Types::DocumentsInitRequestDedupMode` — always-create (default) creates a new document every time. reuse-existing returns a document that already holds the same content instead of storing it twice.
+    
 </dd>
 </dl>
 
-#### ⚙️ Parameters
-
 <dl>
 <dd>
 
+**doc_id:** `String` 
+    
+</dd>
+</dl>
+
 <dl>
 <dd>
 
-**tenant_id:** `String` 
+**upload_ttl_sec:** `Integer` 
     
 </dd>
 </dl>
@@ -1827,7 +2485,7 @@ client.documents.delete(
 <dl>
 <dd>
 
-**id:** `String` 
+**upload_preference:** `CloudPDF::Documents::Types::DocumentsInitRequestUploadPreference` 
     
 </dd>
 </dl>
@@ -1847,7 +2505,8 @@ client.documents.delete(
 </dl>
 </details>
 
-<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">commit</a>(tenant_id:, id:, request) -> CloudPDF::Types::DocumentsCommit200Response</code></summary>
+## Folders
+<details><summary><code>client.folders.<a href="/lib/CloudPDF/folders/client.rb">list</a>(tenant_id:) -> CloudPDF::Types::FoldersList200Response</code></summary>
 <dl>
 <dd>
 
@@ -1860,11 +2519,7 @@ client.documents.delete(
 <dd>
 
 ```ruby
-client.documents.commit(
-  tenant_id: "tenantId",
-  id: "id",
-  sha256: "sha256"
-)
+client.folders.list(tenant_id: "tenantId")
 ```
 </dd>
 </dl>
@@ -1887,7 +2542,7 @@ client.documents.commit(
 <dl>
 <dd>
 
-**id:** `String` 
+**limit:** `Integer` 
     
 </dd>
 </dl>
@@ -1895,7 +2550,7 @@ client.documents.commit(
 <dl>
 <dd>
 
-**sha256:** `String` 
+**cursor:** `String` 
     
 </dd>
 </dl>
@@ -1903,7 +2558,15 @@ client.documents.commit(
 <dl>
 <dd>
 
-**request_options:** `CloudPDF::Documents::RequestOptions` 
+**parent_id:** `String` — Only the folders directly in this folder (root: the top level). Without it, every folder.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `CloudPDF::Folders::RequestOptions` 
     
 </dd>
 </dl>
@@ -1915,10 +2578,24 @@ client.documents.commit(
 </dl>
 </details>
 
-<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">download</a>(tenant_id:, id:) -> String</code></summary>
+<details><summary><code>client.folders.<a href="/lib/CloudPDF/folders/client.rb">create</a>(tenant_id:, request) -> CloudPDF::Types::FoldersCreate200Response</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
 <dl>
 <dd>
 
+<dl>
+<dd>
+
+409 Conflict carries `details.reason`: `name-taken` (a sibling has the name, ignoring case; `details.name`) or `too-deep` (folders nest at most 100 levels; `details.maxDepth`). 404 when the parent folder does not exist.
+</dd>
+</dl>
+</dd>
+</dl>
+
 #### 🔌 Usage
 
 <dl>
@@ -1928,9 +2605,9 @@ client.documents.commit(
 <dd>
 
 ```ruby
-client.documents.download(
+client.folders.create(
   tenant_id: "tenantId",
-  id: "id"
+  name: "name"
 )
 ```
 </dd>
@@ -1954,7 +2631,7 @@ client.documents.download(
 <dl>
 <dd>
 
-**id:** `String` 
+**name:** `String` — What people call the folder: 1 to 255 characters, no control characters, no leading or trailing whitespace, and unique among the folder's siblings, ignoring case.
     
 </dd>
 </dl>
@@ -1962,7 +2639,15 @@ client.documents.download(
 <dl>
 <dd>
 
-**request_options:** `CloudPDF::Documents::RequestOptions` 
+**parent_id:** `String` — A folder id, or root for the top level.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `CloudPDF::Folders::RequestOptions` 
     
 </dd>
 </dl>
@@ -1974,7 +2659,7 @@ client.documents.download(
 </dl>
 </details>
 
-<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">thumbnail</a>(tenant_id:, id:) -> String</code></summary>
+<details><summary><code>client.folders.<a href="/lib/CloudPDF/folders/client.rb">get</a>(tenant_id:, folder_id:) -> CloudPDF::Types::FoldersGet200Response</code></summary>
 <dl>
 <dd>
 
@@ -1987,9 +2672,9 @@ client.documents.download(
 <dd>
 
 ```ruby
-client.documents.thumbnail(
+client.folders.get(
   tenant_id: "tenantId",
-  id: "id"
+  folder_id: "folderId"
 )
 ```
 </dd>
@@ -2013,7 +2698,7 @@ client.documents.thumbnail(
 <dl>
 <dd>
 
-**id:** `String` 
+**folder_id:** `String` 
     
 </dd>
 </dl>
@@ -2021,7 +2706,7 @@ client.documents.thumbnail(
 <dl>
 <dd>
 
-**request_options:** `CloudPDF::Documents::RequestOptions` 
+**request_options:** `CloudPDF::Folders::RequestOptions` 
     
 </dd>
 </dl>
@@ -2033,7 +2718,7 @@ client.documents.thumbnail(
 </dl>
 </details>
 
-<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">upload_proxy</a>(tenant_id:, id:, request) -> CloudPDF::Types::DocumentsUploadProxy200Response</code></summary>
+<details><summary><code>client.folders.<a href="/lib/CloudPDF/folders/client.rb">delete</a>(tenant_id:, folder_id:) -> </code></summary>
 <dl>
 <dd>
 
@@ -2045,7 +2730,7 @@ client.documents.thumbnail(
 <dl>
 <dd>
 
-This bounded origin-mediated fallback must only be used after documents.init returns upload.kind=proxy. Auto mode prefers a presigned object-store PUT whenever available.
+Without recursive, a folder with anything inside is refused: 409 Conflict with `details.reason` `not-empty` and what it holds, counted over every level below, in `details.folders` and `details.documents`. With recursive=true, the folder and every folder under it go at once, and every document in them stops opening, leaves every list and stops answering its share links at once; their stored files and links are removed in the background. Uploads into those folders that have not committed cannot commit.
 </dd>
 </dl>
 </dd>
@@ -2060,13 +2745,10 @@ This bounded origin-mediated fallback must only be used after documents.init ret
 <dd>
 
 ```ruby
-File.open("document.pdf", "rb") do |file|
-  client.documents.upload_proxy(
-    tenant_id: "tenantId",
-    id: "id",
-    file: file
-  )
-end
+client.folders.delete(
+  tenant_id: "tenantId",
+  folder_id: "folderId"
+)
 ```
 </dd>
 </dl>
@@ -2089,7 +2771,7 @@ end
 <dl>
 <dd>
 
-**id:** `String` 
+**folder_id:** `String` 
     
 </dd>
 </dl>
@@ -2097,7 +2779,15 @@ end
 <dl>
 <dd>
 
-**request_options:** `CloudPDF::Documents::RequestOptions` 
+**recursive:** `Internal::Types::Boolean` — true deletes everything in the folder too. Never the default.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `CloudPDF::Folders::RequestOptions` 
     
 </dd>
 </dl>
@@ -2109,7 +2799,7 @@ end
 </dl>
 </details>
 
-<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">import_from</a>(tenant_id:, request) -> CloudPDF::Types::DocumentsImportFrom200Response</code></summary>
+<details><summary><code>client.folders.<a href="/lib/CloudPDF/folders/client.rb">update</a>(tenant_id:, folder_id:, request) -> CloudPDF::Types::FoldersUpdate200Response</code></summary>
 <dl>
 <dd>
 
@@ -2121,7 +2811,7 @@ end
 <dl>
 <dd>
 
-Default mode is synchronous and bounded: the response returns only after the transfer verified and committed (or failed). mode=async (connection sources only) answers 202 immediately and an in-process worker performs the transfer with leased, fenced retries; poll the document until ready/failed. The deployment import policy gates scheme, network range, and size; sources must declare a length. CloudPDF copies and owns the bytes — the source is never referenced in place. A 502 marks a retryable upstream failure: retry with the same idempotencyKey to resume the same document. URL sources are capabilities and never echoed back. Connection sources name operator-registered storage (bucket/prefix scope, allowed credential classes, and tenant bindings are deployment configuration); `revision` is provider-interpreted (S3 VersionId, GCS generation, Azure version id).
+409 Conflict with `details.reason` `name-taken` when a sibling has the name, ignoring case.
 </dd>
 </dl>
 </dd>
@@ -2136,7 +2826,11 @@ Default mode is synchronous and bounded: the response returns only after the tra
 <dd>
 
 ```ruby
-client.documents.import_from(tenant_id: "tenantId")
+client.folders.update(
+  tenant_id: "tenantId",
+  folder_id: "folderId",
+  name: "name"
+)
 ```
 </dd>
 </dl>
@@ -2159,7 +2853,7 @@ client.documents.import_from(tenant_id: "tenantId")
 <dl>
 <dd>
 
-**source:** `CloudPDF::Documents::Types::DocumentsImportFromRequestSource` — Where CloudPDF pulls the bytes from. The two shapes differ in who supplies the authority to read, not in which storage vendor holds the file.
+**folder_id:** `String` 
     
 </dd>
 </dl>
@@ -2167,7 +2861,7 @@ client.documents.import_from(tenant_id: "tenantId")
 <dl>
 <dd>
 
-**expected:** `CloudPDF::Documents::Types::DocumentsImportFromRequestExpected` — Integrity pins, enforced when present. When absent, the server-observed values become authoritative.
+**name:** `String` — What people call the folder: 1 to 255 characters, no control characters, no leading or trailing whitespace, and unique among the folder's siblings, ignoring case.
     
 </dd>
 </dl>
@@ -2175,61 +2869,35 @@ client.documents.import_from(tenant_id: "tenantId")
 <dl>
 <dd>
 
-**metadata:** `Internal::Types::Hash[String, Object]` 
+**request_options:** `CloudPDF::Folders::RequestOptions` 
     
 </dd>
 </dl>
-
-<dl>
-<dd>
-
-**idempotency_key:** `String` — Retrying with the same key resumes the same document rather than importing a second copy — including after a 502.
-    
 </dd>
 </dl>
 
-<dl>
-<dd>
 
-**dedup_mode:** `CloudPDF::Documents::Types::DocumentsImportFromRequestDedupMode` — always-create (default) creates a new document every time. reuse-existing returns a document that already holds the same content instead of storing it twice.
-    
 </dd>
 </dl>
+</details>
 
+<details><summary><code>client.folders.<a href="/lib/CloudPDF/folders/client.rb">move_into</a>(tenant_id:, folder_id:, request) -> </code></summary>
 <dl>
 <dd>
 
-**doc_id:** `String` 
-    
-</dd>
-</dl>
+#### 📝 Description
 
 <dl>
 <dd>
 
-**mode:** `CloudPDF::Documents::Types::DocumentsImportFromRequestMode` — sync (default) holds the response open for the whole transfer. async answers 202 with the document pending and transfers in the background; it requires a connection source, and filesystem connections additionally require expected.sha256.
-    
-</dd>
-</dl>
-
 <dl>
 <dd>
 
-**request_options:** `CloudPDF::Documents::RequestOptions` 
-    
-</dd>
-</dl>
+Up to 1,000 ids in total. A folder moves with everything in it. 404 NotFound names the ids that do not exist or are being deleted in `details.documentIds` and `details.folderIds`. 409 Conflict carries `details.reason`: `cycle` (the destination is a moved folder or inside one; `details.folderId`), `too-deep` (the move would nest folders deeper than 100 levels; `details.maxDepth`) or `name-taken` (a moved folder's name is taken in the destination, ignoring case; `details.name`).
 </dd>
 </dl>
-
-
 </dd>
 </dl>
-</details>
-
-<details><summary><code>client.documents.<a href="/lib/CloudPDF/documents/client.rb">init</a>(tenant_id:, request) -> CloudPDF::Types::DocumentsInit200Response</code></summary>
-<dl>
-<dd>
 
 #### 🔌 Usage
 
@@ -2240,10 +2908,9 @@ client.documents.import_from(tenant_id: "tenantId")
 <dd>
 
 ```ruby
-client.documents.init(
+client.folders.move_into(
   tenant_id: "tenantId",
-  content_length: 1.1,
-  content_sha256: "contentSha256"
+  folder_id: "folderId"
 )
 ```
 </dd>
@@ -2267,47 +2934,7 @@ client.documents.init(
 <dl>
 <dd>
 
-**content_length:** `Integer` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**content_sha256:** `String` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**metadata:** `Internal::Types::Hash[String, Object]` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**idempotency_key:** `String` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**dedup_mode:** `CloudPDF::Documents::Types::DocumentsInitRequestDedupMode` — always-create (default) creates a new document every time. reuse-existing returns a document that already holds the same content instead of storing it twice.
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**doc_id:** `String` 
+**folder_id:** `String` — A folder id, or root for the top level.
     
 </dd>
 </dl>
@@ -2315,7 +2942,7 @@ client.documents.init(
 <dl>
 <dd>
 
-**upload_ttl_sec:** `Integer` 
+**document_ids:** `Internal::Types::Array[String]` 
     
 </dd>
 </dl>
@@ -2323,7 +2950,7 @@ client.documents.init(
 <dl>
 <dd>
 
-**upload_preference:** `CloudPDF::Documents::Types::DocumentsInitRequestUploadPreference` 
+**folder_ids:** `Internal::Types::Array[String]` 
     
 </dd>
 </dl>
@@ -2331,7 +2958,7 @@ client.documents.init(
 <dl>
 <dd>
 
-**request_options:** `CloudPDF::Documents::RequestOptions` 
+**request_options:** `CloudPDF::Folders::RequestOptions` 
     
 </dd>
 </dl>
@@ -5164,7 +5791,7 @@ client.doc.signatures.cancel(
 <dl>
 <dd>
 
-`cms` is the detached CMS over the prepared digest, base64. `expectedVersion` must be what prepare returned. Idempotent by signing id: the same CMS again answers `already-completed`. Every layer of the document then sits over the new version; refetch the manifest after a completion.
+`cms` is the detached CMS over the prepared digest, base64. `expectedVersion` must be what prepare returned. Idempotent by signing id: the same CMS again answers `already-completed`. The new version is the layer's own: only this layer moves to it, and the document and every other layer stay as they were. Refetch the manifest after a completion.
 </dd>
 </dl>
 </dd>
@@ -5380,7 +6007,7 @@ client.doc.signatures.analysis(
 <dl>
 <dd>
 
-Multipart: a JSON `body` part (field, subFilter, digest, contentsSize, signer, certify, lock), naming the appearance PDF it may carry as `resources: { appearance: '<key>' }`, and that PDF as the part `resource:<key>`. A certification (`certify.permission`) additionally requires `doc.sign.certify`. The layer is read-only until the signing completes, is cancelled, or expires (15 minutes). A layer behind the document head cannot sign (StaleBase).
+Multipart: a JSON `body` part (field, subFilter, digest, contentsSize, signer, certify, lock), naming the appearance PDF it may carry as `resources: { appearance: '<key>' }`, and that PDF as the part `resource:<key>`. A certification (`certify.permission`) additionally requires `doc.sign.certify`. The layer is read-only until the signing completes, is cancelled, or expires (15 minutes). The signature is made over the layer's own base: the upload, or the version its last signature made.
 </dd>
 </dl>
 </dd>
@@ -5450,7 +6077,7 @@ client.doc.signatures.prepare(
 </details>
 
 ## Doc Versions
-<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">list</a>(doc_id:) -> CloudPDF::Types::DocVersionsList200Response</code></summary>
+<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">list</a>(doc_id:, layer_name:) -> CloudPDF::Types::DocVersionsList200Response</code></summary>
 <dl>
 <dd>
 
@@ -5462,7 +6089,7 @@ client.doc.signatures.prepare(
 <dl>
 <dd>
 
-Every completed signature publishes a new version. Never cached: the list grows.
+Every completed signature makes a new version of its layer; another layer's versions are never listed. Never cached: the list grows.
 </dd>
 </dl>
 </dd>
@@ -5477,7 +6104,10 @@ Every completed signature publishes a new version. Never cached: the list grows.
 <dd>
 
 ```ruby
-client.doc.versions.list(doc_id: "docId")
+client.doc.versions.list(
+  doc_id: "docId",
+  layer_name: "layerName"
+)
 ```
 </dd>
 </dl>
@@ -5500,6 +6130,14 @@ client.doc.versions.list(doc_id: "docId")
 <dl>
 <dd>
 
+**layer_name:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **document_password:** `String` — Base64-encoded password for an encrypted document. Valid only with the API token (403 anywhere else). An encrypted document answers 422 DocPasswordRequired when the header is absent. Viewer doc JWTs use the SDK password-session flow instead.
     
 </dd>
@@ -5520,7 +6158,7 @@ client.doc.versions.list(doc_id: "docId")
 </dl>
 </details>
 
-<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">analysis</a>(doc_id:, sha:) -> CloudPDF::Types::DocVersionsAnalysis200Response</code></summary>
+<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">analysis</a>(doc_id:, layer_name:, sha:) -> CloudPDF::Types::DocVersionsAnalysis200Response</code></summary>
 <dl>
 <dd>
 
@@ -5532,7 +6170,7 @@ client.doc.versions.list(doc_id: "docId")
 <dl>
 <dd>
 
-Exactly one of `since.signature` / `since.revision`; `until=<revision>` defaults to the last. The same answer for every layer and every caller.
+Exactly one of `since.signature` / `since.revision`; `until=<revision>` defaults to the last. The same answer for every caller.
 </dd>
 </dl>
 </dd>
@@ -5549,6 +6187,7 @@ Exactly one of `since.signature` / `since.revision`; `until=<revision>` defaults
 ```ruby
 client.doc.versions.analysis(
   doc_id: "docId",
+  layer_name: "layerName",
   sha: "sha"
 )
 ```
@@ -5573,6 +6212,14 @@ client.doc.versions.analysis(
 <dl>
 <dd>
 
+**layer_name:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **sha:** `String` 
     
 </dd>
@@ -5641,7 +6288,7 @@ client.doc.versions.analysis(
 </dl>
 </details>
 
-<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">download</a>(doc_id:, sha:) -> String</code></summary>
+<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">download</a>(doc_id:, layer_name:, sha:) -> String</code></summary>
 <dl>
 <dd>
 
@@ -5656,6 +6303,7 @@ client.doc.versions.analysis(
 ```ruby
 client.doc.versions.download(
   doc_id: "docId",
+  layer_name: "layerName",
   sha: "sha"
 )
 ```
@@ -5680,6 +6328,14 @@ client.doc.versions.download(
 <dl>
 <dd>
 
+**layer_name:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **sha:** `String` 
     
 </dd>
@@ -5708,7 +6364,7 @@ client.doc.versions.download(
 </dl>
 </details>
 
-<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">revision</a>(doc_id:, sha:, index:) -> String</code></summary>
+<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">revision</a>(doc_id:, layer_name:, sha:, index:) -> String</code></summary>
 <dl>
 <dd>
 
@@ -5723,6 +6379,7 @@ client.doc.versions.download(
 ```ruby
 client.doc.versions.revision(
   doc_id: "docId",
+  layer_name: "layerName",
   sha: "sha",
   index: 1
 )
@@ -5748,6 +6405,14 @@ client.doc.versions.revision(
 <dl>
 <dd>
 
+**layer_name:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **sha:** `String` 
     
 </dd>
@@ -5784,7 +6449,7 @@ client.doc.versions.revision(
 </dl>
 </details>
 
-<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">signatures</a>(doc_id:, sha:) -> CloudPDF::Types::DocVersionsSignatures200Response</code></summary>
+<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">signatures</a>(doc_id:, layer_name:, sha:) -> CloudPDF::Types::DocVersionsSignatures200Response</code></summary>
 <dl>
 <dd>
 
@@ -5799,6 +6464,7 @@ client.doc.versions.revision(
 ```ruby
 client.doc.versions.signatures(
   doc_id: "docId",
+  layer_name: "layerName",
   sha: "sha"
 )
 ```
@@ -5823,6 +6489,14 @@ client.doc.versions.signatures(
 <dl>
 <dd>
 
+**layer_name:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **sha:** `String` 
     
 </dd>
@@ -5851,7 +6525,7 @@ client.doc.versions.signatures(
 </dl>
 </details>
 
-<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">signature_contents</a>(doc_id:, sha:, field_key:) -> String</code></summary>
+<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">signature_contents</a>(doc_id:, layer_name:, sha:, field_key:) -> String</code></summary>
 <dl>
 <dd>
 
@@ -5880,6 +6554,7 @@ client.doc.versions.signatures(
 ```ruby
 client.doc.versions.signature_contents(
   doc_id: "docId",
+  layer_name: "layerName",
   sha: "sha",
   field_key: "fieldKey"
 )
@@ -5905,6 +6580,14 @@ client.doc.versions.signature_contents(
 <dl>
 <dd>
 
+**layer_name:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **sha:** `String` 
     
 </dd>
@@ -5941,7 +6624,7 @@ client.doc.versions.signature_contents(
 </dl>
 </details>
 
-<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">signature_digest</a>(doc_id:, sha:, field_key:, algorithm:) -> String</code></summary>
+<details><summary><code>client.doc.versions.<a href="/lib/CloudPDF/doc/versions/client.rb">signature_digest</a>(doc_id:, layer_name:, sha:, field_key:, algorithm:) -> String</code></summary>
 <dl>
 <dd>
 
@@ -5970,6 +6653,7 @@ What a CMS verifier compares its message digest to.
 ```ruby
 client.doc.versions.signature_digest(
   doc_id: "docId",
+  layer_name: "layerName",
   sha: "sha",
   field_key: "fieldKey",
   algorithm: "sha1"
@@ -5996,6 +6680,14 @@ client.doc.versions.signature_digest(
 <dl>
 <dd>
 
+**layer_name:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **sha:** `String` 
     
 </dd>