@cloudpdf/sdk 3.0.0-next.5 → 3.0.0-next.7

package/dist/esm/api/resources/documents/client/Client.d.mts

@@ -113,6 +113,29 @@ export declare class DocumentsClient {
      */
     uploadProxy(request: CloudPDF.UploadProxyDocumentsRequest, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<CloudPDF.DocumentsUploadProxy200Response>;
     private __uploadProxy;
+    /**
+     * 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).
+     *
+     * @param {CloudPDF.DocumentsImportFromRequest} request
+     * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CloudPDF.BadRequestError}
+     * @throws {@link CloudPDF.ForbiddenError}
+     * @throws {@link CloudPDF.BadGatewayError}
+     * @throws {@link errors.CloudPDFError}
+     * @throws {@link errors.CloudPDFTimeoutError}
+     *
+     * @example
+     *     await client.documents.importFrom({
+     *         tenantId: "tenantId",
+     *         source: {
+     *             kind: "url",
+     *             url: "url"
+     *         }
+     *     })
+     */
+    importFrom(request: CloudPDF.DocumentsImportFromRequest, requestOptions?: DocumentsClient.RequestOptions): core.HttpResponsePromise<CloudPDF.DocumentsImportFrom200Response>;
+    private __importFrom;
     /**
      * @param {CloudPDF.DocumentsInitRequest} request
      * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/documents/client/Client.mjs

@@ -417,6 +417,75 @@ export class DocumentsClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/tenants/{tenantId}/documents/{id}/upload-proxy");
         });
     }
+    /**
+     * 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).
+     *
+     * @param {CloudPDF.DocumentsImportFromRequest} request
+     * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CloudPDF.BadRequestError}
+     * @throws {@link CloudPDF.ForbiddenError}
+     * @throws {@link CloudPDF.BadGatewayError}
+     * @throws {@link errors.CloudPDFError}
+     * @throws {@link errors.CloudPDFTimeoutError}
+     *
+     * @example
+     *     await client.documents.importFrom({
+     *         tenantId: "tenantId",
+     *         source: {
+     *             kind: "url",
+     *             url: "url"
+     *         }
+     *     })
+     */
+    importFrom(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__importFrom(request, requestOptions));
+    }
+    __importFrom(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { tenantId } = request, _body = __rest(request, ["tenantId"]);
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `v1/tenants/${core.url.encodePathParam(tenantId)}/documents/import`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: mergeAdditionalBodyParameters(_body, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.additionalBodyParameters),
+                timeoutMs: ((_e = (_c = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _c !== void 0 ? _c : (_d = this._options) === null || _d === void 0 ? void 0 : _d.timeoutInSeconds) !== null && _e !== void 0 ? _e : 60) * 1000,
+                maxRetries: (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_h = this._options) === null || _h === void 0 ? void 0 : _h.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new CloudPDF.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new CloudPDF.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new CloudPDF.BadGatewayError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.CloudPDFError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/tenants/{tenantId}/documents/import");
+        });
+    }
     /**
      * @param {CloudPDF.DocumentsInitRequest} request
      * @param {DocumentsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/documents/client/requests/DocumentsImportFromRequest.d.mts

@@ -0,0 +1,49 @@
+import type * as CloudPDF from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         tenantId: "tenantId",
+ *         source: {
+ *             kind: "url",
+ *             url: "url"
+ *         }
+ *     }
+ */
+export interface DocumentsImportFromRequest {
+    tenantId: string;
+    /** 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. */
+    source: CloudPDF.DocumentsImportFromRequestSource;
+    /** Integrity pins, enforced when present. When absent, the server-observed values become authoritative. */
+    expected?: DocumentsImportFromRequest.Expected;
+    metadata?: Record<string, unknown>;
+    /** Retrying with the same key resumes the same document rather than importing a second copy — including after a 502. */
+    idempotencyKey?: string;
+    /** 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. */
+    dedupMode?: DocumentsImportFromRequest.DedupMode;
+    docId?: string;
+    /** 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. */
+    mode?: DocumentsImportFromRequest.Mode;
+}
+export declare namespace DocumentsImportFromRequest {
+    /**
+     * Integrity pins, enforced when present. When absent, the server-observed values become authoritative.
+     */
+    interface Expected {
+        /** Checked against the source's declared Content-Length before the transfer. */
+        sizeBytes?: number | undefined;
+        /** Checked against the server-observed digest after the transfer. Required when dedupMode is reuse-existing. */
+        sha256?: string | undefined;
+    }
+    /** 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. */
+    const DedupMode: {
+        readonly AlwaysCreate: "always-create";
+        readonly ReuseExisting: "reuse-existing";
+    };
+    type DedupMode = (typeof DedupMode)[keyof typeof DedupMode];
+    /** 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. */
+    const Mode: {
+        readonly Sync: "sync";
+        readonly Async: "async";
+    };
+    type Mode = (typeof Mode)[keyof typeof Mode];
+}

package/dist/esm/api/resources/documents/client/requests/DocumentsImportFromRequest.mjs

@@ -0,0 +1,14 @@
+// This file was auto-generated by Fern from our API Definition.
+export var DocumentsImportFromRequest;
+(function (DocumentsImportFromRequest) {
+    /** 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. */
+    DocumentsImportFromRequest.DedupMode = {
+        AlwaysCreate: "always-create",
+        ReuseExisting: "reuse-existing",
+    };
+    /** 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. */
+    DocumentsImportFromRequest.Mode = {
+        Sync: "sync",
+        Async: "async",
+    };
+})(DocumentsImportFromRequest || (DocumentsImportFromRequest = {}));

package/dist/esm/api/resources/documents/client/requests/DocumentsInitRequest.d.mts

@@ -12,12 +12,14 @@ export interface DocumentsInitRequest {
     contentSha256: string;
     metadata?: Record<string, unknown>;
     idempotencyKey?: string;
+    /** 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. */
     dedupMode?: DocumentsInitRequest.DedupMode;
     docId?: string;
     uploadTtlSec?: number;
     uploadPreference?: DocumentsInitRequest.UploadPreference;
 }
 export declare namespace DocumentsInitRequest {
+    /** 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. */
     const DedupMode: {
         readonly AlwaysCreate: "always-create";
         readonly ReuseExisting: "reuse-existing";

package/dist/esm/api/resources/documents/client/requests/DocumentsInitRequest.mjs

@@ -1,6 +1,7 @@
 // This file was auto-generated by Fern from our API Definition.
 export var DocumentsInitRequest;
 (function (DocumentsInitRequest) {
+    /** 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. */
     DocumentsInitRequest.DedupMode = {
         AlwaysCreate: "always-create",
         ReuseExisting: "reuse-existing",

package/dist/esm/api/resources/documents/client/requests/index.d.mts

@@ -1,5 +1,6 @@
 export type { DeleteDocumentsRequest } from "./DeleteDocumentsRequest.mjs";
 export type { DocumentsCommitRequest } from "./DocumentsCommitRequest.mjs";
+export { DocumentsImportFromRequest } from "./DocumentsImportFromRequest.mjs";
 export { DocumentsInitRequest } from "./DocumentsInitRequest.mjs";
 export type { DownloadDocumentsRequest } from "./DownloadDocumentsRequest.mjs";
 export type { GetDocumentsRequest } from "./GetDocumentsRequest.mjs";

package/dist/esm/api/resources/documents/client/requests/index.mjs

@@ -1 +1,2 @@
+export { DocumentsImportFromRequest } from "./DocumentsImportFromRequest.mjs";
 export { DocumentsInitRequest } from "./DocumentsInitRequest.mjs";

package/dist/esm/api/resources/documents/types/DocumentsImportFromRequestSource.d.mts

@@ -0,0 +1,27 @@
+import type * as CloudPDF from "../../../index.mjs";
+/**
+ * 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.
+ */
+export type DocumentsImportFromRequestSource = 
+/**
+ * The caller supplies the authority: a presigned S3/GCS/Azure/R2/MinIO GET, or any HTTPS endpoint the deployment import policy allows. The URL is a capability — treat it as a secret. CloudPDF never echoes its query string back in errors, logs, or stored failure reasons. */
+CloudPDF.DocumentsImportFromRequestSource.Url
+/**
+ * The operator pre-registered the authority: the request names a connection and a key inside it. Which provider backs the connection (S3, GCS, Azure Blob, filesystem, ...) is deployment configuration, never wire surface. */
+ | CloudPDF.DocumentsImportFromRequestSource.Connection;
+export declare namespace DocumentsImportFromRequestSource {
+    interface Url {
+        kind: "url";
+        /** The URL to fetch. Must be allowed by the deployment import policy (scheme, network range, size) and must declare a length. */
+        url: string;
+    }
+    interface Connection {
+        kind: "connection";
+        /** The operator-registered storage connection to read from. */
+        connectionId: string;
+        /** The object key to read, inside the connection's configured scope. At most 1024 UTF-8 bytes. */
+        key: string;
+        /** Pins a specific version of the object. Provider-interpreted (S3 VersionId, GCS generation, Azure version id); providers without versioning reject it. */
+        revision?: string | undefined;
+    }
+}

package/dist/esm/api/resources/documents/types/DocumentsImportFromRequestSource.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/documents/types/index.d.mts

@@ -1 +1,2 @@
+export * from "./DocumentsImportFromRequestSource.mjs";
 export * from "./ListDocumentsRequestState.mjs";

package/dist/esm/api/resources/documents/types/index.mjs

@@ -1 +1,2 @@
+export * from "./DocumentsImportFromRequestSource.mjs";
 export * from "./ListDocumentsRequestState.mjs";

package/dist/esm/api/types/DocumentsImportFrom200Response.d.mts

@@ -0,0 +1,43 @@
+export interface DocumentsImportFrom200Response {
+    tag: DocumentsImportFrom200Response.Tag;
+    document: DocumentsImportFrom200Response.Document;
+}
+export declare namespace DocumentsImportFrom200Response {
+    const Tag: {
+        readonly Imported: "imported";
+        readonly Deduped: "deduped";
+        readonly Accepted: "accepted";
+    };
+    type Tag = (typeof Tag)[keyof typeof Tag];
+    interface Document {
+        id: string;
+        tenantId: string;
+        state: Document.State;
+        baseSha: string | null;
+        storageSizeBytes: number | null;
+        metadata: Record<string, unknown> | null;
+        idempotencyKey: string | null;
+        failureReason: string | null;
+        thumbnailState?: Document.ThumbnailState | undefined;
+        thumbnailUrl?: (string | null) | undefined;
+        createdAt: number;
+        updatedAt: number;
+        createdBy: string | null;
+    }
+    namespace Document {
+        const State: {
+            readonly Pending: "pending";
+            readonly Ready: "ready";
+            readonly Failed: "failed";
+            readonly Deleting: "deleting";
+        };
+        type State = (typeof State)[keyof typeof State];
+        const ThumbnailState: {
+            readonly Pending: "pending";
+            readonly Ready: "ready";
+            readonly Locked: "locked";
+            readonly Failed: "failed";
+        };
+        type ThumbnailState = (typeof ThumbnailState)[keyof typeof ThumbnailState];
+    }
+}

package/dist/esm/api/types/DocumentsImportFrom200Response.mjs

@@ -0,0 +1,24 @@
+// This file was auto-generated by Fern from our API Definition.
+export var DocumentsImportFrom200Response;
+(function (DocumentsImportFrom200Response) {
+    DocumentsImportFrom200Response.Tag = {
+        Imported: "imported",
+        Deduped: "deduped",
+        Accepted: "accepted",
+    };
+    let Document;
+    (function (Document) {
+        Document.State = {
+            Pending: "pending",
+            Ready: "ready",
+            Failed: "failed",
+            Deleting: "deleting",
+        };
+        Document.ThumbnailState = {
+            Pending: "pending",
+            Ready: "ready",
+            Locked: "locked",
+            Failed: "failed",
+        };
+    })(Document = DocumentsImportFrom200Response.Document || (DocumentsImportFrom200Response.Document = {}));
+})(DocumentsImportFrom200Response || (DocumentsImportFrom200Response = {}));

package/dist/esm/api/types/DocumentsImportFrom202Response.d.mts

@@ -0,0 +1,43 @@
+export interface DocumentsImportFrom202Response {
+    tag: DocumentsImportFrom202Response.Tag;
+    document: DocumentsImportFrom202Response.Document;
+}
+export declare namespace DocumentsImportFrom202Response {
+    const Tag: {
+        readonly Imported: "imported";
+        readonly Deduped: "deduped";
+        readonly Accepted: "accepted";
+    };
+    type Tag = (typeof Tag)[keyof typeof Tag];
+    interface Document {
+        id: string;
+        tenantId: string;
+        state: Document.State;
+        baseSha: string | null;
+        storageSizeBytes: number | null;
+        metadata: Record<string, unknown> | null;
+        idempotencyKey: string | null;
+        failureReason: string | null;
+        thumbnailState?: Document.ThumbnailState | undefined;
+        thumbnailUrl?: (string | null) | undefined;
+        createdAt: number;
+        updatedAt: number;
+        createdBy: string | null;
+    }
+    namespace Document {
+        const State: {
+            readonly Pending: "pending";
+            readonly Ready: "ready";
+            readonly Failed: "failed";
+            readonly Deleting: "deleting";
+        };
+        type State = (typeof State)[keyof typeof State];
+        const ThumbnailState: {
+            readonly Pending: "pending";
+            readonly Ready: "ready";
+            readonly Locked: "locked";
+            readonly Failed: "failed";
+        };
+        type ThumbnailState = (typeof ThumbnailState)[keyof typeof ThumbnailState];
+    }
+}

package/dist/esm/api/types/DocumentsImportFrom202Response.mjs

@@ -0,0 +1,24 @@
+// This file was auto-generated by Fern from our API Definition.
+export var DocumentsImportFrom202Response;
+(function (DocumentsImportFrom202Response) {
+    DocumentsImportFrom202Response.Tag = {
+        Imported: "imported",
+        Deduped: "deduped",
+        Accepted: "accepted",
+    };
+    let Document;
+    (function (Document) {
+        Document.State = {
+            Pending: "pending",
+            Ready: "ready",
+            Failed: "failed",
+            Deleting: "deleting",
+        };
+        Document.ThumbnailState = {
+            Pending: "pending",
+            Ready: "ready",
+            Locked: "locked",
+            Failed: "failed",
+        };
+    })(Document = DocumentsImportFrom202Response.Document || (DocumentsImportFrom202Response.Document = {}));
+})(DocumentsImportFrom202Response || (DocumentsImportFrom202Response = {}));

package/dist/esm/api/types/DocumentsImportFrom400Response.d.mts

@@ -0,0 +1,9 @@
+export interface DocumentsImportFrom400Response {
+    error: DocumentsImportFrom400Response.Error_;
+}
+export declare namespace DocumentsImportFrom400Response {
+    interface Error_ {
+        code: string;
+        message: string;
+    }
+}

package/dist/esm/api/types/DocumentsImportFrom400Response.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/DocumentsImportFrom403Response.d.mts

@@ -0,0 +1,9 @@
+export interface DocumentsImportFrom403Response {
+    error: DocumentsImportFrom403Response.Error_;
+}
+export declare namespace DocumentsImportFrom403Response {
+    interface Error_ {
+        code: string;
+        message: string;
+    }
+}

package/dist/esm/api/types/DocumentsImportFrom403Response.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/DocumentsImportFrom502Response.d.mts

@@ -0,0 +1,9 @@
+export interface DocumentsImportFrom502Response {
+    error: DocumentsImportFrom502Response.Error_;
+}
+export declare namespace DocumentsImportFrom502Response {
+    interface Error_ {
+        code: string;
+        message: string;
+    }
+}

package/dist/esm/api/types/DocumentsImportFrom502Response.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/index.d.mts

@@ -145,6 +145,11 @@ export * from "./DocumentsDownload404Response.mjs";
 export * from "./DocumentsGet200Response.mjs";
 export * from "./DocumentsGet403Response.mjs";
 export * from "./DocumentsGet404Response.mjs";
+export * from "./DocumentsImportFrom200Response.mjs";
+export * from "./DocumentsImportFrom202Response.mjs";
+export * from "./DocumentsImportFrom400Response.mjs";
+export * from "./DocumentsImportFrom403Response.mjs";
+export * from "./DocumentsImportFrom502Response.mjs";
 export * from "./DocumentsInit200Response.mjs";
 export * from "./DocumentsInit200ResponseCreatedUpload.mjs";
 export * from "./DocumentsInit200ResponseResumedUpload.mjs";

package/dist/esm/api/types/index.mjs

@@ -145,6 +145,11 @@ export * from "./DocumentsDownload404Response.mjs";
 export * from "./DocumentsGet200Response.mjs";
 export * from "./DocumentsGet403Response.mjs";
 export * from "./DocumentsGet404Response.mjs";
+export * from "./DocumentsImportFrom200Response.mjs";
+export * from "./DocumentsImportFrom202Response.mjs";
+export * from "./DocumentsImportFrom400Response.mjs";
+export * from "./DocumentsImportFrom403Response.mjs";
+export * from "./DocumentsImportFrom502Response.mjs";
 export * from "./DocumentsInit200Response.mjs";
 export * from "./DocumentsInit200ResponseCreatedUpload.mjs";
 export * from "./DocumentsInit200ResponseResumedUpload.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.0.0-next.5";
+export declare const SDK_VERSION = "3.0.0-next.7";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "3.0.0-next.5";
+export const SDK_VERSION = "3.0.0-next.7";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudpdf/sdk",
-  "version": "3.0.0-next.5",
+  "version": "3.0.0-next.7",
   "private": false,
   "license": "Apache-2.0",
   "type": "commonjs",

package/reference.md

@@ -1431,6 +1431,75 @@ await client.documents.uploadProxy({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.documents.<a href="/src/api/resources/documents/client/Client.ts">importFrom</a>({ ...params }) -> CloudPDF.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>
+
+```typescript
+await client.documents.importFrom({
+    tenantId: "tenantId",
+    source: {
+        kind: "url",
+        url: "url"
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CloudPDF.DocumentsImportFromRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DocumentsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>