cloudpdf-sdk-release · Nov 11, 2026 · Nov 11, 2026
diff --git a/.fern/metadata.json b/.fern/metadata.json
@@ -11,10 +11,10 @@
       "homepage": "https://www.cloudpdf.com"
     }
   },
-  "originGitCommit": "37273d7d149f893255344f0f8e9ff7b2dfbc8057",
+  "originGitCommit": "e074ee8465006a168ff6d8cfa73928df13ae159c",
   "originGitCommitIsDirty": false,
   "invokedBy": "ci",
-  "requestedVersion": "3.1.0",
+  "requestedVersion": "3.2.0",
   "ciProvider": "github",
-  "sdkVersion": "3.1.0"
+  "sdkVersion": "3.2.0"
 }
diff --git a/README.md b/README.md
@@ -42,7 +42,7 @@ use CloudPDF\Doc\Requests\DocChangesRequest;
 use CloudPDF\Doc\Types\DocChangesRequestChangesItem;
 
 $client = new CloudPDFClient(
-    embedPdfVersion: '3.1',
+    embedPdfVersion: '3.2',
     token: '<token>',
 );
 $client->doc->changes(

diff --git a/cloudpdf-generation.json b/cloudpdf-generation.json
@@ -1,12 +1,12 @@
 {
   "language": "php",
-  "canonicalVersion": "3.1.0",
-  "sdkVersion": "3.1.0",
+  "canonicalVersion": "3.2.0",
+  "sdkVersion": "3.2.0",
   "source": {
     "repository": "embedpdf/embed-pdf-viewer",
     "openapi": "cloudpdf/contract/openapi.json",
-    "openapiSha256": "5e62a5502b502635c63f989110a74f98a9f7f3f3a3696d6f1fccb4ea39e1efe3",
-    "gitCommit": "37273d7d149f893255344f0f8e9ff7b2dfbc8057",
+    "openapiSha256": "92b335b44d0957c70139f64ee3dd92e19d9d3a1452c90077002ed31dbddc3e7d",
+    "gitCommit": "e074ee8465006a168ff6d8cfa73928df13ae159c",
     "gitCommitIsDirty": false
   },
   "fern": {

diff --git a/src/CloudPDFClient.php b/src/CloudPDFClient.php
@@ -82,11 +82,11 @@ public function __construct(
         ?array $options = null,
     ) {
         $defaultHeaders = [
-            'EmbedPDF-Version' => '3.1',
+            'EmbedPDF-Version' => '3.2',
             'X-Fern-Language' => 'PHP',
             'X-Fern-SDK-Name' => 'CloudPDF',
-            'X-Fern-SDK-Version' => '3.1.0',
-            'User-Agent' => 'cloudpdf/sdk/3.1.0',
+            'X-Fern-SDK-Version' => '3.2.0',
+            'User-Agent' => 'cloudpdf/sdk/3.2.0',
         ];
         if ($token != null) {
             $defaultHeaders['Authorization'] = "Bearer $token";

diff --git a/src/Types/ChangeItem.php b/src/Types/ChangeItem.php
@@ -14,12 +14,14 @@ class ChangeItem extends JsonSerializableType
      *   |'annotations.update'
      *   |'annotations.delete'
      *   |'annotations.reorder'
+     *   |'annotations.copy'
      *   |'annotations.restore'
      *   |'forms.setValue'
      *   |'forms.setDisplay'
      *   |'forms.setAppearanceText'
      *   |'forms.reset'
      *   |'forms.create'
+     *   |'forms.copy'
      *   |'forms.update'
      *   |'forms.delete'
      *   |'forms.restore'
@@ -61,12 +63,14 @@ class ChangeItem extends JsonSerializableType
      *   |ChangeItemAnnotationsUpdate
      *   |ChangeItemAnnotationsDelete
      *   |ChangeItemAnnotationsReorder
+     *   |ChangeItemAnnotationsCopy
      *   |ChangeItemAnnotationsRestore
      *   |ChangeItemFormsSetValue
      *   |ChangeItemFormsSetDisplay
      *   |ChangeItemFormsSetAppearanceText
      *   |ChangeItemFormsReset
      *   |ChangeItemFormsCreate
+     *   |ChangeItemFormsCopy
      *   |ChangeItemFormsUpdate
      *   |ChangeItemFormsDelete
      *   |ChangeItemFormsRestore
@@ -109,12 +113,14 @@ class ChangeItem extends JsonSerializableType
      *   |'annotations.update'
      *   |'annotations.delete'
      *   |'annotations.reorder'
+     *   |'annotations.copy'
      *   |'annotations.restore'
      *   |'forms.setValue'
      *   |'forms.setDisplay'
      *   |'forms.setAppearanceText'
      *   |'forms.reset'
      *   |'forms.create'
+     *   |'forms.copy'
      *   |'forms.update'
      *   |'forms.delete'
      *   |'forms.restore'
@@ -152,12 +158,14 @@ class ChangeItem extends JsonSerializableType
      *   |ChangeItemAnnotationsUpdate
      *   |ChangeItemAnnotationsDelete
      *   |ChangeItemAnnotationsReorder
+     *   |ChangeItemAnnotationsCopy
      *   |ChangeItemAnnotationsRestore
      *   |ChangeItemFormsSetValue
      *   |ChangeItemFormsSetDisplay
      *   |ChangeItemFormsSetAppearanceText
      *   |ChangeItemFormsReset
      *   |ChangeItemFormsCreate
+     *   |ChangeItemFormsCopy
      *   |ChangeItemFormsUpdate
      *   |ChangeItemFormsDelete
      *   |ChangeItemFormsRestore
@@ -258,6 +266,18 @@ public static function annotationsReorder(ChangeItemAnnotationsReorder $annotati
         ]);
     }
 
+    /**
+     * @param ChangeItemAnnotationsCopy $annotationsCopy
+     * @return ChangeItem
+     */
+    public static function annotationsCopy(ChangeItemAnnotationsCopy $annotationsCopy): ChangeItem
+    {
+        return new ChangeItem([
+            'type' => 'annotations.copy',
+            'value' => $annotationsCopy,
+        ]);
+    }
+
     /**
      * @param ChangeItemAnnotationsRestore $annotationsRestore
      * @return ChangeItem
@@ -330,6 +350,18 @@ public static function formsCreate(ChangeItemFormsCreate $formsCreate): ChangeIt
         ]);
     }
 
+    /**
+     * @param ChangeItemFormsCopy $formsCopy
+     * @return ChangeItem
+     */
+    public static function formsCopy(ChangeItemFormsCopy $formsCopy): ChangeItem
+    {
+        return new ChangeItem([
+            'type' => 'forms.copy',
+            'value' => $formsCopy,
+        ]);
+    }
+
     /**
      * @param ChangeItemFormsUpdate $formsUpdate
      * @return ChangeItem
@@ -788,6 +820,28 @@ public function asAnnotationsReorder(): ChangeItemAnnotationsReorder
         return $this->value;
     }
 
+    /**
+     * @return bool
+     */
+    public function isAnnotationsCopy(): bool
+    {
+        return $this->value instanceof ChangeItemAnnotationsCopy && $this->type === 'annotations.copy';
+    }
+
+    /**
+     * @return ChangeItemAnnotationsCopy
+     */
+    public function asAnnotationsCopy(): ChangeItemAnnotationsCopy
+    {
+        if (!($this->value instanceof ChangeItemAnnotationsCopy && $this->type === 'annotations.copy')) {
+            throw new Exception(
+                "Expected annotations.copy; got " . $this->type . " with value of type " . get_debug_type($this->value),
+            );
+        }
+
+        return $this->value;
+    }
+
     /**
      * @return bool
      */
@@ -920,6 +974,28 @@ public function asFormsCreate(): ChangeItemFormsCreate
         return $this->value;
     }
 
+    /**
+     * @return bool
+     */
+    public function isFormsCopy(): bool
+    {
+        return $this->value instanceof ChangeItemFormsCopy && $this->type === 'forms.copy';
+    }
+
+    /**
+     * @return ChangeItemFormsCopy
+     */
+    public function asFormsCopy(): ChangeItemFormsCopy
+    {
+        if (!($this->value instanceof ChangeItemFormsCopy && $this->type === 'forms.copy')) {
+            throw new Exception(
+                "Expected forms.copy; got " . $this->type . " with value of type " . get_debug_type($this->value),
+            );
+        }
+
+        return $this->value;
+    }
+
     /**
      * @return bool
      */
@@ -1598,6 +1674,10 @@ public function jsonSerialize(): array
                 $value = $this->asAnnotationsReorder()->jsonSerialize();
                 $result = array_merge($value, $result);
                 break;
+            case 'annotations.copy':
+                $value = $this->asAnnotationsCopy()->jsonSerialize();
+                $result = array_merge($value, $result);
+                break;
             case 'annotations.restore':
                 $value = $this->asAnnotationsRestore()->jsonSerialize();
                 $result = array_merge($value, $result);
@@ -1622,6 +1702,10 @@ public function jsonSerialize(): array
                 $value = $this->asFormsCreate()->jsonSerialize();
                 $result = array_merge($value, $result);
                 break;
+            case 'forms.copy':
+                $value = $this->asFormsCopy()->jsonSerialize();
+                $result = array_merge($value, $result);
+                break;
             case 'forms.update':
                 $value = $this->asFormsUpdate()->jsonSerialize();
                 $result = array_merge($value, $result);
@@ -1789,6 +1873,9 @@ public static function jsonDeserialize(array $data): static
             case 'annotations.reorder':
                 $args['value'] = ChangeItemAnnotationsReorder::jsonDeserialize($data);
                 break;
+            case 'annotations.copy':
+                $args['value'] = ChangeItemAnnotationsCopy::jsonDeserialize($data);
+                break;
             case 'annotations.restore':
                 $args['value'] = ChangeItemAnnotationsRestore::jsonDeserialize($data);
                 break;
@@ -1807,6 +1894,9 @@ public static function jsonDeserialize(array $data): static
             case 'forms.create':
                 $args['value'] = ChangeItemFormsCreate::jsonDeserialize($data);
                 break;
+            case 'forms.copy':
+                $args['value'] = ChangeItemFormsCopy::jsonDeserialize($data);
+                break;
             case 'forms.update':
                 $args['value'] = ChangeItemFormsUpdate::jsonDeserialize($data);
                 break;

diff --git a/src/Types/ChangeItemAnnotationsCopy.php b/src/Types/ChangeItemAnnotationsCopy.php
@@ -0,0 +1,59 @@
+<?php
+
+namespace CloudPDF\Types;
+
+use CloudPDF\Core\Json\JsonSerializableType;
+use CloudPDF\Core\Json\JsonProperty;
+use CloudPDF\Core\Types\ArrayType;
+
+class ChangeItemAnnotationsCopy extends JsonSerializableType
+{
+    /**
+     * @var array<Annotation> $annotations
+     */
+    #[JsonProperty('annotations'), ArrayType([Annotation::class])]
+    public array $annotations;
+
+    /**
+     * @var array<ChangeItemAnnotationsCopyRefMapItem> $refMap
+     */
+    #[JsonProperty('refMap'), ArrayType([ChangeItemAnnotationsCopyRefMapItem::class])]
+    public array $refMap;
+
+    /**
+     * @var array<ChangeItemAnnotationsCopyDroppedItem> $dropped
+     */
+    #[JsonProperty('dropped'), ArrayType([ChangeItemAnnotationsCopyDroppedItem::class])]
+    public array $dropped;
+
+    /**
+     * @var AnnotationMutationMeta $meta
+     */
+    #[JsonProperty('meta')]
+    public AnnotationMutationMeta $meta;
+
+    /**
+     * @param array{
+     *   annotations: array<Annotation>,
+     *   refMap: array<ChangeItemAnnotationsCopyRefMapItem>,
+     *   dropped: array<ChangeItemAnnotationsCopyDroppedItem>,
+     *   meta: AnnotationMutationMeta,
+     * } $values
+     */
+    public function __construct(
+        array $values,
+    ) {
+        $this->annotations = $values['annotations'];
+        $this->refMap = $values['refMap'];
+        $this->dropped = $values['dropped'];
+        $this->meta = $values['meta'];
+    }
+
+    /**
+     * @return string
+     */
+    public function __toString(): string
+    {
+        return $this->toJson();
+    }
+}
diff --git a/src/Types/ChangeItemAnnotationsCopyDroppedItem.php b/src/Types/ChangeItemAnnotationsCopyDroppedItem.php
@@ -0,0 +1,50 @@
+<?php
+
+namespace CloudPDF\Types;
+
+use CloudPDF\Core\Json\JsonSerializableType;
+use CloudPDF\Core\Json\JsonProperty;
+
+class ChangeItemAnnotationsCopyDroppedItem extends JsonSerializableType
+{
+    /**
+     * @var AnnotationRef $ref
+     */
+    #[JsonProperty('ref')]
+    public AnnotationRef $ref;
+
+    /**
+     * @var ?string $field
+     */
+    #[JsonProperty('field')]
+    public ?string $field;
+
+    /**
+     * @var value-of<ChangeItemAnnotationsCopyDroppedItemReason> $reason
+     */
+    #[JsonProperty('reason')]
+    public string $reason;
+
+    /**
+     * @param array{
+     *   ref: AnnotationRef,
+     *   reason: value-of<ChangeItemAnnotationsCopyDroppedItemReason>,
+     *   field?: ?string,
+     * } $values
+     */
+    public function __construct(
+        array $values,
+    ) {
+        $this->ref = $values['ref'];
+        $this->field = $values['field'] ?? null;
+        $this->reason = $values['reason'];
+    }
+
+    /**
+     * @return string
+     */
+    public function __toString(): string
+    {
+        return $this->toJson();
+    }
+}
diff --git a/src/Types/ChangeItemAnnotationsCopyDroppedItemReason.php b/src/Types/ChangeItemAnnotationsCopyDroppedItemReason.php
@@ -0,0 +1,17 @@
+<?php
+
+namespace CloudPDF\Types;
+
+enum ChangeItemAnnotationsCopyDroppedItemReason: string
+{
+    case UnsupportedKind = "unsupported-kind";
+    case Widget = "widget";
+    case Geospatial = "geospatial";
+    case UnknownMeasure = "unknown-measure";
+    case UnsupportedAction = "unsupported-action";
+    case UnsupportedValue = "unsupported-value";
+    case NameConflict = "name-conflict";
+    case ParentDropped = "parent-dropped";
+    case ParentMissing = "parent-missing";
+    case PopupTaken = "popup-taken";
+}