@factify/sdk 0.3.6

package/openapi.json

@@ -0,0 +1,2087 @@
+{
+  "components": {
+    "responses": {
+      "BadRequest": {
+        "content": {
+          "application/json": {
+            "examples": {
+              "validation_error": {
+                "value": {
+                  "error": {
+                    "code": "missing_required_field",
+                    "message": "Document title cannot be empty",
+                    "param": "title",
+                    "retry_after": null,
+                    "type": "invalid_request_error"
+                  }
+                }
+              }
+            },
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            }
+          }
+        },
+        "description": "Invalid request parameters"
+      },
+      "Forbidden": {
+        "content": {
+          "application/json": {
+            "examples": {
+              "insufficient_permissions": {
+                "value": {
+                  "error": {
+                    "code": "insufficient_permissions",
+                    "message": "You do not have permission to access this resource",
+                    "param": null,
+                    "retry_after": null,
+                    "type": "authorization_error"
+                  }
+                }
+              }
+            },
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            }
+          }
+        },
+        "description": "Authorization failed - valid key but insufficient permissions"
+      },
+      "InternalServerError": {
+        "content": {
+          "application/json": {
+            "examples": {
+              "internal_error": {
+                "value": {
+                  "error": {
+                    "code": "internal_error",
+                    "message": "An unexpected error occurred. Please try again later.",
+                    "param": null,
+                    "retry_after": null,
+                    "type": "api_error"
+                  }
+                }
+              }
+            },
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            }
+          }
+        },
+        "description": "Internal server error"
+      },
+      "NotFound": {
+        "content": {
+          "application/json": {
+            "examples": {
+              "resource_not_found": {
+                "value": {
+                  "error": {
+                    "code": "resource_not_found",
+                    "message": "Document not found",
+                    "param": null,
+                    "retry_after": null,
+                    "type": "not_found_error"
+                  }
+                }
+              }
+            },
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            }
+          }
+        },
+        "description": "Resource not found"
+      },
+      "RateLimitExceeded": {
+        "content": {
+          "application/json": {
+            "examples": {
+              "rate_limit": {
+                "value": {
+                  "error": {
+                    "code": "rate_limit_exceeded",
+                    "message": "Too many requests. Retry after 30 seconds.",
+                    "param": null,
+                    "retry_after": 30,
+                    "type": "rate_limit_error"
+                  }
+                }
+              }
+            },
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            }
+          }
+        },
+        "description": "Too many requests",
+        "headers": {
+          "X-RateLimit-Limit": {
+            "description": "Request limit per minute",
+            "schema": {
+              "type": "integer"
+            }
+          },
+          "X-RateLimit-Remaining": {
+            "description": "Remaining requests in current window",
+            "schema": {
+              "type": "integer"
+            }
+          },
+          "X-RateLimit-Reset": {
+            "description": "Unix timestamp when rate limit resets",
+            "schema": {
+              "type": "integer"
+            }
+          }
+        }
+      },
+      "Unauthorized": {
+        "content": {
+          "application/json": {
+            "examples": {
+              "missing_key": {
+                "value": {
+                  "error": {
+                    "code": "missing_api_key",
+                    "message": "No API key provided",
+                    "param": null,
+                    "retry_after": null,
+                    "type": "authentication_error"
+                  }
+                }
+              }
+            },
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            }
+          }
+        },
+        "description": "Authentication failed - missing or invalid API key"
+      }
+    },
+    "schemas": {
+      "AccessLevel": {
+        "enum": [
+          "private",
+          "organization",
+          "public"
+        ]
+      },
+      "AttachPolicyRequest": {
+        "additionalProperties": false,
+        "description": "AttachPolicyRequest specifies a policy to attach to a document.",
+        "properties": {
+          "document_id": {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "document_id",
+            "type": "string"
+          },
+          "policy_id": {
+            "description": "Policy ID to attach.\n Pattern: pol_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "policy_id",
+            "type": "string"
+          }
+        },
+        "required": [
+          "policy_id"
+        ],
+        "title": "AttachPolicyRequest",
+        "type": "object"
+      },
+      "CreateDocumentRequest": {
+        "additionalProperties": false,
+        "description": "CreateDocumentRequest contains the file and metadata for creating a document.",
+        "properties": {
+          "access_level": {
+            "$ref": "#/components/schemas/AccessLevel",
+            "description": "Document access level. Defaults to organization if user belongs to an org, otherwise private.",
+            "nullable": true,
+            "title": "access_level"
+          },
+          "description": {
+            "description": "Optional document description.",
+            "maxLength": 2000,
+            "nullable": true,
+            "title": "description",
+            "type": "string"
+          },
+          "document_id": {
+            "description": "Pre-generated document ID (set by server)",
+            "readOnly": true,
+            "title": "document_id",
+            "type": "string"
+          },
+          "payload": {
+            "description": "PDF file to upload",
+            "format": "binary",
+            "title": "payload",
+            "type": "string"
+          },
+          "payload_key": {
+            "description": "Storage key for uploaded file (set by server)",
+            "readOnly": true,
+            "title": "payload_key",
+            "type": "string"
+          },
+          "title": {
+            "description": "Document title.",
+            "maxLength": 255,
+            "minLength": 1,
+            "title": "title",
+            "type": "string"
+          },
+          "version_id": {
+            "description": "Pre-generated version ID (set by server)",
+            "readOnly": true,
+            "title": "version_id",
+            "type": "string"
+          }
+        },
+        "required": [
+          "payload",
+          "title"
+        ],
+        "title": "CreateDocumentRequest",
+        "type": "object"
+      },
+      "CreateDocumentResponse": {
+        "additionalProperties": false,
+        "description": "CreateDocumentResponse contains the newly created document.",
+        "properties": {
+          "document": {
+            "$ref": "#/components/schemas/Document",
+            "description": "The created document.",
+            "title": "document"
+          }
+        },
+        "title": "CreateDocumentResponse",
+        "type": "object"
+      },
+      "CreateVersionRequest": {
+        "additionalProperties": false,
+        "description": "CreateVersionRequest contains the file and metadata for creating a version.",
+        "properties": {
+          "description": {
+            "description": "Description of changes in this version.",
+            "nullable": true,
+            "title": "description",
+            "type": "string"
+          },
+          "document_id": {
+            "description": "Document ID to create version for.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "document_id",
+            "type": "string"
+          },
+          "payload": {
+            "description": "PDF file for new version",
+            "format": "binary",
+            "title": "payload",
+            "type": "string"
+          },
+          "payload_key": {
+            "description": "Storage key for uploaded file (set by server)",
+            "readOnly": true,
+            "title": "payload_key",
+            "type": "string"
+          },
+          "title": {
+            "description": "Optional version title.",
+            "maxLength": 255,
+            "nullable": true,
+            "title": "title",
+            "type": "string"
+          },
+          "version_id": {
+            "description": "Pre-generated version ID (set by server)",
+            "readOnly": true,
+            "title": "version_id",
+            "type": "string"
+          }
+        },
+        "required": [
+          "payload"
+        ],
+        "title": "CreateVersionRequest",
+        "type": "object"
+      },
+      "DetachPolicyRequest": {
+        "additionalProperties": false,
+        "description": "DetachPolicyRequest identifies a policy to detach from a document.",
+        "properties": {
+          "document_id": {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "document_id",
+            "type": "string"
+          },
+          "policy_id": {
+            "description": "Policy ID to detach.\n Pattern: pol_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "policy_id",
+            "type": "string"
+          }
+        },
+        "title": "DetachPolicyRequest",
+        "type": "object"
+      },
+      "Document": {
+        "additionalProperties": false,
+        "description": "Document represents a Factify document.",
+        "properties": {
+          "access_level": {
+            "$ref": "#/components/schemas/AccessLevel",
+            "description": "Document access level.",
+            "title": "access_level"
+          },
+          "created_at": {
+            "description": "Timestamp when document was created.",
+            "format": "date-time",
+            "title": "created_at",
+            "type": "string"
+          },
+          "created_by": {
+            "$ref": "#/components/schemas/User",
+            "description": "User who created the document.",
+            "title": "created_by"
+          },
+          "current_version": {
+            "$ref": "#/components/schemas/VersionRef",
+            "description": "Reference to the current version, if any.",
+            "nullable": true,
+            "title": "current_version"
+          },
+          "description": {
+            "description": "Optional document description.",
+            "example": "Quarterly financial report for Q4 2024",
+            "maxLength": 2000,
+            "nullable": true,
+            "title": "description",
+            "type": "string"
+          },
+          "id": {
+            "description": "Unique ID for the document.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "example": "doc_01h2xcejqtf2nbrexx3vqjhp41",
+            "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "id",
+            "type": "string"
+          },
+          "processing_status": {
+            "$ref": "#/components/schemas/ProcessingStatus",
+            "description": "Processing status.",
+            "title": "processing_status"
+          },
+          "title": {
+            "description": "Document title.",
+            "example": "Q4 2024 Financial Report",
+            "maxLength": 255,
+            "minLength": 1,
+            "title": "title",
+            "type": "string"
+          },
+          "url": {
+            "description": "URL for accessing the document on Factify.",
+            "example": "https://d.factify.com/d/01h2xcejqtf2nbrexx3vqjhp41",
+            "format": "uri",
+            "title": "url",
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "url",
+          "title",
+          "access_level",
+          "processing_status",
+          "created_at",
+          "created_by"
+        ],
+        "title": "Document",
+        "type": "object"
+      },
+      "DocumentPolicy": {
+        "additionalProperties": false,
+        "description": "DocumentPolicy represents a policy attached to a document.",
+        "properties": {
+          "attached_at": {
+            "description": "Timestamp when policy was attached.",
+            "format": "date-time",
+            "title": "attached_at",
+            "type": "string"
+          },
+          "attached_by": {
+            "$ref": "#/components/schemas/User",
+            "description": "User who attached the policy.",
+            "title": "attached_by"
+          },
+          "document_id": {
+            "description": "Document ID this policy is attached to.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "example": "doc_01h2xcejqtf2nbrexx3vqjhp41",
+            "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "document_id",
+            "type": "string"
+          },
+          "policy": {
+            "$ref": "#/components/schemas/Policy",
+            "description": "The policy details.",
+            "title": "policy"
+          }
+        },
+        "required": [
+          "document_id",
+          "attached_at",
+          "attached_by",
+          "policy"
+        ],
+        "title": "DocumentPolicy",
+        "type": "object"
+      },
+      "Empty": {
+        "description": "A generic empty message that you can re-use to avoid defining duplicated\n empty messages in your APIs. A typical example is to use it as the request\n or the response type of an API method. For instance:\n\n     service Foo {\n       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n     }",
+        "type": "object"
+      },
+      "Error": {
+        "properties": {
+          "error": {
+            "properties": {
+              "code": {
+                "description": "Specific error code for detailed handling",
+                "type": "string"
+              },
+              "message": {
+                "description": "Human-readable error message",
+                "type": "string"
+              },
+              "param": {
+                "description": "Parameter that caused the error (for validation errors)",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "retry_after": {
+                "description": "Seconds to wait before retrying (for rate limit errors)",
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "type": {
+                "description": "Error type for programmatic handling",
+                "enum": [
+                  "invalid_request_error",
+                  "authentication_error",
+                  "authorization_error",
+                  "not_found_error",
+                  "rate_limit_error",
+                  "api_error"
+                ],
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "message",
+              "code",
+              "param",
+              "retry_after"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "error"
+        ],
+        "type": "object"
+      },
+      "GenerateEntryPageRequest": {
+        "additionalProperties": false,
+        "description": "GenerateEntryPageRequest identifies a document to generate an entry page for.",
+        "properties": {
+          "document_id": {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "document_id",
+            "type": "string"
+          }
+        },
+        "title": "GenerateEntryPageRequest",
+        "type": "object"
+      },
+      "GenerateEntryPageResponse": {
+        "additionalProperties": false,
+        "description": "GenerateEntryPageResponse contains the download URL for the entry page.",
+        "properties": {
+          "download_url": {
+            "description": "Temporary download URL for the entry page PDF.",
+            "example": "https://storage.factify.com/entry-pages/abc123.pdf?token=xyz",
+            "format": "uri",
+            "title": "download_url",
+            "type": "string"
+          }
+        },
+        "required": [
+          "download_url"
+        ],
+        "title": "GenerateEntryPageResponse",
+        "type": "object"
+      },
+      "GetDocumentRequest": {
+        "additionalProperties": false,
+        "description": "GetDocumentRequest identifies a document to retrieve.",
+        "properties": {
+          "document_id": {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "document_id",
+            "type": "string"
+          }
+        },
+        "title": "GetDocumentRequest",
+        "type": "object"
+      },
+      "GetDocumentResponse": {
+        "additionalProperties": false,
+        "description": "GetDocumentResponse contains the requested document.",
+        "properties": {
+          "document": {
+            "$ref": "#/components/schemas/Document",
+            "description": "The requested document.",
+            "title": "document"
+          }
+        },
+        "title": "GetDocumentResponse",
+        "type": "object"
+      },
+      "GetVersionRequest": {
+        "additionalProperties": false,
+        "description": "GetVersionRequest identifies a specific version to retrieve.",
+        "properties": {
+          "document_id": {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "document_id",
+            "type": "string"
+          },
+          "version_id": {
+            "description": "Version ID.\n Pattern: ver_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^ver_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "version_id",
+            "type": "string"
+          }
+        },
+        "title": "GetVersionRequest",
+        "type": "object"
+      },
+      "ListDocumentPoliciesRequest": {
+        "additionalProperties": false,
+        "description": "ListDocumentPoliciesRequest specifies pagination for listing document policies.\n Follows Google AIP-158 for pagination field naming.",
+        "properties": {
+          "document_id": {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "document_id",
+            "type": "string"
+          },
+          "page_size": {
+            "description": "Maximum number of items to return per page (1-100). Default: 50.",
+            "format": "int32",
+            "maximum": 100,
+            "minimum": 1,
+            "nullable": true,
+            "title": "page_size",
+            "type": "integer"
+          },
+          "page_token": {
+            "description": "Opaque pagination token from a previous response.\n Pass next_page_token or prev_page_token from a previous response to continue pagination.\n Empty or omitted for the first page.",
+            "example": "eyJpZCI6InBvbF8wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0IiwiZiI6eyJkb2NfaWQiOiJkb2NfMDFoMnhjZWpxdGYybmJyZXh4M3ZxamhwNDEifX0",
+            "title": "page_token",
+            "type": "string"
+          }
+        },
+        "title": "ListDocumentPoliciesRequest",
+        "type": "object"
+      },
+      "ListDocumentPoliciesResponse": {
+        "additionalProperties": false,
+        "description": "ListDocumentPoliciesResponse contains a page of policy attachments.",
+        "properties": {
+          "items": {
+            "description": "List of policy attachments.",
+            "items": {
+              "$ref": "#/components/schemas/DocumentPolicy"
+            },
+            "title": "items",
+            "type": "array"
+          },
+          "pagination": {
+            "$ref": "#/components/schemas/Pagination",
+            "description": "Pagination metadata.",
+            "title": "pagination"
+          }
+        },
+        "title": "ListDocumentPoliciesResponse",
+        "type": "object"
+      },
+      "ListDocumentsRequest": {
+        "additionalProperties": false,
+        "description": "ListDocumentsRequest specifies filters and pagination for listing documents.\n Follows Google AIP-158 for pagination field naming.\n Note: Keeping filters flat (not nested) for cleaner REST API query parameters.\n Nested message would result in ?filters.created_after=... which is verbose.\n To implement nested filters with flat REST params would require both:\n 1. OpenAPI post-processing (cosmetic for docs)\n 2. Custom middleware/transcoding (runtime behavior)\ncreated_time_range // created_after must be before created_before\n",
+        "properties": {
+          "created_after": {
+            "description": "Filter: return documents created after this timestamp.",
+            "format": "date-time",
+            "nullable": true,
+            "title": "created_after",
+            "type": "string"
+          },
+          "created_before": {
+            "description": "Filter: return documents created before this timestamp.",
+            "format": "date-time",
+            "nullable": true,
+            "title": "created_before",
+            "type": "string"
+          },
+          "page_size": {
+            "description": "Maximum number of items to return per page (1-100). Default: 50.",
+            "format": "int32",
+            "maximum": 100,
+            "minimum": 1,
+            "nullable": true,
+            "title": "page_size",
+            "type": "integer"
+          },
+          "page_token": {
+            "description": "Opaque pagination token from a previous response.\n Pass next_page_token or prev_page_token from a previous response to continue pagination.\n Empty or omitted for the first page.",
+            "example": "eyJpZCI6ImRvY18wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0In0",
+            "title": "page_token",
+            "type": "string"
+          }
+        },
+        "title": "ListDocumentsRequest",
+        "type": "object"
+      },
+      "ListDocumentsResponse": {
+        "additionalProperties": false,
+        "description": "ListDocumentsResponse contains a page of documents.",
+        "properties": {
+          "items": {
+            "description": "List of documents.",
+            "items": {
+              "$ref": "#/components/schemas/Document"
+            },
+            "title": "items",
+            "type": "array"
+          },
+          "pagination": {
+            "$ref": "#/components/schemas/Pagination",
+            "description": "Pagination metadata.",
+            "title": "pagination"
+          }
+        },
+        "title": "ListDocumentsResponse",
+        "type": "object"
+      },
+      "ListVersionsRequest": {
+        "additionalProperties": false,
+        "description": "ListVersionsRequest specifies filters and pagination for listing versions.\n Follows Google AIP-158 for pagination field naming.",
+        "properties": {
+          "document_id": {
+            "description": "Document ID to list versions for.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "document_id",
+            "type": "string"
+          },
+          "page_size": {
+            "description": "Maximum number of items to return per page (1-100). Default: 50.",
+            "format": "int32",
+            "maximum": 100,
+            "minimum": 1,
+            "nullable": true,
+            "title": "page_size",
+            "type": "integer"
+          },
+          "page_token": {
+            "description": "Opaque pagination token from a previous response.\n Pass next_page_token or prev_page_token from a previous response to continue pagination.\n Empty or omitted for the first page.",
+            "example": "eyJpZCI6InZlcl8wMWgyYWJjZDEyMzRlZmdoNTY3OGprbW5wdCIsImQiOiJuZXh0IiwiZiI6eyJkb2NfaWQiOiJkb2NfMDFoMnhjZWpxdGYybmJyZXh4M3ZxamhwNDEifX0",
+            "title": "page_token",
+            "type": "string"
+          }
+        },
+        "title": "ListVersionsRequest",
+        "type": "object"
+      },
+      "ListVersionsResponse": {
+        "additionalProperties": false,
+        "description": "ListVersionsResponse contains a page of versions.",
+        "properties": {
+          "items": {
+            "description": "List of versions.",
+            "items": {
+              "$ref": "#/components/schemas/Version"
+            },
+            "title": "items",
+            "type": "array"
+          },
+          "pagination": {
+            "$ref": "#/components/schemas/Pagination",
+            "description": "Pagination metadata.",
+            "title": "pagination"
+          }
+        },
+        "title": "ListVersionsResponse",
+        "type": "object"
+      },
+      "Pagination": {
+        "additionalProperties": false,
+        "description": "Pagination contains cursor-based pagination metadata.\n Follows Google AIP-158 for pagination field naming.",
+        "properties": {
+          "has_more": {
+            "description": "Whether there are more results in the forward direction.",
+            "title": "has_more",
+            "type": "boolean"
+          },
+          "next_page_token": {
+            "description": "Token to retrieve the next page of results.\n Empty if there are no more results in the forward direction.",
+            "example": "eyJpZCI6ImRvY18wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0In0",
+            "title": "next_page_token",
+            "type": "string"
+          },
+          "prev_page_token": {
+            "description": "Token to retrieve the previous page of results.\n Empty if this is the first page.",
+            "example": "eyJpZCI6ImRvY18wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJwcmV2In0",
+            "title": "prev_page_token",
+            "type": "string"
+          }
+        },
+        "title": "Pagination",
+        "type": "object"
+      },
+      "Policy": {
+        "additionalProperties": false,
+        "description": "Policy represents a governance policy.",
+        "properties": {
+          "created_at": {
+            "description": "Timestamp when policy was created.",
+            "format": "date-time",
+            "title": "created_at",
+            "type": "string"
+          },
+          "id": {
+            "description": "Unique ID for the policy.\n Pattern: pol_[0-9a-hjkmnp-tv-z]{26}",
+            "example": "pol_01h2xcejqtf2nbrexx3vqjhp41",
+            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "id",
+            "type": "string"
+          },
+          "name": {
+            "description": "Policy name.",
+            "example": "GDPR Compliance Policy",
+            "minLength": 1,
+            "title": "name",
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "created_at"
+        ],
+        "title": "Policy",
+        "type": "object"
+      },
+      "ProcessingStatus": {
+        "enum": [
+          "processing",
+          "ready",
+          "failed"
+        ]
+      },
+      "UpdateDocumentRequest": {
+        "additionalProperties": false,
+        "description": "UpdateDocumentRequest specifies fields to update on a document.",
+        "properties": {
+          "description": {
+            "description": "New description (max 2000 characters).",
+            "maxLength": 2000,
+            "nullable": true,
+            "title": "description",
+            "type": "string"
+          },
+          "document_id": {
+            "description": "Document ID to update.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "document_id",
+            "type": "string"
+          },
+          "title": {
+            "description": "New title (1-255 characters).",
+            "maxLength": 255,
+            "minLength": 1,
+            "nullable": true,
+            "title": "title",
+            "type": "string"
+          }
+        },
+        "title": "UpdateDocumentRequest",
+        "type": "object"
+      },
+      "UpdateDocumentResponse": {
+        "additionalProperties": false,
+        "description": "UpdateDocumentResponse contains the updated document.",
+        "properties": {
+          "document": {
+            "$ref": "#/components/schemas/Document",
+            "description": "The updated document.",
+            "title": "document"
+          }
+        },
+        "title": "UpdateDocumentResponse",
+        "type": "object"
+      },
+      "UpdateVersionRequest": {
+        "additionalProperties": false,
+        "description": "UpdateVersionRequest specifies fields to update on a version.",
+        "properties": {
+          "description": {
+            "description": "New description.",
+            "nullable": true,
+            "title": "description",
+            "type": "string"
+          },
+          "document_id": {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "document_id",
+            "type": "string"
+          },
+          "title": {
+            "description": "New title (max 255 characters).",
+            "maxLength": 255,
+            "nullable": true,
+            "title": "title",
+            "type": "string"
+          },
+          "version_id": {
+            "description": "Version ID to update.\n Pattern: ver_[0-9a-hjkmnp-tv-z]{26}",
+            "pattern": "^ver_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "version_id",
+            "type": "string"
+          }
+        },
+        "title": "UpdateVersionRequest",
+        "type": "object"
+      },
+      "User": {
+        "additionalProperties": false,
+        "description": "User represents a user or service account.",
+        "properties": {
+          "id": {
+            "description": "Unique ID for the user or service account.\n Pattern: user_[0-9a-hjkmnp-tv-z]{26} for users, svc_[0-9a-hjkmnp-tv-z]{26} for service accounts",
+            "example": "user_01h2xcejqtf2nbrexx3vqjhp41",
+            "pattern": "^(user|svc)_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "id",
+            "type": "string"
+          },
+          "name": {
+            "description": "Display name of the user or service account.",
+            "example": "John Doe",
+            "minLength": 1,
+            "title": "name",
+            "type": "string"
+          },
+          "type": {
+            "$ref": "#/components/schemas/UserType",
+            "description": "User type discriminator.",
+            "title": "type"
+          }
+        },
+        "required": [
+          "id",
+          "type",
+          "name"
+        ],
+        "title": "User",
+        "type": "object"
+      },
+      "UserType": {
+        "enum": [
+          "user_account",
+          "service_account"
+        ]
+      },
+      "Version": {
+        "additionalProperties": false,
+        "description": "Version represents a document version.",
+        "properties": {
+          "created_at": {
+            "description": "Timestamp when version was created.",
+            "format": "date-time",
+            "title": "created_at",
+            "type": "string"
+          },
+          "created_by": {
+            "$ref": "#/components/schemas/User",
+            "description": "User who created the version.",
+            "title": "created_by"
+          },
+          "description": {
+            "description": "Description of changes in this version.",
+            "nullable": true,
+            "title": "description",
+            "type": "string"
+          },
+          "document_id": {
+            "description": "Parent document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "example": "doc_01h2xcejqtf2nbrexx3vqjhp41",
+            "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "document_id",
+            "type": "string"
+          },
+          "id": {
+            "description": "Unique ID for the version.\n Pattern: ver_[0-9a-hjkmnp-tv-z]{26}",
+            "example": "ver_01h2abcd1234efgh5678jkmnpt",
+            "pattern": "^ver_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "id",
+            "type": "string"
+          },
+          "processing_status": {
+            "$ref": "#/components/schemas/ProcessingStatus",
+            "description": "Processing status.",
+            "title": "processing_status"
+          },
+          "title": {
+            "description": "Optional version title.",
+            "example": "Version 2.0",
+            "maxLength": 255,
+            "nullable": true,
+            "title": "title",
+            "type": "string"
+          },
+          "url": {
+            "description": "URL for accessing this version on Factify.",
+            "example": "https://d.factify.com/d/01h2xcejqtf2nbrexx3vqjhp41/v/1",
+            "format": "uri",
+            "title": "url",
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "document_id",
+          "url",
+          "processing_status",
+          "created_at",
+          "created_by"
+        ],
+        "title": "Version",
+        "type": "object"
+      },
+      "VersionRef": {
+        "additionalProperties": false,
+        "description": "VersionRef is a lightweight reference to a version.",
+        "properties": {
+          "id": {
+            "description": "Version ID.\n Pattern: ver_[0-9a-hjkmnp-tv-z]{26}",
+            "example": "ver_01h2abcd1234efgh5678jkmnpt",
+            "pattern": "^ver_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "id",
+            "type": "string"
+          }
+        },
+        "required": [
+          "id"
+        ],
+        "title": "VersionRef",
+        "type": "object"
+      }
+    },
+    "securitySchemes": {
+      "bearerAuth": {
+        "bearerFormat": "API Key",
+        "description": "Bearer authentication header of the form Bearer <token>, where <token> is your auth token.",
+        "scheme": "bearer",
+        "type": "http"
+      }
+    }
+  },
+  "info": {
+    "contact": {
+      "email": "api@factify.com",
+      "name": "Factify API Support",
+      "url": "https://factify.com/support"
+    },
+    "description": "Factify API enables you to create, manage, and control access to legally-binding documents that replace PDFs.\n\n## Authentication\n\nBearer authentication header of the form Bearer <token>, where <token> is your auth token.\n\n```\nAuthorization: Bearer ffy...\n```\n\n## Rate Limiting\n\n- 1000 requests per minute per API key\n- 100 requests per minute for resource creation (POST)\n\n## Errors\n\nFactify uses conventional HTTP status codes and returns structured error responses:\n\n```json\n{\n  \"error\": {\n    \"type\": \"invalid_request_error\",\n    \"message\": \"Document title cannot be empty\",\n    \"param\": \"title\",\n    \"code\": \"missing_required_field\"\n  }\n}\n```\n",
+    "license": {
+      "name": "Proprietary",
+      "url": "https://factify.com/terms"
+    },
+    "title": "Factify API",
+    "version": "1.0.0"
+  },
+  "openapi": "3.1.0",
+  "paths": {
+    "/v1beta/documents": {
+      "get": {
+        "description": "List documents with cursor-based pagination.",
+        "operationId": "listDocuments",
+        "parameters": [
+          {
+            "description": "Opaque pagination token from a previous response.\n Pass next_page_token or prev_page_token from a previous response to continue pagination.\n Empty or omitted for the first page.",
+            "in": "query",
+            "name": "page_token",
+            "schema": {
+              "description": "Opaque pagination token from a previous response.\n Pass next_page_token or prev_page_token from a previous response to continue pagination.\n Empty or omitted for the first page.",
+              "example": "eyJpZCI6ImRvY18wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0In0",
+              "title": "page_token",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Maximum number of items to return per page (1-100). Default: 50.",
+            "in": "query",
+            "name": "page_size",
+            "schema": {
+              "description": "Maximum number of items to return per page (1-100). Default: 50.",
+              "format": "int32",
+              "maximum": 100,
+              "minimum": 1,
+              "title": "page_size",
+              "type": "integer"
+            }
+          },
+          {
+            "description": "Filter by created after (RFC 3339 format, e.g., 2024-01-15T09:30:00Z)",
+            "in": "query",
+            "name": "created_after",
+            "schema": {
+              "format": "date-time",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListDocumentsResponse"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "List documents",
+        "tags": [
+          "Documents"
+        ],
+        "x-speakeasy-name-override": "list",
+        "x-speakeasy-pagination": {
+          "type": "cursor",
+          "inputs": [
+            {
+              "name": "page_token",
+              "in": "parameters",
+              "type": "cursor"
+            }
+          ],
+          "outputs": {
+            "nextCursor": "$.pagination.next_page_token"
+          }
+        },
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "listDocuments",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n});\n\nasync function run() {\n  const result = await factify.documents.list({\n    pageToken: \"eyJpZCI6ImRvY18wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0In0\",\n  });\n\n  for await (const page of result) {\n    console.log(page);\n  }\n}\n\nrun();"
+          },
+          {
+            "lang": "java",
+            "label": "listDocuments",
+            "source": "package hello.world;\n\nimport java.lang.Exception;\nimport org.openapis.openapi.Factify;\nimport org.openapis.openapi.models.errors.Error;\nimport org.openapis.openapi.models.operations.ListDocumentsResponse;\n\npublic class Application {\n\n    public static void main(String[] args) throws Error, Exception {\n\n        Factify sdk = Factify.builder()\n                .bearerAuth(System.getenv().getOrDefault(\"BEARER_AUTH\", \"\"))\n            .build();\n\n\n        sdk.documents().list()\n                .pageToken(\"eyJpZCI6ImRvY18wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0In0\")\n                .callAsStream()\n                .forEach((ListDocumentsResponse item) -> {\n                   // handle page\n                });\n\n    }\n}"
+          }
+        ]
+      },
+      "post": {
+        "description": "Creates a new document by uploading a PDF file.",
+        "operationId": "createDocument",
+        "requestBody": {
+          "content": {
+            "multipart/form-data": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateDocumentRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CreateDocumentResponse"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "Create a document",
+        "tags": [
+          "Documents"
+        ],
+        "x-speakeasy-name-override": "create",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "createDocument",
+            "source": "import { Factify } from \"@factify/sdk\";\nimport { openAsBlob } from \"node:fs\";\n\nconst factify = new Factify({\n  bearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n});\n\nasync function run() {\n  const result = await factify.documents.create({\n    payload: await openAsBlob(\"example.file\"),\n    title: \"<value>\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          },
+          {
+            "lang": "java",
+            "label": "createDocument",
+            "source": "package hello.world;\n\nimport java.lang.Exception;\nimport java.nio.file.Paths;\nimport org.openapis.openapi.Factify;\nimport org.openapis.openapi.models.components.CreateDocumentRequest;\nimport org.openapis.openapi.models.components.CreateDocumentRequestPayload;\nimport org.openapis.openapi.models.errors.Error;\nimport org.openapis.openapi.models.operations.CreateDocumentResponse;\nimport org.openapis.openapi.utils.Blob;\n\npublic class Application {\n\n    public static void main(String[] args) throws Error, Exception {\n\n        Factify sdk = Factify.builder()\n                .bearerAuth(System.getenv().getOrDefault(\"BEARER_AUTH\", \"\"))\n            .build();\n\n        CreateDocumentRequest req = CreateDocumentRequest.builder()\n                .payload(CreateDocumentRequestPayload.builder()\n                    .fileName(\"example.file\")\n                    .content(Blob.from(Paths.get(\"example.file\")))\n                    .build())\n                .title(\"<value>\")\n                .build();\n\n        CreateDocumentResponse res = sdk.documents().create()\n                .request(req)\n                .call();\n\n    }\n}"
+          }
+        ]
+      }
+    },
+    "/v1beta/documents/{document_id}": {
+      "get": {
+        "description": "Retrieve a document by ID.",
+        "operationId": "getDocument",
+        "parameters": [
+          {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "in": "path",
+            "name": "document_id",
+            "required": true,
+            "schema": {
+              "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+              "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "document_id",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetDocumentResponse"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "Retrieve a document",
+        "tags": [
+          "Documents"
+        ],
+        "x-speakeasy-name-override": "get",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "getDocument",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n});\n\nasync function run() {\n  const result = await factify.documents.get({\n    documentId: \"<id>\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          },
+          {
+            "lang": "java",
+            "label": "getDocument",
+            "source": "package hello.world;\n\nimport java.lang.Exception;\nimport org.openapis.openapi.Factify;\nimport org.openapis.openapi.models.errors.Error;\nimport org.openapis.openapi.models.operations.GetDocumentResponse;\n\npublic class Application {\n\n    public static void main(String[] args) throws Error, Exception {\n\n        Factify sdk = Factify.builder()\n                .bearerAuth(System.getenv().getOrDefault(\"BEARER_AUTH\", \"\"))\n            .build();\n\n        GetDocumentResponse res = sdk.documents().get()\n                .documentId(\"<id>\")\n                .call();\n\n        if (res.getDocumentResponse().isPresent()) {\n            // handle response\n        }\n    }\n}"
+          }
+        ]
+      },
+      "patch": {
+        "description": "Update document title and description.",
+        "operationId": "updateDocument",
+        "parameters": [
+          {
+            "description": "Document ID to update.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "in": "path",
+            "name": "document_id",
+            "required": true,
+            "schema": {
+              "description": "Document ID to update.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+              "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "document_id",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "description": "UpdateDocumentRequest specifies fields to update on a document.",
+                "properties": {
+                  "description": {
+                    "description": "New description (max 2000 characters).",
+                    "maxLength": 2000,
+                    "nullable": true,
+                    "title": "description",
+                    "type": "string"
+                  },
+                  "title": {
+                    "description": "New title (1-255 characters).",
+                    "maxLength": 255,
+                    "minLength": 1,
+                    "nullable": true,
+                    "title": "title",
+                    "type": "string"
+                  }
+                },
+                "title": "UpdateDocumentRequest",
+                "type": "object"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UpdateDocumentResponse"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "Update a document",
+        "tags": [
+          "Documents"
+        ],
+        "x-speakeasy-name-override": "update",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "updateDocument",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n});\n\nasync function run() {\n  const result = await factify.documents.update({\n    documentId: \"<id>\",\n    body: {},\n  });\n\n  console.log(result);\n}\n\nrun();"
+          },
+          {
+            "lang": "java",
+            "label": "updateDocument",
+            "source": "package hello.world;\n\nimport java.lang.Exception;\nimport org.openapis.openapi.Factify;\nimport org.openapis.openapi.models.errors.Error;\nimport org.openapis.openapi.models.operations.UpdateDocumentResponse;\nimport org.openapis.openapi.models.operations.UpdateDocumentUpdateDocumentRequest;\n\npublic class Application {\n\n    public static void main(String[] args) throws Error, Exception {\n\n        Factify sdk = Factify.builder()\n                .bearerAuth(System.getenv().getOrDefault(\"BEARER_AUTH\", \"\"))\n            .build();\n\n        UpdateDocumentResponse res = sdk.documents().update()\n                .documentId(\"<id>\")\n                .body(UpdateDocumentUpdateDocumentRequest.builder()\n                    .build())\n                .call();\n\n        if (res.updateDocumentResponse().isPresent()) {\n            // handle response\n        }\n    }\n}"
+          }
+        ]
+      }
+    },
+    "/v1beta/documents/{document_id}/entry_page": {
+      "post": {
+        "description": "Generate and return a temporary downloadable URL for the document entry page PDF.",
+        "operationId": "generateDocumentEntryPage",
+        "parameters": [
+          {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "in": "path",
+            "name": "document_id",
+            "required": true,
+            "schema": {
+              "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+              "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "document_id",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GenerateEntryPageResponse"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "Generate entry page",
+        "tags": [
+          "Entry Pages"
+        ],
+        "x-speakeasy-group": "entryPages",
+        "x-speakeasy-name-override": "generate",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "generateDocumentEntryPage",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n});\n\nasync function run() {\n  const result = await factify.entryPages.generate({\n    documentId: \"<id>\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          },
+          {
+            "lang": "java",
+            "label": "generateDocumentEntryPage",
+            "source": "package hello.world;\n\nimport java.lang.Exception;\nimport org.openapis.openapi.Factify;\nimport org.openapis.openapi.models.errors.Error;\nimport org.openapis.openapi.models.operations.GenerateDocumentEntryPageResponse;\n\npublic class Application {\n\n    public static void main(String[] args) throws Error, Exception {\n\n        Factify sdk = Factify.builder()\n                .bearerAuth(System.getenv().getOrDefault(\"BEARER_AUTH\", \"\"))\n            .build();\n\n        GenerateDocumentEntryPageResponse res = sdk.entryPages().generate()\n                .documentId(\"<id>\")\n                .call();\n\n        if (res.generateEntryPageResponse().isPresent()) {\n            // handle response\n        }\n    }\n}"
+          }
+        ]
+      }
+    },
+    "/v1beta/documents/{document_id}/policies": {
+      "get": {
+        "description": "List policies attached to a document.",
+        "operationId": "listDocumentPolicies",
+        "parameters": [
+          {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "in": "path",
+            "name": "document_id",
+            "required": true,
+            "schema": {
+              "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+              "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "document_id",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Opaque pagination token from a previous response.\n Pass next_page_token or prev_page_token from a previous response to continue pagination.\n Empty or omitted for the first page.",
+            "in": "query",
+            "name": "page_token",
+            "schema": {
+              "description": "Opaque pagination token from a previous response.\n Pass next_page_token or prev_page_token from a previous response to continue pagination.\n Empty or omitted for the first page.",
+              "example": "eyJpZCI6InBvbF8wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0IiwiZiI6eyJkb2NfaWQiOiJkb2NfMDFoMnhjZWpxdGYybmJyZXh4M3ZxamhwNDEifX0",
+              "title": "page_token",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Maximum number of items to return per page (1-100). Default: 50.",
+            "in": "query",
+            "name": "page_size",
+            "schema": {
+              "description": "Maximum number of items to return per page (1-100). Default: 50.",
+              "format": "int32",
+              "maximum": 100,
+              "minimum": 1,
+              "title": "page_size",
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListDocumentPoliciesResponse"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "List document policies",
+        "tags": [
+          "Policies"
+        ],
+        "x-speakeasy-name-override": "list",
+        "x-speakeasy-pagination": {
+          "type": "cursor",
+          "inputs": [
+            {
+              "name": "page_token",
+              "in": "parameters",
+              "type": "cursor"
+            }
+          ],
+          "outputs": {
+            "nextCursor": "$.pagination.next_page_token"
+          }
+        },
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "listDocumentPolicies",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n});\n\nasync function run() {\n  const result = await factify.policies.list({\n    documentId: \"<id>\",\n    pageToken: \"eyJpZCI6InBvbF8wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0IiwiZiI6eyJkb2NfaWQiOiJkb2NfMDFoMnhjZWpxdGYybmJyZXh4M3ZxamhwNDEifX0\",\n  });\n\n  for await (const page of result) {\n    console.log(page);\n  }\n}\n\nrun();"
+          },
+          {
+            "lang": "java",
+            "label": "listDocumentPolicies",
+            "source": "package hello.world;\n\nimport java.lang.Exception;\nimport org.openapis.openapi.Factify;\nimport org.openapis.openapi.models.errors.Error;\nimport org.openapis.openapi.models.operations.ListDocumentPoliciesResponse;\n\npublic class Application {\n\n    public static void main(String[] args) throws Error, Exception {\n\n        Factify sdk = Factify.builder()\n                .bearerAuth(System.getenv().getOrDefault(\"BEARER_AUTH\", \"\"))\n            .build();\n\n\n        sdk.policies().list()\n                .documentId(\"<id>\")\n                .pageToken(\"eyJpZCI6InBvbF8wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0IiwiZiI6eyJkb2NfaWQiOiJkb2NfMDFoMnhjZWpxdGYybmJyZXh4M3ZxamhwNDEifX0\")\n                .callAsStream()\n                .forEach((ListDocumentPoliciesResponse item) -> {\n                   // handle page\n                });\n\n    }\n}"
+          }
+        ]
+      },
+      "post": {
+        "description": "Attach a policy to a document.",
+        "operationId": "attachDocumentPolicy",
+        "parameters": [
+          {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "in": "path",
+            "name": "document_id",
+            "required": true,
+            "schema": {
+              "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+              "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "document_id",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "description": "AttachPolicyRequest specifies a policy to attach to a document.",
+                "properties": {
+                  "policy_id": {
+                    "description": "Policy ID to attach.\n Pattern: pol_[0-9a-hjkmnp-tv-z]{26}",
+                    "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
+                    "title": "policy_id",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "policy_id"
+                ],
+                "title": "AttachPolicyRequest",
+                "type": "object"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DocumentPolicy"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "Attach a policy",
+        "tags": [
+          "Policies"
+        ],
+        "x-speakeasy-name-override": "attach",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "attachDocumentPolicy",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n});\n\nasync function run() {\n  const result = await factify.policies.attach({\n    documentId: \"<id>\",\n    body: {\n      policyId: \"<id>\",\n    },\n  });\n\n  console.log(result);\n}\n\nrun();"
+          },
+          {
+            "lang": "java",
+            "label": "attachDocumentPolicy",
+            "source": "package hello.world;\n\nimport java.lang.Exception;\nimport org.openapis.openapi.Factify;\nimport org.openapis.openapi.models.errors.Error;\nimport org.openapis.openapi.models.operations.AttachDocumentPolicyResponse;\nimport org.openapis.openapi.models.operations.AttachPolicyRequest;\n\npublic class Application {\n\n    public static void main(String[] args) throws Error, Exception {\n\n        Factify sdk = Factify.builder()\n                .bearerAuth(System.getenv().getOrDefault(\"BEARER_AUTH\", \"\"))\n            .build();\n\n        AttachDocumentPolicyResponse res = sdk.policies().attach()\n                .documentId(\"<id>\")\n                .body(AttachPolicyRequest.builder()\n                    .policyId(\"<id>\")\n                    .build())\n                .call();\n\n        if (res.documentPolicy().isPresent()) {\n            // handle response\n        }\n    }\n}"
+          }
+        ]
+      }
+    },
+    "/v1beta/documents/{document_id}/policies/{policy_id}": {
+      "delete": {
+        "description": "Detach a policy from a document.",
+        "operationId": "detachDocumentPolicy",
+        "parameters": [
+          {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "in": "path",
+            "name": "document_id",
+            "required": true,
+            "schema": {
+              "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+              "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "document_id",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Policy ID to detach.\n Pattern: pol_[0-9a-hjkmnp-tv-z]{26}",
+            "in": "path",
+            "name": "policy_id",
+            "required": true,
+            "schema": {
+              "description": "Policy ID to detach.\n Pattern: pol_[0-9a-hjkmnp-tv-z]{26}",
+              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "policy_id",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Empty"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "Detach a policy",
+        "tags": [
+          "Policies"
+        ],
+        "x-speakeasy-name-override": "detach",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "detachDocumentPolicy",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n});\n\nasync function run() {\n  const result = await factify.policies.detach({\n    documentId: \"<id>\",\n    policyId: \"<id>\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          },
+          {
+            "lang": "java",
+            "label": "detachDocumentPolicy",
+            "source": "package hello.world;\n\nimport java.lang.Exception;\nimport org.openapis.openapi.Factify;\nimport org.openapis.openapi.models.errors.Error;\nimport org.openapis.openapi.models.operations.DetachDocumentPolicyResponse;\n\npublic class Application {\n\n    public static void main(String[] args) throws Error, Exception {\n\n        Factify sdk = Factify.builder()\n                .bearerAuth(System.getenv().getOrDefault(\"BEARER_AUTH\", \"\"))\n            .build();\n\n        DetachDocumentPolicyResponse res = sdk.policies().detach()\n                .documentId(\"<id>\")\n                .policyId(\"<id>\")\n                .call();\n\n        if (res.empty().isPresent()) {\n            // handle response\n        }\n    }\n}"
+          }
+        ]
+      }
+    },
+    "/v1beta/documents/{document_id}/versions": {
+      "get": {
+        "description": "List versions for a document with cursor-based pagination.",
+        "operationId": "listDocumentVersions",
+        "parameters": [
+          {
+            "description": "Document ID to list versions for.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "in": "path",
+            "name": "document_id",
+            "required": true,
+            "schema": {
+              "description": "Document ID to list versions for.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+              "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "document_id",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Opaque pagination token from a previous response.\n Pass next_page_token or prev_page_token from a previous response to continue pagination.\n Empty or omitted for the first page.",
+            "in": "query",
+            "name": "page_token",
+            "schema": {
+              "description": "Opaque pagination token from a previous response.\n Pass next_page_token or prev_page_token from a previous response to continue pagination.\n Empty or omitted for the first page.",
+              "example": "eyJpZCI6InZlcl8wMWgyYWJjZDEyMzRlZmdoNTY3OGprbW5wdCIsImQiOiJuZXh0IiwiZiI6eyJkb2NfaWQiOiJkb2NfMDFoMnhjZWpxdGYybmJyZXh4M3ZxamhwNDEifX0",
+              "title": "page_token",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Maximum number of items to return per page (1-100). Default: 50.",
+            "in": "query",
+            "name": "page_size",
+            "schema": {
+              "description": "Maximum number of items to return per page (1-100). Default: 50.",
+              "format": "int32",
+              "maximum": 100,
+              "minimum": 1,
+              "title": "page_size",
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListVersionsResponse"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "List document versions",
+        "tags": [
+          "Versions"
+        ],
+        "x-speakeasy-name-override": "list",
+        "x-speakeasy-pagination": {
+          "type": "cursor",
+          "inputs": [
+            {
+              "name": "page_token",
+              "in": "parameters",
+              "type": "cursor"
+            }
+          ],
+          "outputs": {
+            "nextCursor": "$.pagination.next_page_token"
+          }
+        },
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "listDocumentVersions",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n});\n\nasync function run() {\n  const result = await factify.versions.list({\n    documentId: \"<id>\",\n    pageToken: \"eyJpZCI6InZlcl8wMWgyYWJjZDEyMzRlZmdoNTY3OGprbW5wdCIsImQiOiJuZXh0IiwiZiI6eyJkb2NfaWQiOiJkb2NfMDFoMnhjZWpxdGYybmJyZXh4M3ZxamhwNDEifX0\",\n  });\n\n  for await (const page of result) {\n    console.log(page);\n  }\n}\n\nrun();"
+          },
+          {
+            "lang": "java",
+            "label": "listDocumentVersions",
+            "source": "package hello.world;\n\nimport java.lang.Exception;\nimport org.openapis.openapi.Factify;\nimport org.openapis.openapi.models.errors.Error;\nimport org.openapis.openapi.models.operations.ListDocumentVersionsResponse;\n\npublic class Application {\n\n    public static void main(String[] args) throws Error, Exception {\n\n        Factify sdk = Factify.builder()\n                .bearerAuth(System.getenv().getOrDefault(\"BEARER_AUTH\", \"\"))\n            .build();\n\n\n        sdk.versions().list()\n                .documentId(\"<id>\")\n                .pageToken(\"eyJpZCI6InZlcl8wMWgyYWJjZDEyMzRlZmdoNTY3OGprbW5wdCIsImQiOiJuZXh0IiwiZiI6eyJkb2NfaWQiOiJkb2NfMDFoMnhjZWpxdGYybmJyZXh4M3ZxamhwNDEifX0\")\n                .callAsStream()\n                .forEach((ListDocumentVersionsResponse item) -> {\n                   // handle page\n                });\n\n    }\n}"
+          }
+        ]
+      },
+      "post": {
+        "description": "Creates a new version by uploading a PDF file.",
+        "operationId": "createDocumentVersion",
+        "parameters": [
+          {
+            "description": "Document ID to create version for.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "in": "path",
+            "name": "document_id",
+            "required": true,
+            "schema": {
+              "description": "Document ID to create version for.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+              "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "document_id",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "multipart/form-data": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateVersionRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Version"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "Create a new version",
+        "tags": [
+          "Versions"
+        ],
+        "x-speakeasy-name-override": "create",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "createDocumentVersion",
+            "source": "import { Factify } from \"@factify/sdk\";\nimport { openAsBlob } from \"node:fs\";\n\nconst factify = new Factify({\n  bearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n});\n\nasync function run() {\n  const result = await factify.versions.create({\n    documentId: \"<id>\",\n    body: {\n      payload: await openAsBlob(\"example.file\"),\n    },\n  });\n\n  console.log(result);\n}\n\nrun();"
+          },
+          {
+            "lang": "java",
+            "label": "createDocumentVersion",
+            "source": "package hello.world;\n\nimport java.lang.Exception;\nimport java.nio.file.Paths;\nimport org.openapis.openapi.Factify;\nimport org.openapis.openapi.models.components.CreateVersionRequest;\nimport org.openapis.openapi.models.components.CreateVersionRequestPayload;\nimport org.openapis.openapi.models.errors.Error;\nimport org.openapis.openapi.models.operations.CreateDocumentVersionResponse;\nimport org.openapis.openapi.utils.Blob;\n\npublic class Application {\n\n    public static void main(String[] args) throws Error, Exception {\n\n        Factify sdk = Factify.builder()\n                .bearerAuth(System.getenv().getOrDefault(\"BEARER_AUTH\", \"\"))\n            .build();\n\n        CreateDocumentVersionResponse res = sdk.versions().create()\n                .documentId(\"<id>\")\n                .body(CreateVersionRequest.builder()\n                    .payload(CreateVersionRequestPayload.builder()\n                        .fileName(\"example.file\")\n                        .content(Blob.from(Paths.get(\"example.file\")))\n                        .build())\n                    .build())\n                .call();\n\n    }\n}"
+          }
+        ]
+      }
+    },
+    "/v1beta/documents/{document_id}/versions/{version_id}": {
+      "get": {
+        "description": "Retrieve a specific version by ID.",
+        "operationId": "getDocumentVersion",
+        "parameters": [
+          {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "in": "path",
+            "name": "document_id",
+            "required": true,
+            "schema": {
+              "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+              "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "document_id",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Version ID.\n Pattern: ver_[0-9a-hjkmnp-tv-z]{26}",
+            "in": "path",
+            "name": "version_id",
+            "required": true,
+            "schema": {
+              "description": "Version ID.\n Pattern: ver_[0-9a-hjkmnp-tv-z]{26}",
+              "pattern": "^ver_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "version_id",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Version"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "Retrieve a version",
+        "tags": [
+          "Versions"
+        ],
+        "x-speakeasy-name-override": "get",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "getDocumentVersion",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n});\n\nasync function run() {\n  const result = await factify.versions.get({\n    documentId: \"<id>\",\n    versionId: \"<id>\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          },
+          {
+            "lang": "java",
+            "label": "getDocumentVersion",
+            "source": "package hello.world;\n\nimport java.lang.Exception;\nimport org.openapis.openapi.Factify;\nimport org.openapis.openapi.models.errors.Error;\nimport org.openapis.openapi.models.operations.GetDocumentVersionResponse;\n\npublic class Application {\n\n    public static void main(String[] args) throws Error, Exception {\n\n        Factify sdk = Factify.builder()\n                .bearerAuth(System.getenv().getOrDefault(\"BEARER_AUTH\", \"\"))\n            .build();\n\n        GetDocumentVersionResponse res = sdk.versions().get()\n                .documentId(\"<id>\")\n                .versionId(\"<id>\")\n                .call();\n\n        if (res.version().isPresent()) {\n            // handle response\n        }\n    }\n}"
+          }
+        ]
+      },
+      "patch": {
+        "description": "Update version title and description.",
+        "operationId": "updateDocumentVersion",
+        "parameters": [
+          {
+            "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+            "in": "path",
+            "name": "document_id",
+            "required": true,
+            "schema": {
+              "description": "Document ID.\n Pattern: doc_[0-9a-hjkmnp-tv-z]{26}",
+              "pattern": "^doc_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "document_id",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Version ID to update.\n Pattern: ver_[0-9a-hjkmnp-tv-z]{26}",
+            "in": "path",
+            "name": "version_id",
+            "required": true,
+            "schema": {
+              "description": "Version ID to update.\n Pattern: ver_[0-9a-hjkmnp-tv-z]{26}",
+              "pattern": "^ver_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "version_id",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "description": "UpdateVersionRequest specifies fields to update on a version.",
+                "properties": {
+                  "description": {
+                    "description": "New description.",
+                    "nullable": true,
+                    "title": "description",
+                    "type": "string"
+                  },
+                  "title": {
+                    "description": "New title (max 255 characters).",
+                    "maxLength": 255,
+                    "nullable": true,
+                    "title": "title",
+                    "type": "string"
+                  }
+                },
+                "title": "UpdateVersionRequest",
+                "type": "object"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Version"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "Update a version",
+        "tags": [
+          "Versions"
+        ],
+        "x-speakeasy-name-override": "update",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "updateDocumentVersion",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n});\n\nasync function run() {\n  const result = await factify.versions.update({\n    documentId: \"<id>\",\n    versionId: \"<id>\",\n    body: {},\n  });\n\n  console.log(result);\n}\n\nrun();"
+          },
+          {
+            "lang": "java",
+            "label": "updateDocumentVersion",
+            "source": "package hello.world;\n\nimport java.lang.Exception;\nimport org.openapis.openapi.Factify;\nimport org.openapis.openapi.models.errors.Error;\nimport org.openapis.openapi.models.operations.UpdateDocumentVersionResponse;\nimport org.openapis.openapi.models.operations.UpdateVersionRequest;\n\npublic class Application {\n\n    public static void main(String[] args) throws Error, Exception {\n\n        Factify sdk = Factify.builder()\n                .bearerAuth(System.getenv().getOrDefault(\"BEARER_AUTH\", \"\"))\n            .build();\n\n        UpdateDocumentVersionResponse res = sdk.versions().update()\n                .documentId(\"<id>\")\n                .versionId(\"<id>\")\n                .body(UpdateVersionRequest.builder()\n                    .build())\n                .call();\n\n        if (res.version().isPresent()) {\n            // handle response\n        }\n    }\n}"
+          }
+        ]
+      }
+    }
+  },
+  "security": [
+    {
+      "bearerAuth": []
+    }
+  ],
+  "servers": [
+    {
+      "description": "Production",
+      "url": "https://api.factify.com"
+    },
+    {
+      "description": "Development (internal only)",
+      "url": "https://api.factify-dev.com"
+    }
+  ],
+  "tags": [
+    {
+      "description": "Create, retrieve, update, and manage documents.",
+      "name": "Documents"
+    },
+    {
+      "description": "Manage document versions and version history.",
+      "name": "Versions"
+    },
+    {
+      "description": "Attach and manage access policies for documents.",
+      "name": "Policies"
+    },
+    {
+      "description": "Generate shareable entry pages for documents.",
+      "name": "Entry Pages"
+    }
+  ]
+}