{
  "openapi": "3.1.0",
  "info": {
    "title": "PDFHQ",
    "version": "0.1.0"
  },
  "paths": {
    "/v1/internal/account-erasure": {
      "post": {
        "tags": ["account-lifecycle"],
        "summary": "Receive Account Erasure",
        "operationId": "account-lifecycle-receive_account_erasure",
        "parameters": [
          {
            "name": "authorization",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Idempotency-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountErasureIn"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Account-Lifecycle-Receive Account Erasure"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/user/me": {
      "get": {
        "tags": ["product-user-projection"],
        "summary": "Read Current Product Projection",
        "description": "Return cached display fields; HQTools remains authoritative for them.",
        "operationId": "product-user-projection-read_current_product_projection",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/blog/posts": {
      "get": {
        "tags": ["blog"],
        "summary": "Read Blog Posts",
        "operationId": "blog-read_blog_posts",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 10,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0,
              "title": "Offset"
            }
          },
          {
            "name": "author_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Author Id"
            }
          },
          {
            "name": "category_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Category Id"
            }
          },
          {
            "name": "tag_ids",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "format": "uuid"
                  }
                },
                {
                  "type": "null"
                }
              ],
              "title": "Tag Ids"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/BlogPostStatus"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Status"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Q"
            }
          },
          {
            "name": "is_featured",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Is Featured"
            }
          },
          {
            "name": "popularity_min",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "title": "Popularity Min"
            }
          },
          {
            "name": "popularity_max",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "title": "Popularity Max"
            }
          },
          {
            "name": "sort_by",
            "in": "query",
            "required": false,
            "schema": {
              "enum": [
                "published_at",
                "created_at",
                "updated_at",
                "popularity_score"
              ],
              "type": "string",
              "default": "published_at",
              "title": "Sort By"
            }
          },
          {
            "name": "sort_dir",
            "in": "query",
            "required": false,
            "schema": {
              "enum": ["asc", "desc"],
              "type": "string",
              "default": "desc",
              "title": "Sort Dir"
            }
          },
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Locale"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogPostsPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/blog/posts/{slug}": {
      "get": {
        "tags": ["blog"],
        "summary": "Read Blog Post",
        "operationId": "blog-read_blog_post",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Slug"
            }
          },
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Locale"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogPostPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/blog/posts/{post_id}/like": {
      "post": {
        "tags": ["blog"],
        "summary": "Like Blog Post",
        "operationId": "blog-like_blog_post",
        "parameters": [
          {
            "name": "post_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Post Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogPostPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/blog/posts/{post_id}/unlike": {
      "post": {
        "tags": ["blog"],
        "summary": "Unlike Blog Post",
        "operationId": "blog-unlike_blog_post",
        "parameters": [
          {
            "name": "post_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Post Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogPostPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/blog/categories": {
      "get": {
        "tags": ["blog"],
        "summary": "Read Blog Categories",
        "operationId": "blog-read_blog_categories",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 200,
              "minimum": 1,
              "default": 50,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0,
              "title": "Offset"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Q"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BlogCategoryPublic"
                  },
                  "title": "Response Blog-Read Blog Categories"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/blog/tags": {
      "get": {
        "tags": ["blog"],
        "summary": "Read Blog Tags",
        "operationId": "blog-read_blog_tags",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 200,
              "minimum": 1,
              "default": 50,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0,
              "title": "Offset"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Q"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BlogTagPublic"
                  },
                  "title": "Response Blog-Read Blog Tags"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/blog/posts": {
      "get": {
        "tags": ["blog-admin"],
        "summary": "Read Blog Posts",
        "operationId": "blog-admin-read_blog_posts",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 200,
              "minimum": 1,
              "default": 20,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0,
              "title": "Offset"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/BlogPostStatus"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Status"
            }
          },
          {
            "name": "author_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Author Id"
            }
          },
          {
            "name": "category_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Category Id"
            }
          },
          {
            "name": "tag_ids",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "format": "uuid"
                  }
                },
                {
                  "type": "null"
                }
              ],
              "title": "Tag Ids"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Q"
            }
          },
          {
            "name": "is_featured",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Is Featured"
            }
          },
          {
            "name": "popularity_min",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "title": "Popularity Min"
            }
          },
          {
            "name": "popularity_max",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "title": "Popularity Max"
            }
          },
          {
            "name": "sort_by",
            "in": "query",
            "required": false,
            "schema": {
              "enum": [
                "published_at",
                "created_at",
                "updated_at",
                "popularity_score"
              ],
              "type": "string",
              "default": "created_at",
              "title": "Sort By"
            }
          },
          {
            "name": "sort_dir",
            "in": "query",
            "required": false,
            "schema": {
              "enum": ["asc", "desc"],
              "type": "string",
              "default": "desc",
              "title": "Sort Dir"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogPostsPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": ["blog-admin"],
        "summary": "Create Blog Post",
        "operationId": "blog-admin-create_blog_post",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BlogPostCreate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogPostPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/blog/posts/{post_id}": {
      "get": {
        "tags": ["blog-admin"],
        "summary": "Read Blog Post",
        "operationId": "blog-admin-read_blog_post",
        "parameters": [
          {
            "name": "post_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Post Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogPostPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "patch": {
        "tags": ["blog-admin"],
        "summary": "Update Blog Post",
        "operationId": "blog-admin-update_blog_post",
        "parameters": [
          {
            "name": "post_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Post Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BlogPostUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogPostPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": ["blog-admin"],
        "summary": "Delete Blog Post",
        "operationId": "blog-admin-delete_blog_post",
        "parameters": [
          {
            "name": "post_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Post Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "boolean"
                  },
                  "title": "Response Blog-Admin-Delete Blog Post"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/blog/categories": {
      "get": {
        "tags": ["blog-admin"],
        "summary": "Read Blog Categories",
        "operationId": "blog-admin-read_blog_categories",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 200,
              "minimum": 1,
              "default": 50,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0,
              "title": "Offset"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Q"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BlogCategoryPublic"
                  },
                  "title": "Response Blog-Admin-Read Blog Categories"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": ["blog-admin"],
        "summary": "Create Blog Category",
        "operationId": "blog-admin-create_blog_category",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BlogCategoryCreate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogCategoryPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/blog/categories/{category_id}": {
      "patch": {
        "tags": ["blog-admin"],
        "summary": "Update Blog Category",
        "operationId": "blog-admin-update_blog_category",
        "parameters": [
          {
            "name": "category_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Category Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BlogCategoryUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogCategoryPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": ["blog-admin"],
        "summary": "Delete Blog Category",
        "operationId": "blog-admin-delete_blog_category",
        "parameters": [
          {
            "name": "category_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Category Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "boolean"
                  },
                  "title": "Response Blog-Admin-Delete Blog Category"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/blog/tags": {
      "get": {
        "tags": ["blog-admin"],
        "summary": "Read Blog Tags",
        "operationId": "blog-admin-read_blog_tags",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 200,
              "minimum": 1,
              "default": 50,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0,
              "title": "Offset"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Q"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BlogTagPublic"
                  },
                  "title": "Response Blog-Admin-Read Blog Tags"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": ["blog-admin"],
        "summary": "Create Blog Tag",
        "operationId": "blog-admin-create_blog_tag",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BlogTagCreate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogTagPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/blog/tags/{tag_id}": {
      "patch": {
        "tags": ["blog-admin"],
        "summary": "Update Blog Tag",
        "operationId": "blog-admin-update_blog_tag",
        "parameters": [
          {
            "name": "tag_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Tag Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BlogTagUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogTagPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": ["blog-admin"],
        "summary": "Delete Blog Tag",
        "operationId": "blog-admin-delete_blog_tag",
        "parameters": [
          {
            "name": "tag_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Tag Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "boolean"
                  },
                  "title": "Response Blog-Admin-Delete Blog Tag"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/blogs": {
      "get": {
        "tags": ["blog-translations-admin"],
        "summary": "List Blogs",
        "operationId": "blog-translations-admin-list_blogs",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogAdminList"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": ["blog-translations-admin"],
        "summary": "Create Blog",
        "operationId": "blog-translations-admin-create_blog",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BlogCreatePayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogTranslationPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/blogs/{blog_id}/translations/status": {
      "get": {
        "tags": ["blog-translations-admin"],
        "summary": "Read Translation Status",
        "operationId": "blog-translations-admin-read_translation_status",
        "parameters": [
          {
            "name": "blog_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Blog Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogTranslationStatusResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/blogs/{blog_id}/translations/{locale}": {
      "get": {
        "tags": ["blog-translations-admin"],
        "summary": "Read Translation",
        "operationId": "blog-translations-admin-read_translation",
        "parameters": [
          {
            "name": "blog_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Blog Id"
            }
          },
          {
            "name": "locale",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Locale"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogTranslationPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": ["blog-translations-admin"],
        "summary": "Upsert Translation",
        "operationId": "blog-translations-admin-upsert_translation",
        "parameters": [
          {
            "name": "blog_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Blog Id"
            }
          },
          {
            "name": "locale",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Locale"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BlogTranslationPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogTranslationPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/blogs/{blog_id}/translations/{locale}/clone": {
      "post": {
        "tags": ["blog-translations-admin"],
        "summary": "Clone Translation",
        "operationId": "blog-translations-admin-clone_translation",
        "parameters": [
          {
            "name": "blog_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Blog Id"
            }
          },
          {
            "name": "locale",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Locale"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BlogTranslationPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/media/presign": {
      "post": {
        "tags": ["media-admin"],
        "summary": "Create Presigned Upload",
        "operationId": "media-admin-create_presigned_upload",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MediaPresignRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MediaPresignResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/media/upload": {
      "post": {
        "tags": ["media-admin"],
        "summary": "Upload Media",
        "operationId": "media-admin-upload_media",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_media-admin-upload_media"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MediaUploadResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/media": {
      "get": {
        "tags": ["media-admin"],
        "summary": "List Media",
        "operationId": "media-admin-list_media",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 200,
              "minimum": 1,
              "default": 40,
              "title": "Limit"
            }
          },
          {
            "name": "continuation_token",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Continuation Token"
            }
          },
          {
            "name": "folder",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Folder"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MediaListResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/locales": {
      "get": {
        "tags": ["locales"],
        "summary": "List Enabled Locales",
        "operationId": "locales-list_enabled_locales",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalesPublic"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/locales": {
      "get": {
        "tags": ["locales"],
        "summary": "List Locale Statuses",
        "operationId": "locales-list_locale_statuses",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LocaleStatusPublic"
                  },
                  "title": "Response Locales-List Locale Statuses"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/locales/status": {
      "get": {
        "tags": ["locales"],
        "summary": "Read Locale Readiness",
        "operationId": "locales-read_locale_readiness",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LocaleReadinessPublic"
                  },
                  "title": "Response Locales-Read Locale Readiness"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/locales/validate": {
      "post": {
        "tags": ["locales"],
        "summary": "Validate All Locales",
        "operationId": "locales-validate_all_locales",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LocaleReadinessPublic"
                  },
                  "title": "Response Locales-Validate All Locales"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/locales/{locale}": {
      "put": {
        "tags": ["locales"],
        "summary": "Update Locale Status",
        "operationId": "locales-update_locale_status",
        "parameters": [
          {
            "name": "locale",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Locale"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LocaleStatusUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocaleStatusPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/knowledge": {
      "get": {
        "tags": ["knowledge"],
        "summary": "Read Knowledge Hub",
        "operationId": "knowledge-read_knowledge_hub",
        "parameters": [
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Locale"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeHubPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/knowledge/formats": {
      "get": {
        "tags": ["knowledge"],
        "summary": "Read Format Entries",
        "operationId": "knowledge-read_format_entries",
        "parameters": [
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Locale"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Q"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 200,
              "minimum": 1,
              "default": 24,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0,
              "title": "Offset"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeEntriesPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/knowledge/glossary": {
      "get": {
        "tags": ["knowledge"],
        "summary": "Read Glossary Entries",
        "operationId": "knowledge-read_glossary_entries",
        "parameters": [
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Locale"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Q"
            }
          },
          {
            "name": "starts_with",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Starts With"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 200,
              "minimum": 1,
              "default": 24,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0,
              "title": "Offset"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeEntriesPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/knowledge/formats/{slug}": {
      "get": {
        "tags": ["knowledge"],
        "summary": "Read Format Entry Detail",
        "operationId": "knowledge-read_format_entry_detail",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Slug"
            }
          },
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Locale"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeEntryDetailPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/knowledge/glossary/{slug}": {
      "get": {
        "tags": ["knowledge"],
        "summary": "Read Glossary Entry Detail",
        "operationId": "knowledge-read_glossary_entry_detail",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Slug"
            }
          },
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Locale"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeEntryDetailPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/knowledge": {
      "get": {
        "tags": ["knowledge-admin"],
        "summary": "List Knowledge Entries",
        "operationId": "knowledge-admin-list_knowledge_entries",
        "parameters": [
          {
            "name": "entry_type",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Entry Type"
            }
          },
          {
            "name": "locale_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Locale Id"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Status"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Q"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 200,
              "minimum": 1,
              "default": 50,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0,
              "title": "Offset"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeAdminEntryList"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": ["knowledge-admin"],
        "summary": "Create Knowledge Entry",
        "operationId": "knowledge-admin-create_knowledge_entry",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/KnowledgeAdminEntryWrite"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeAdminEntryPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/knowledge/options": {
      "get": {
        "tags": ["knowledge-admin"],
        "summary": "Get Knowledge Admin Options",
        "operationId": "knowledge-admin-get_knowledge_admin_options",
        "parameters": [
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "en",
              "title": "Locale"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeAdminOptions"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/knowledge/{entry_id}": {
      "put": {
        "tags": ["knowledge-admin"],
        "summary": "Update Knowledge Entry",
        "operationId": "knowledge-admin-update_knowledge_entry",
        "parameters": [
          {
            "name": "entry_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Entry Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/KnowledgeAdminEntryWrite"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeAdminEntryPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": ["knowledge-admin"],
        "summary": "Read Knowledge Entry",
        "operationId": "knowledge-admin-read_knowledge_entry",
        "parameters": [
          {
            "name": "entry_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Entry Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeAdminEntryPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": ["knowledge-admin"],
        "summary": "Delete Knowledge Entry",
        "operationId": "knowledge-admin-delete_knowledge_entry",
        "parameters": [
          {
            "name": "entry_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Entry Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "boolean"
                  },
                  "title": "Response Knowledge-Admin-Delete Knowledge Entry"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/knowledge/seo-health": {
      "get": {
        "tags": ["knowledge-admin"],
        "summary": "Knowledge Seo Health Report",
        "operationId": "knowledge-admin-knowledge_seo_health_report",
        "parameters": [
          {
            "name": "include_drafts",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false,
              "title": "Include Drafts"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 1000,
              "minimum": 1,
              "default": 200,
              "title": "Limit"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeSeoHealthReport"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/knowledge/{entry_id}/graph-suggestions": {
      "get": {
        "tags": ["knowledge-admin"],
        "summary": "Get Knowledge Graph Suggestions",
        "operationId": "knowledge-admin-get_knowledge_graph_suggestions",
        "parameters": [
          {
            "name": "entry_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Entry Id"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 30,
              "minimum": 1,
              "default": 8,
              "title": "Limit"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeGraphSuggestionsPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/email-templates/locales": {
      "get": {
        "tags": ["admin"],
        "summary": "Read Locales",
        "operationId": "admin-read_locales",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalesResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/email-templates/{locale}": {
      "get": {
        "tags": ["admin"],
        "summary": "Read Templates",
        "operationId": "admin-read_templates",
        "parameters": [
          {
            "name": "locale",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Locale"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TemplatesListResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/email-templates/{locale}/{template}": {
      "get": {
        "tags": ["admin"],
        "summary": "Read Template",
        "operationId": "admin-read_template",
        "parameters": [
          {
            "name": "locale",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Locale"
            }
          },
          {
            "name": "template",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Template"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TemplateDetailResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": ["admin"],
        "summary": "Update Template",
        "operationId": "admin-update_template",
        "parameters": [
          {
            "name": "locale",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Locale"
            }
          },
          {
            "name": "template",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Template"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TemplateUpdatePayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TemplateDetailResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/utils/test-email/": {
      "post": {
        "tags": ["utils"],
        "summary": "Test Email",
        "description": "Test emails.",
        "operationId": "utils-test_email",
        "parameters": [
          {
            "name": "email_to",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "email",
              "title": "Email To"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/utils/health-check/": {
      "get": {
        "tags": ["utils"],
        "summary": "Health Check",
        "operationId": "utils-health_check",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "boolean",
                  "title": "Response Utils-Health Check"
                }
              }
            }
          }
        }
      }
    },
    "/v1/utils/readiness": {
      "get": {
        "tags": ["utils"],
        "summary": "Readiness",
        "operationId": "utils-readiness",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object",
                  "title": "Response Utils-Readiness"
                }
              }
            }
          }
        }
      }
    },
    "/v1/tools": {
      "get": {
        "tags": ["tools"],
        "summary": "Read Tools",
        "operationId": "tools-read_tools",
        "parameters": [
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Locale"
            }
          },
          {
            "name": "include_hidden",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false,
              "title": "Include Hidden"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolListPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/tools/{slug}": {
      "get": {
        "tags": ["tools"],
        "summary": "Read Tool Detail",
        "operationId": "tools-read_tool_detail",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Slug"
            }
          },
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Locale"
            }
          },
          {
            "name": "include_hidden",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false,
              "title": "Include Hidden"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolDetailPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/convert/{slug}": {
      "post": {
        "tags": ["convert-generic"],
        "summary": "Submit Generic Conversion",
        "operationId": "convert-generic-submit_generic_conversion",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Slug"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_convert-generic-submit_generic_conversion"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConvertSubmitPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/jobs/{job_id}": {
      "get": {
        "tags": ["convert-generic"],
        "summary": "Read Generic Job",
        "operationId": "convert-generic-read_generic_job",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Job Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConvertJobPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/jobs/{job_id}/download": {
      "get": {
        "tags": ["convert-generic"],
        "summary": "Download Generic Job",
        "operationId": "convert-generic-download_generic_job",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Job Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/merge": {
      "post": {
        "tags": ["merge"],
        "summary": "Merge Pdfs",
        "operationId": "merge-merge_pdfs",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_merge-merge_pdfs"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/bank-statement-to-excel": {
      "post": {
        "tags": ["bank-statement-to-excel"],
        "summary": "Pdf To Docx",
        "operationId": "bank-statement-to-excel-pdf_to_docx",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_bank-statement-to-excel-pdf_to_docx"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/pdf-to-word": {
      "post": {
        "tags": ["pdf-to-word", "word-to-pdf"],
        "summary": "Pdf To Docx",
        "operationId": "pdf-to-word-pdf_to_docx",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_pdf-to-word-pdf_to_docx"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/word-to-pdf": {
      "post": {
        "tags": ["pdf-to-word", "word-to-pdf"],
        "summary": "Word To Pdf",
        "operationId": "pdf-to-word-word_to_pdf",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_pdf-to-word-word_to_pdf"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/pdf-to-excel": {
      "post": {
        "tags": ["pdf-to-excel"],
        "summary": "Pdf To Docx",
        "operationId": "pdf-to-excel-pdf_to_docx",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_pdf-to-excel-pdf_to_docx"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/excel-to-pdf": {
      "post": {
        "tags": ["pdf-to-excel"],
        "summary": "Excel To Pdf",
        "operationId": "pdf-to-excel-excel_to_pdf",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_pdf-to-excel-excel_to_pdf"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/image-to-pdf": {
      "post": {
        "tags": ["image-to-pdf", "pdf-to-image"],
        "summary": "Image To Pdf",
        "operationId": "image-to-pdf-image_to_pdf",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_image-to-pdf-image_to_pdf"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/pdf-to-image": {
      "post": {
        "tags": ["image-to-pdf", "pdf-to-image"],
        "summary": "Pdf To Image",
        "operationId": "image-to-pdf-pdf_to_image",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_image-to-pdf-pdf_to_image"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/pdf-to-text": {
      "post": {
        "tags": ["pdf-to-text"],
        "summary": "Pdf To Text",
        "operationId": "pdf-to-text-pdf_to_text",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_pdf-to-text-pdf_to_text"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/extract-images-from-pdf": {
      "post": {
        "tags": ["extract-images-from-pdf"],
        "summary": "Extract Images From Pdf",
        "operationId": "extract-images-from-pdf-extract_images_from_pdf",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_extract-images-from-pdf-extract_images_from_pdf"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/repair-pdf": {
      "post": {
        "tags": ["repair-pdf"],
        "summary": "Repair Pdf",
        "operationId": "repair-pdf-repair_pdf",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_repair-pdf-repair_pdf"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/resize-pdf": {
      "post": {
        "tags": ["resize-pdf"],
        "summary": "Resize Pdf",
        "operationId": "resize-pdf-resize_pdf",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_resize-pdf-resize_pdf"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/pdf-to-pdfa": {
      "post": {
        "tags": ["pdf-to-pdfa"],
        "summary": "Pdf To Pdfa",
        "operationId": "pdf-to-pdfa-pdf_to_pdfa",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_pdf-to-pdfa-pdf_to_pdfa"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/html-to-pdf/previews": {
      "post": {
        "tags": ["html-to-pdf"],
        "summary": "Html To Pdf Previews",
        "operationId": "html-to-pdf-html_to_pdf_previews",
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/Body_html-to-pdf-html_to_pdf_previews"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/html-to-pdf": {
      "post": {
        "tags": ["html-to-pdf"],
        "summary": "Html To Pdf",
        "operationId": "html-to-pdf-html_to_pdf",
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/Body_html-to-pdf-html_to_pdf"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/split": {
      "post": {
        "tags": ["split"],
        "summary": "Split Pdf",
        "operationId": "split-split_pdf",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_split-split_pdf"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/compress": {
      "post": {
        "tags": ["compress"],
        "summary": "Compress Pdf",
        "operationId": "compress-compress_pdf",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_compress-compress_pdf"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/rotate": {
      "post": {
        "tags": ["rotate"],
        "summary": "Rotate Pdfs",
        "operationId": "rotate-rotate_pdfs",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_rotate-rotate_pdfs"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/remove-pages": {
      "post": {
        "tags": ["remove-pages"],
        "summary": "Remove Pages",
        "operationId": "remove-pages-remove_pages",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_remove-pages-remove_pages"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/extract-pages": {
      "post": {
        "tags": ["extract-pages"],
        "summary": "Extract Pages",
        "operationId": "extract-pages-extract_pages",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_extract-pages-extract_pages"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/add-page-numbers-to-pdf": {
      "post": {
        "tags": ["edit"],
        "summary": "Add Page Numbers To Pdf",
        "operationId": "edit-add_page_numbers_to_pdf",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_edit-add_page_numbers_to_pdf"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/watermark-pdf": {
      "post": {
        "tags": ["edit"],
        "summary": "Watermark Pdf",
        "operationId": "edit-watermark_pdf",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_edit-watermark_pdf"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/documents/uploads": {
      "post": {
        "tags": ["document-jobs"],
        "summary": "Create a direct PDF upload",
        "description": "Create an account- and API-key-scoped upload ticket. POST the exact file to the returned S3 URL and fields without proxying PDF bytes through the API server.",
        "operationId": "document-jobs-start_document_upload",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StartUpload"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SignedUploadResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/documents/uploads/{upload_id}/complete": {
      "post": {
        "tags": ["document-jobs"],
        "summary": "Verify and seal uploaded PDF",
        "description": "Verify uploaded object size and metadata, then copy it to a sealed, worker-only S3 key. Completion is idempotent.",
        "operationId": "document-jobs-complete_document_upload",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "upload_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Upload Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompletedUploadResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/document-jobs": {
      "get": {
        "tags": ["document-jobs"],
        "summary": "List recent account- and API-key-scoped document jobs",
        "description": "Bounded private polling for developer automation.\n\nIncludes direct document-jobs and task-backed jobs. Returns no document\ncontent, S3 paths, reservation secrets or signed output URLs. Polling is\na snapshot, not a durable completion notification; use future outbox webhooks\nfor guaranteed high-throughput delivery.",
        "operationId": "document-jobs-list_document_jobs",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 25,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 0,
              "title": "Offset"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Document-Jobs-List Document Jobs"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": ["document-jobs"],
        "summary": "Process uploaded PDFs asynchronously",
        "description": "Create a metered document job. Requires Idempotency-Key, active PDFHQ entitlements and completed document uploads. Jobs can be polled through GET /v1/jobs/{job_id}.",
        "operationId": "document-jobs-create_document_job",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Idempotency-Key"
            }
          },
          {
            "name": "X-Max-HQ-Credits",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "number",
                  "minimum": 0.0
                },
                {
                  "type": "string",
                  "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Max-Hq-Credits"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SubmitJob"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DocumentJobResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/documents/uploads/{upload_id}/evidence": {
      "get": {
        "tags": ["document-jobs"],
        "summary": "Extract page-cited text from a verified PDF (limited preview)",
        "operationId": "document-jobs-document_text_evidence",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "upload_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Upload Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Document-Jobs-Document Text Evidence"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/documents/uploads/{upload_id}/form-fields": {
      "get": {
        "tags": ["document-jobs"],
        "summary": "Discover supported AcroForm field names, types and page numbers",
        "description": "Tenant-scoped inspection to prepare fill_form tasks without guessing IDs.\n\nReturns field metadata, NOT private field values. Per-request HQTools API\nquota is consumed before storage download or PDF parsing.",
        "operationId": "document-jobs-uploaded_pdf_form_fields",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "upload_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Upload Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Document-Jobs-Uploaded Pdf Form Fields"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/documents/uploads/{upload_id}": {
      "get": {
        "tags": ["document-jobs"],
        "summary": "Inspect an uploaded document",
        "operationId": "document-jobs-get_document_upload",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "upload_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Upload Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadDetailsResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": ["document-jobs"],
        "summary": "Delete an unused uploaded document",
        "operationId": "document-jobs-delete_document_upload",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "upload_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Upload Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/document-jobs/{job_id}/download-url": {
      "get": {
        "tags": ["document-jobs"],
        "summary": "Get a temporary direct download URL",
        "operationId": "document-jobs-document_job_download_url",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Job Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SignedDownloadResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/tasks": {
      "post": {
        "tags": ["document-tasks"],
        "summary": "Start a document task",
        "operationId": "document-tasks-start_task",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Idempotency-Key"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TaskStart"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": ["document-tasks"],
        "summary": "List your document tasks",
        "operationId": "document-tasks-list_tasks",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 20,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 0,
              "title": "Offset"
            }
          },
          {
            "name": "tool",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Tool"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskList"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/tasks/{task_id}/uploads": {
      "post": {
        "tags": ["document-tasks"],
        "summary": "Create an upload ticket for a task",
        "description": "Task-scoped convenience entry point; retains the signed S3 policy contract.",
        "operationId": "document-tasks-start_task_upload",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Task Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StartUpload"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SignedUploadResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/tasks/{task_id}/uploads/{upload_id}/complete": {
      "post": {
        "tags": ["document-tasks"],
        "summary": "Seal an uploaded PDF and attach it to the task",
        "operationId": "document-tasks-complete_task_upload",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Task Id"
            }
          },
          {
            "name": "upload_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Upload Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/tasks/{task_id}/files": {
      "post": {
        "tags": ["document-tasks"],
        "summary": "Attach a verified upload to a waiting task",
        "operationId": "document-tasks-attach_task_file",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Task Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TaskAttach"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/tasks/{task_id}/quote": {
      "get": {
        "tags": ["document-tasks"],
        "summary": "Estimate HQ Credits for a waiting task from verified uploads",
        "operationId": "document-tasks-task_credit_quote",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Task Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Document-Tasks-Task Credit Quote"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/tasks/{task_id}/process": {
      "post": {
        "tags": ["document-tasks"],
        "summary": "Queue and meter a document task",
        "operationId": "document-tasks-process_task",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Task Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TaskProcess"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/tasks/{task_id}": {
      "get": {
        "tags": ["document-tasks"],
        "summary": "Retrieve task status",
        "operationId": "document-tasks-get_task",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Task Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": ["document-tasks"],
        "summary": "Discard a waiting task",
        "operationId": "document-tasks-discard_task",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Task Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/tasks/{task_id}/download-url": {
      "get": {
        "tags": ["document-tasks"],
        "summary": "Get a task's private output download URL",
        "operationId": "document-tasks-task_download",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Task Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Document-Tasks-Task Download"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspace/documents": {
      "post": {
        "tags": ["workspace"],
        "summary": "Register Document",
        "operationId": "workspace-register_document",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterDocument"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkspaceDocumentPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": ["workspace"],
        "summary": "List Documents",
        "operationId": "workspace-list_documents",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 50,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 0,
              "title": "Offset"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkspaceDocumentList"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspace/documents/{document_id}": {
      "get": {
        "tags": ["workspace"],
        "summary": "Get Document",
        "operationId": "workspace-get_document",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Document Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkspaceDocumentPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "patch": {
        "tags": ["workspace"],
        "summary": "Update Document",
        "operationId": "workspace-update_document",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Document Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateDocument"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkspaceDocumentPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": ["workspace"],
        "summary": "Remove Document",
        "operationId": "workspace-remove_document",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Document Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspace/documents/{document_id}/handoff/task": {
      "post": {
        "tags": ["workspace"],
        "summary": "Handoff To Task",
        "description": "Attach existing sealed upload through the normal task access and state checks.\n\nDoes not copy bytes, bypass the task admission limits, or trigger billing.",
        "operationId": "workspace-handoff_to_task",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Document Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TaskHandoff"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Workspace-Handoff To Task"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspace/documents/{document_id}/handoff": {
      "get": {
        "tags": ["workspace"],
        "summary": "Handoff Options",
        "description": "Return a scoped reference for UI routing, not a public download URL.\n\nAI and signing have independent admission flows and must not accept this\nreference as proof of authorization or bypass their upload validation.",
        "operationId": "workspace-handoff_options",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Document Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Workspace-Handoff Options"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspace/documents/{document_id}/handoff/ai": {
      "post": {
        "tags": ["workspace"],
        "summary": "Handoff To Ai",
        "description": "Reuse AI's quoted, consent-gated admission, idempotency and dual-credit settlement.",
        "operationId": "workspace-handoff_to_ai",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Document Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AIHandoff"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Workspace-Handoff To Ai"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspace/documents/{document_id}/handoff/signing": {
      "post": {
        "tags": ["workspace"],
        "summary": "Handoff To Signing",
        "description": "Create a draft using the existing signing provider and ownership checks.",
        "operationId": "workspace-handoff_to_signing",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Document Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SigningHandoff"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Workspace-Handoff To Signing"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspace/documents/{document_id}/preview-url": {
      "get": {
        "tags": ["workspace"],
        "summary": "Preview Document Url",
        "description": "Issue a short-lived owned S3 preview, capped by source/library expiry.\n\nPDF bytes travel directly from storage to the authorized browser. This URL\nis a temporary bearer capability and must never be logged or cached.",
        "operationId": "workspace-preview_document_url",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Document Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkspacePreviewURL"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspace/documents/{document_id}/preview": {
      "get": {
        "tags": ["workspace"],
        "summary": "Preview Document",
        "description": "Compatibility preview for small PDFs; use preview-url for direct S3 delivery.",
        "operationId": "workspace-preview_document",
        "deprecated": true,
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Document Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspace/documents/{document_id}/activity": {
      "get": {
        "tags": ["workspace"],
        "summary": "Document Activity",
        "operationId": "workspace-document_activity",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Document Id"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 50,
              "title": "Limit"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkspaceActivityList"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspace/documents/{document_id}/retention": {
      "put": {
        "tags": ["workspace"],
        "summary": "Set Retention",
        "operationId": "workspace-set_retention",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "document_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Document Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RetentionUpdate"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkspaceDocumentPublic"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/providers": {
      "get": {
        "tags": ["esign"],
        "summary": "List eSignature providers and their actual availability",
        "operationId": "esign-list_providers",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object",
                  "title": "Response Esign-List Providers"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/v1/esign/envelopes": {
      "post": {
        "tags": ["esign"],
        "summary": "Create an eSignature request draft",
        "operationId": "esign-create_envelope",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnvelopeCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeRead"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": ["esign"],
        "summary": "List your own signature requests",
        "operationId": "esign-list_envelopes",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 25,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 0,
              "title": "Offset"
            }
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "State"
            }
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 365,
              "title": "Days"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeList"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/reports/summary": {
      "get": {
        "tags": ["esign"],
        "summary": "Private sandbox signature-request activity summary",
        "operationId": "esign-envelope_summary",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "days",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 30,
              "title": "Days"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Esign-Envelope Summary"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/reports/export.csv": {
      "get": {
        "tags": ["esign"],
        "summary": "Export private signature request operational metadata as CSV",
        "operationId": "esign-envelope_report_csv",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "days",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 30,
              "title": "Days"
            }
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "State"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/envelopes/{envelope_id}": {
      "get": {
        "tags": ["esign"],
        "summary": "Get signature request status",
        "operationId": "esign-get_envelope",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "envelope_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Envelope Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeRead"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "patch": {
        "tags": ["esign"],
        "summary": "Edit an unsent signature draft using an exact draft version",
        "operationId": "esign-update_envelope",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "envelope_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Envelope Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnvelopePatch"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeRead"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": ["esign"],
        "summary": "Discard an unsent draft without contacting provider",
        "operationId": "esign-delete_draft",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "envelope_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Envelope Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/envelopes/{envelope_id}/validate": {
      "post": {
        "tags": ["esign"],
        "summary": "Validate draft field layout against sealed source PDF",
        "operationId": "esign-validate_envelope",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "envelope_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Envelope Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Esign-Validate Envelope"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/envelopes/{envelope_id}/send": {
      "post": {
        "tags": ["esign"],
        "summary": "Send an explicitly approved sandbox signature request",
        "operationId": "esign-dispatch_envelope",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "envelope_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Envelope Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnvelopeSend"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeRead"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/envelopes/{envelope_id}/void": {
      "post": {
        "tags": ["esign"],
        "summary": "Queue a sandbox signing-request cancellation; verify final state separately",
        "operationId": "esign-void_envelope",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "envelope_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Envelope Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnvelopeVoid"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeRead"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/envelopes/{envelope_id}/remind": {
      "post": {
        "tags": ["esign"],
        "summary": "Send one sandbox signer reminder per 24 hours, without retries",
        "operationId": "esign-remind_envelope",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "envelope_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Envelope Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EnvelopeReminder"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReminderRead"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/envelopes/{envelope_id}/reminders": {
      "get": {
        "tags": ["esign"],
        "summary": "List private reminder attempt receipts without signer email addresses",
        "operationId": "esign-list_reminders",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "envelope_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Envelope Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ReminderRead"
                  },
                  "title": "Response Esign-List Reminders"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/envelopes/{envelope_id}/sync": {
      "post": {
        "tags": ["esign"],
        "summary": "Refresh a sandbox request from the signing provider without resending",
        "operationId": "esign-sync_envelope",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "envelope_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Envelope Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeRead"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/envelopes/{envelope_id}/archive": {
      "post": {
        "tags": ["esign"],
        "summary": "Save a provider-completed signed PDF to private storage",
        "operationId": "esign-archive_envelope",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "envelope_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Envelope Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnvelopeRead"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/envelopes/{envelope_id}/download-url": {
      "get": {
        "tags": ["esign"],
        "summary": "Issue short-lived private signed-document download URL",
        "operationId": "esign-envelope_download_url",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "envelope_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Envelope Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/envelopes/{envelope_id}/timeline": {
      "get": {
        "tags": ["esign"],
        "summary": "Read a privacy-safe signature request activity timeline",
        "operationId": "esign-envelope_timeline",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "envelope_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Envelope Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Esign-Envelope Timeline"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/envelopes/{envelope_id}/audit": {
      "get": {
        "tags": ["esign"],
        "summary": "Read account-scoped eSignature integrity and event receipt",
        "description": "Operational provenance receipt, NOT a provider signing certificate.\n\nPDFHQ can attest to received HMAC-authenticated callbacks and its archived\nfile digest. Signer identification/legal evidence belongs to the provider.",
        "operationId": "esign-envelope_audit",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "envelope_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Envelope Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Esign-Envelope Audit"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/esign/webhooks/dropbox-sign": {
      "post": {
        "tags": ["esign-provider-callbacks"],
        "summary": "Verify signed Dropbox Sign callbacks",
        "operationId": "esign-provider-callbacks-dropbox_callback",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/webhooks": {
      "post": {
        "tags": ["customer-webhooks"],
        "summary": "Subscribe to project-scoped signed customer events",
        "operationId": "customer-webhooks-create_subscription",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SubscriptionCreate"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubscriptionCreated"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": ["customer-webhooks"],
        "summary": "List only this project's webhook subscriptions",
        "operationId": "customer-webhooks-list_subscriptions",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SubscriptionView"
                  },
                  "title": "Response Customer-Webhooks-List Subscriptions"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/webhooks/{subscription_id}": {
      "delete": {
        "tags": ["customer-webhooks"],
        "summary": "Revoke a project-scoped webhook subscription",
        "operationId": "customer-webhooks-remove_subscription",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "subscription_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Subscription Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/webhooks/{subscription_id}/rotate": {
      "post": {
        "tags": ["customer-webhooks"],
        "summary": "Rotate secret; reveal replacement once",
        "operationId": "customer-webhooks-rotate_subscription",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "subscription_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Subscription Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Customer-Webhooks-Rotate Subscription"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/webhooks/{subscription_id}/test": {
      "post": {
        "tags": ["customer-webhooks"],
        "summary": "Enqueue one synthetic subscription test event",
        "operationId": "customer-webhooks-test_subscription",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "subscription_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Subscription Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Customer-Webhooks-Test Subscription"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/webhooks/deliveries": {
      "get": {
        "tags": ["customer-webhooks"],
        "summary": "Inspect scoped delivery statuses without confidential payloads",
        "operationId": "customer-webhooks-list_deliveries",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "subscription_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Subscription Id"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 50,
              "title": "Limit"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "title": "Response Customer-Webhooks-List Deliveries"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/webhooks/deliveries/{delivery_id}/replay": {
      "post": {
        "tags": ["customer-webhooks"],
        "summary": "Replay dead delivery after correcting receiver",
        "operationId": "customer-webhooks-replay_delivery",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "delivery_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Delivery Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Customer-Webhooks-Replay Delivery"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/task-tools": {
      "get": {
        "tags": ["document-tasks"],
        "summary": "List available PDF task operations and settings",
        "operationId": "document-tasks-list_task_tools",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/TaskTool"
                  },
                  "type": "array",
                  "title": "Response Document-Tasks-List Task Tools"
                }
              }
            }
          }
        }
      }
    },
    "/v1/task-tools/{tool}": {
      "get": {
        "tags": ["document-tasks"],
        "summary": "Describe a task operation and its accepted options",
        "operationId": "document-tasks-get_task_tool",
        "parameters": [
          {
            "name": "tool",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Tool"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskTool"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/credits/balance": {
      "get": {
        "tags": ["ai-billing"],
        "summary": "View your shared HQ-credit wallet",
        "operationId": "ai-billing-ai_balance",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Ai-Billing-Ai Balance"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/credits/prices": {
      "get": {
        "tags": ["ai-billing"],
        "summary": "List active PDFHQ AI prices",
        "operationId": "ai-billing-ai_prices",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Ai-Billing-Ai Prices"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/credits/models": {
      "get": {
        "tags": ["ai-billing"],
        "summary": "Discover curated PDFHQ AI models and priced availability",
        "operationId": "ai-billing-ai_models",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Ai-Billing-Ai Models"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/credits/quotes": {
      "post": {
        "tags": ["ai-billing"],
        "summary": "Quote PDFHQ AI usage in both currencies",
        "operationId": "ai-billing-create_ai_quote",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QuoteRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AIQuoteResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/credits/quotes/{quote_id}": {
      "get": {
        "tags": ["ai-billing"],
        "summary": "Inspect an existing account-owned AI quote",
        "operationId": "ai-billing-get_ai_quote",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "quote_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Quote Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Ai-Billing-Get Ai Quote"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/jobs": {
      "post": {
        "tags": ["ai-document-jobs"],
        "summary": "Start a quoted, dual-credit AI document operation",
        "operationId": "ai-document-jobs-submit_ai_job",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Idempotency-Key"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAIJob"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AIJobResult"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": ["ai-document-jobs"],
        "summary": "List your AI document jobs",
        "operationId": "ai-document-jobs-list_ai_jobs",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 25,
              "title": "Limit"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 0,
              "title": "Offset"
            }
          },
          {
            "name": "operation",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Operation"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Status"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Ai-Document-Jobs-List Ai Jobs"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/jobs/{job_id}/evidence.csv": {
      "get": {
        "tags": ["ai-document-jobs"],
        "summary": "Export the cited source excerpts of an owned AI result for private human review",
        "operationId": "ai-document-jobs-download_ai_evidence_csv",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Job Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/jobs/{job_id}/invoice.xlsx": {
      "get": {
        "tags": ["ai-document-jobs"],
        "summary": "Download an account-scoped, evidence-linked invoice review workbook",
        "operationId": "ai-document-jobs-download_invoice_xlsx",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Job Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/jobs/invoices/batch.xlsx": {
      "post": {
        "tags": ["ai-document-jobs"],
        "summary": "Export up to ten already-completed invoice jobs into one review workbook",
        "operationId": "ai-document-jobs-download_invoice_batch_xlsx",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InvoiceBatchWorkbookRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/jobs/{job_id}/comparison.xlsx": {
      "get": {
        "tags": ["ai-document-jobs"],
        "summary": "Download a source-linked contract change review workbook",
        "operationId": "ai-document-jobs-download_comparison_xlsx",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Job Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/jobs/{job_id}/invoice.csv": {
      "get": {
        "tags": ["ai-document-jobs"],
        "summary": "Export invoice fields for review as a safe CSV",
        "description": "Exposes verified, account-owned invoice output; never a public S3 URL.",
        "operationId": "ai-document-jobs-download_invoice_csv",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Job Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/jobs/{job_id}/invoice-lines.csv": {
      "get": {
        "tags": ["ai-document-jobs"],
        "summary": "Export cited invoice line items for human review",
        "description": "Exposes verified, account-owned invoice output; never a public S3 URL.",
        "operationId": "ai-document-jobs-download_invoice_lines_csv",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Job Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/jobs/{job_id}/comparison.csv": {
      "get": {
        "tags": ["ai-document-jobs"],
        "summary": "Export cited contract changes for human review as a safe CSV",
        "description": "Only the original owner/project may export an unexpired comparison.",
        "operationId": "ai-document-jobs-download_comparison_csv",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Job Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/jobs/usage": {
      "get": {
        "tags": ["ai-document-jobs"],
        "summary": "Account-scoped AI job usage and token counts (no document content)",
        "description": "Usage is informational, NOT a substitute for HQTools billing receipts.\n\nCounts include failed and uncertain requests; no wallet credit quantities are\ncalculated locally because central HQTools is the commercial authority.",
        "operationId": "ai-document-jobs-ai_usage_summary",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "days",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 30,
              "title": "Days"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Ai-Document-Jobs-Ai Usage Summary"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/jobs/{job_id}/conversation": {
      "get": {
        "tags": ["ai-document-jobs"],
        "summary": "Read an owned, unexpired conversation's cited turns",
        "description": "Return private prior Q&A; no historical content is returned after expiry.",
        "operationId": "ai-document-jobs-get_ai_conversation",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Job Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Ai-Document-Jobs-Get Ai Conversation"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/jobs/{job_id}/export.{fmt}": {
      "get": {
        "tags": ["ai-document-jobs"],
        "summary": "Download a private, citation-validated AI review result (JSON, PDF, DOCX or XLSX)",
        "description": "Export an already-paid result. No quote, model inference or new wallet debit.",
        "operationId": "ai-document-jobs-download_ai_result_export",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Job Id"
            }
          },
          {
            "name": "fmt",
            "in": "path",
            "required": true,
            "schema": {
              "enum": ["json", "pdf", "docx", "xlsx"],
              "type": "string",
              "title": "Fmt"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Private review export; media type matches the chosen format."
          },
          "409": {
            "description": "Job not ready, or citations/structured result invalid."
          },
          "410": {
            "description": "Result retention period elapsed."
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/jobs/{job_id}": {
      "get": {
        "tags": ["ai-document-jobs"],
        "summary": "Poll status and cited AI result",
        "operationId": "ai-document-jobs-get_ai_job",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Job Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AIJobResult"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": ["ai-document-jobs"],
        "summary": "Delete a completed AI document result",
        "operationId": "ai-document-jobs-delete_ai_job",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Job Id"
            }
          },
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/edit-plans/preview": {
      "post": {
        "tags": ["ai-page-editing"],
        "summary": "Preview deterministic plain-English PDF page changes without charging credits",
        "operationId": "ai-page-editing-preview_page_edits",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PageEditPreviewRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Ai-Page-Editing-Preview Page Edits"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/ai/edit-plans/from-job": {
      "post": {
        "tags": ["ai-page-editing"],
        "summary": "Revalidate a paid AI page-edit suggestion against its original sealed PDF and issue a user-review token",
        "description": "Neither a model result nor a successful AI quote authorizes PDF edits.\n\nThis second, unmetered stage checks the source revision and output schema\nagain. The user must STILL approve the exact map and buy a document task.",
        "operationId": "ai-page-editing-preview_ai_edit_proposal",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AIEditPreviewRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Ai-Page-Editing-Preview Ai Edit Proposal"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/feedback": {
      "post": {
        "tags": ["feedback"],
        "summary": "Create Feedback",
        "description": "Accept user feedback and forward it to the team inbox via email.\n\nAll fields are required by the schema. Returns a generic success payload\nso we don't leak delivery details to clients.",
        "operationId": "feedback-create_feedback",
        "parameters": [
          {
            "name": "X-CSRF-Token",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Csrf-Token"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FeedbackIn"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Feedback-Create Feedback"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AIEditPreviewRequest": {
        "properties": {
          "job_id": {
            "type": "string",
            "format": "uuid",
            "title": "Job Id"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["job_id"],
        "title": "AIEditPreviewRequest"
      },
      "AIHandoff": {
        "properties": {
          "operation": {
            "type": "string",
            "title": "Operation"
          },
          "quote_id": {
            "type": "string",
            "maxLength": 64,
            "minLength": 1,
            "title": "Quote Id"
          },
          "question": {
            "type": "string",
            "title": "Question",
            "default": ""
          },
          "target_language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Target Language"
          },
          "allow_ocr": {
            "type": "boolean",
            "title": "Allow Ocr",
            "default": false
          },
          "allow_external_ai": {
            "type": "boolean",
            "title": "Allow External Ai",
            "default": false
          },
          "comparison_upload_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comparison Upload Id"
          },
          "additional_upload_ids": {
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "type": "array",
            "maxItems": 3,
            "title": "Additional Upload Ids"
          },
          "comparison_document_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comparison Document Id"
          },
          "additional_document_ids": {
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "type": "array",
            "maxItems": 3,
            "title": "Additional Document Ids"
          }
        },
        "type": "object",
        "required": ["operation", "quote_id"],
        "title": "AIHandoff",
        "description": "Quoted AI request; workspace ID only selects an existing owned upload."
      },
      "AIJobResult": {
        "properties": {
          "job_id": {
            "type": "string",
            "format": "uuid",
            "title": "Job Id"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "operation": {
            "type": "string",
            "title": "Operation"
          },
          "model": {
            "type": "string",
            "title": "Model"
          },
          "source_revision": {
            "type": "string",
            "title": "Source Revision"
          },
          "comparison_revision": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comparison Revision"
          },
          "previous_job_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Previous Job Id"
          },
          "document_count": {
            "type": "integer",
            "title": "Document Count",
            "default": 1
          },
          "error_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error Code"
          },
          "output_ready": {
            "type": "boolean",
            "title": "Output Ready"
          },
          "export_links": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "title": "Export Links",
            "description": "Owned private GET endpoints for already-paid review exports; available only before retention expiry."
          },
          "result": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Result"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          },
          "content_expires_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Expires At"
          },
          "content_purged_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Purged At"
          }
        },
        "type": "object",
        "required": [
          "job_id",
          "status",
          "operation",
          "model",
          "source_revision",
          "output_ready",
          "created_at"
        ],
        "title": "AIJobResult"
      },
      "AIQuoteResponse": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "product": {
            "type": "string",
            "const": "pdfhq",
            "title": "Product"
          },
          "operation": {
            "type": "string",
            "title": "Operation"
          },
          "model": {
            "type": "string",
            "title": "Model"
          },
          "base_hq_credits": {
            "type": "integer",
            "title": "BaseHqCredits"
          },
          "quantity": {
            "type": "integer",
            "title": "Quantity"
          },
          "expires_at": {
            "type": "string",
            "title": "Expires At"
          },
          "status": {
            "type": "string",
            "const": "quote_only",
            "title": "Status",
            "default": "quote_only"
          },
          "note": {
            "type": "string",
            "title": "Note",
            "default": "Informational estimate only. This endpoint does not charge or run AI. An accepted quote is required for AI execution."
          },
          "hq_credits": {
            "type": "integer",
            "title": "HqCredits"
          },
          "max_hq_credits": {
            "type": "integer",
            "title": "MaxHqCredits"
          }
        },
        "type": "object",
        "required": [
          "id",
          "product",
          "operation",
          "model",
          "base_hq_credits",
          "expires_at",
          "hq_credits",
          "max_hq_credits",
          "quantity"
        ],
        "title": "AIQuoteResponse"
      },
      "AccountErasureIn": {
        "properties": {
          "event_id": {
            "type": "string",
            "maxLength": 40,
            "minLength": 1,
            "title": "Event Id"
          },
          "event_type": {
            "type": "string",
            "const": "account.deletion_requested",
            "title": "Event Type"
          },
          "hq_user_id": {
            "type": "string",
            "maxLength": 40,
            "minLength": 1,
            "title": "Hq User Id"
          },
          "hq_account_id": {
            "type": "string",
            "maxLength": 40,
            "minLength": 1,
            "title": "Hq Account Id"
          },
          "product": {
            "type": "string",
            "const": "pdfhq",
            "title": "Product"
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "title": "Occurred At"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "event_id",
          "event_type",
          "hq_user_id",
          "hq_account_id",
          "product",
          "occurred_at"
        ],
        "title": "AccountErasureIn"
      },
      "BlogAdminList": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/BlogAdminSummary"
            },
            "type": "array",
            "title": "Data"
          },
          "count": {
            "type": "integer",
            "title": "Count"
          }
        },
        "type": "object",
        "required": ["data", "count"],
        "title": "BlogAdminList"
      },
      "BlogAdminSummary": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "canonical_slug": {
            "type": "string",
            "title": "Canonical Slug"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Updated At"
          },
          "default_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Default Title"
          },
          "default_status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BlogTranslationStatus"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "id",
          "canonical_slug",
          "created_at",
          "updated_at",
          "default_title",
          "default_status"
        ],
        "title": "BlogAdminSummary"
      },
      "BlogCategoryCreate": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 128,
            "title": "Name"
          },
          "slug": {
            "type": "string",
            "maxLength": 128,
            "title": "Slug"
          },
          "description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 512
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["name", "slug"],
        "title": "BlogCategoryCreate"
      },
      "BlogCategoryPublic": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 128,
            "title": "Name"
          },
          "slug": {
            "type": "string",
            "maxLength": 128,
            "title": "Slug"
          },
          "description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 512
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          }
        },
        "type": "object",
        "required": ["name", "slug", "id"],
        "title": "BlogCategoryPublic"
      },
      "BlogCategoryUpdate": {
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 128
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "slug": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 128
              },
              {
                "type": "null"
              }
            ],
            "title": "Slug"
          },
          "description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 512
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          }
        },
        "type": "object",
        "title": "BlogCategoryUpdate"
      },
      "BlogCreatePayload": {
        "properties": {
          "canonical_slug": {
            "type": "string",
            "maxLength": 255,
            "title": "Canonical Slug"
          },
          "title": {
            "type": "string",
            "maxLength": 255,
            "title": "Title"
          },
          "slug": {
            "type": "string",
            "maxLength": 255,
            "title": "Slug"
          },
          "content": {
            "type": "string",
            "title": "Content"
          },
          "excerpt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt"
          },
          "seo_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Title"
          },
          "seo_description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Description"
          },
          "status": {
            "$ref": "#/components/schemas/BlogTranslationStatus",
            "default": "draft"
          },
          "hero_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Hero Image Url"
          }
        },
        "type": "object",
        "required": ["canonical_slug", "title", "slug", "content"],
        "title": "BlogCreatePayload"
      },
      "BlogPostCreate": {
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 255,
            "title": "Title"
          },
          "slug": {
            "type": "string",
            "maxLength": 255,
            "title": "Slug"
          },
          "excerpt": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 512
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt"
          },
          "content_md": {
            "type": "string",
            "title": "Content Md"
          },
          "article_schema": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Article Schema"
          },
          "faq_schema": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Faq Schema"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Url"
          },
          "is_featured": {
            "type": "boolean",
            "title": "Is Featured",
            "default": false
          },
          "status": {
            "$ref": "#/components/schemas/BlogPostStatus",
            "default": "draft"
          },
          "published_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Published At"
          },
          "seo_title": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 255
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Title"
          },
          "seo_description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 512
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Description"
          },
          "category_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category Id"
          },
          "tag_ids": {
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "type": "array",
            "title": "Tag Ids"
          },
          "author_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Author Id"
          },
          "author_email": {
            "anyOf": [
              {
                "type": "string",
                "format": "email"
              },
              {
                "type": "null"
              }
            ],
            "title": "Author Email"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["title", "slug", "content_md"],
        "title": "BlogPostCreate"
      },
      "BlogPostPublic": {
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 255,
            "title": "Title"
          },
          "slug": {
            "type": "string",
            "maxLength": 255,
            "title": "Slug"
          },
          "excerpt": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 512
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt"
          },
          "content_md": {
            "type": "string",
            "title": "Content Md"
          },
          "article_schema": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Article Schema"
          },
          "faq_schema": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Faq Schema"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Url"
          },
          "is_featured": {
            "type": "boolean",
            "title": "Is Featured",
            "default": false
          },
          "status": {
            "$ref": "#/components/schemas/BlogPostStatus",
            "default": "draft"
          },
          "published_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Published At"
          },
          "seo_title": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 255
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Title"
          },
          "seo_description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 512
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Description"
          },
          "category_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category Id"
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "author_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Author Id"
          },
          "author_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Author Name"
          },
          "views_count": {
            "type": "integer",
            "title": "Views Count",
            "default": 0
          },
          "likes_count": {
            "type": "integer",
            "title": "Likes Count",
            "default": 0
          },
          "popularity_score": {
            "type": "integer",
            "title": "Popularity Score",
            "default": 0
          },
          "liked_by_me": {
            "type": "boolean",
            "title": "Liked By Me",
            "default": false
          },
          "cover_image_thumbnail_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Thumbnail Url"
          },
          "tags": {
            "items": {
              "$ref": "#/components/schemas/BlogTagPublic"
            },
            "type": "array",
            "title": "Tags"
          },
          "category": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BlogCategoryPublic"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": ["title", "slug", "content_md", "id"],
        "title": "BlogPostPublic"
      },
      "BlogPostStatus": {
        "type": "string",
        "enum": ["draft", "published", "archived"],
        "title": "BlogPostStatus"
      },
      "BlogPostUpdate": {
        "properties": {
          "title": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 255
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "slug": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 255
              },
              {
                "type": "null"
              }
            ],
            "title": "Slug"
          },
          "excerpt": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 512
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt"
          },
          "content_md": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Md"
          },
          "article_schema": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Article Schema"
          },
          "faq_schema": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Faq Schema"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Url"
          },
          "is_featured": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is Featured"
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BlogPostStatus"
              },
              {
                "type": "null"
              }
            ]
          },
          "published_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Published At"
          },
          "seo_title": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 255
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Title"
          },
          "seo_description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 512
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Description"
          },
          "category_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category Id"
          },
          "tag_ids": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "format": "uuid"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tag Ids"
          },
          "author_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Author Id"
          },
          "author_email": {
            "anyOf": [
              {
                "type": "string",
                "format": "email"
              },
              {
                "type": "null"
              }
            ],
            "title": "Author Email"
          }
        },
        "type": "object",
        "title": "BlogPostUpdate"
      },
      "BlogPostsPublic": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/BlogPostPublic"
            },
            "type": "array",
            "title": "Data"
          },
          "count": {
            "type": "integer",
            "title": "Count"
          },
          "next_offset": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Offset"
          },
          "prev_offset": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Prev Offset"
          },
          "next_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Url"
          },
          "prev_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Prev Url"
          }
        },
        "type": "object",
        "required": ["data", "count"],
        "title": "BlogPostsPublic"
      },
      "BlogTagCreate": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 64,
            "title": "Name"
          },
          "slug": {
            "type": "string",
            "maxLength": 64,
            "title": "Slug"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["name", "slug"],
        "title": "BlogTagCreate"
      },
      "BlogTagPublic": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 64,
            "title": "Name"
          },
          "slug": {
            "type": "string",
            "maxLength": 64,
            "title": "Slug"
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          }
        },
        "type": "object",
        "required": ["name", "slug", "id"],
        "title": "BlogTagPublic"
      },
      "BlogTagUpdate": {
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "slug": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64
              },
              {
                "type": "null"
              }
            ],
            "title": "Slug"
          }
        },
        "type": "object",
        "title": "BlogTagUpdate"
      },
      "BlogTranslationPayload": {
        "properties": {
          "slug": {
            "type": "string",
            "maxLength": 255,
            "title": "Slug"
          },
          "title": {
            "type": "string",
            "maxLength": 255,
            "title": "Title"
          },
          "excerpt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt"
          },
          "content": {
            "type": "string",
            "title": "Content"
          },
          "seo_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Title"
          },
          "seo_description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Description"
          },
          "status": {
            "$ref": "#/components/schemas/BlogTranslationStatus",
            "default": "draft"
          },
          "published_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Published At"
          },
          "hero_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Hero Image Url"
          }
        },
        "type": "object",
        "required": ["slug", "title", "content"],
        "title": "BlogTranslationPayload"
      },
      "BlogTranslationPublic": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "blog_id": {
            "type": "string",
            "format": "uuid",
            "title": "Blog Id"
          },
          "locale": {
            "type": "string",
            "title": "Locale"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "excerpt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt"
          },
          "content": {
            "type": "string",
            "title": "Content"
          },
          "seo_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Title"
          },
          "seo_description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Description"
          },
          "status": {
            "$ref": "#/components/schemas/BlogTranslationStatus"
          },
          "published_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Published At"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Updated At"
          },
          "hero_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Hero Image Url"
          }
        },
        "type": "object",
        "required": [
          "id",
          "blog_id",
          "locale",
          "slug",
          "title",
          "excerpt",
          "content",
          "seo_title",
          "seo_description",
          "status",
          "published_at",
          "updated_at",
          "hero_image_url"
        ],
        "title": "BlogTranslationPublic"
      },
      "BlogTranslationStatus": {
        "type": "string",
        "enum": ["draft", "published"],
        "title": "BlogTranslationStatus"
      },
      "BlogTranslationStatusResponse": {
        "properties": {
          "blog_id": {
            "type": "string",
            "format": "uuid",
            "title": "Blog Id"
          },
          "locales": {
            "additionalProperties": {
              "$ref": "#/components/schemas/TranslationStatus"
            },
            "type": "object",
            "title": "Locales"
          }
        },
        "type": "object",
        "required": ["blog_id", "locales"],
        "title": "BlogTranslationStatusResponse"
      },
      "Body_bank-statement-to-excel-pdf_to_docx": {
        "properties": {
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          }
        },
        "type": "object",
        "required": ["files"],
        "title": "Body_bank-statement-to-excel-pdf_to_docx"
      },
      "Body_compress-compress_pdf": {
        "properties": {
          "compression_level": {
            "type": "string",
            "title": "Compression Level"
          },
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          }
        },
        "type": "object",
        "required": ["compression_level", "files"],
        "title": "Body_compress-compress_pdf"
      },
      "Body_convert-generic-submit_generic_conversion": {
        "properties": {
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          },
          "settings_json": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Settings Json"
          }
        },
        "type": "object",
        "required": ["files"],
        "title": "Body_convert-generic-submit_generic_conversion"
      },
      "Body_edit-add_page_numbers_to_pdf": {
        "properties": {
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          },
          "page_mode": {
            "type": "string",
            "title": "Page Mode",
            "default": "single"
          },
          "first_page_is_cover": {
            "type": "boolean",
            "title": "First Page Is Cover",
            "default": false
          },
          "position": {
            "type": "string",
            "title": "Position",
            "default": "bottom-right"
          },
          "margin": {
            "type": "string",
            "title": "Margin",
            "default": "recommended"
          },
          "first_number": {
            "type": "integer",
            "title": "First Number",
            "default": 1
          },
          "from_page": {
            "type": "integer",
            "title": "From Page",
            "default": 1
          },
          "to_page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "To Page"
          },
          "text_format": {
            "type": "string",
            "title": "Text Format",
            "default": "number"
          },
          "font_family": {
            "type": "string",
            "title": "Font Family",
            "default": "Helvetica"
          },
          "font_size": {
            "type": "integer",
            "title": "Font Size",
            "default": 12
          },
          "bold": {
            "type": "boolean",
            "title": "Bold",
            "default": false
          },
          "italic": {
            "type": "boolean",
            "title": "Italic",
            "default": false
          },
          "underline": {
            "type": "boolean",
            "title": "Underline",
            "default": false
          },
          "font_color": {
            "type": "string",
            "title": "Font Color",
            "default": "#000000"
          }
        },
        "type": "object",
        "required": ["files"],
        "title": "Body_edit-add_page_numbers_to_pdf"
      },
      "Body_edit-watermark_pdf": {
        "properties": {
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          },
          "watermark_type": {
            "type": "string",
            "title": "Watermark Type",
            "default": "text"
          },
          "text": {
            "type": "string",
            "title": "Text",
            "default": "PDFHQ"
          },
          "font_family": {
            "type": "string",
            "title": "Font Family",
            "default": "Helvetica"
          },
          "font_size": {
            "type": "integer",
            "title": "Font Size",
            "default": 32
          },
          "font_color": {
            "type": "string",
            "title": "Font Color",
            "default": "#E11D48"
          },
          "opacity": {
            "type": "integer",
            "title": "Opacity",
            "default": 20
          },
          "rotation": {
            "type": "integer",
            "title": "Rotation",
            "default": 0
          },
          "position": {
            "type": "string",
            "title": "Position",
            "default": "bottom-left"
          },
          "mosaic": {
            "type": "boolean",
            "title": "Mosaic",
            "default": false
          },
          "layer": {
            "type": "string",
            "title": "Layer",
            "default": "over"
          },
          "from_page": {
            "type": "integer",
            "title": "From Page",
            "default": 1
          },
          "to_page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "To Page"
          },
          "image_scale": {
            "type": "number",
            "title": "Image Scale",
            "default": 0.25
          },
          "image_file": {
            "anyOf": [
              {
                "type": "string",
                "format": "binary"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image File"
          }
        },
        "type": "object",
        "required": ["files"],
        "title": "Body_edit-watermark_pdf"
      },
      "Body_extract-images-from-pdf-extract_images_from_pdf": {
        "properties": {
          "file": {
            "type": "string",
            "format": "binary",
            "title": "File"
          },
          "output_format": {
            "type": "string",
            "title": "Output Format",
            "default": "original"
          },
          "min_width": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min Width"
          },
          "min_height": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min Height"
          },
          "deduplicate": {
            "type": "boolean",
            "title": "Deduplicate",
            "default": false
          }
        },
        "type": "object",
        "required": ["file"],
        "title": "Body_extract-images-from-pdf-extract_images_from_pdf"
      },
      "Body_extract-pages-extract_pages": {
        "properties": {
          "file": {
            "type": "string",
            "format": "binary",
            "title": "File"
          },
          "pages": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Pages"
          }
        },
        "type": "object",
        "required": ["file", "pages"],
        "title": "Body_extract-pages-extract_pages"
      },
      "Body_html-to-pdf-html_to_pdf": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "viewport_width": {
            "type": "integer",
            "title": "Viewport Width",
            "default": 1440
          },
          "viewport_height": {
            "type": "integer",
            "title": "Viewport Height",
            "default": 900
          },
          "page_size": {
            "type": "string",
            "title": "Page Size",
            "default": "a4"
          },
          "orientation": {
            "type": "string",
            "title": "Orientation",
            "default": "portrait"
          },
          "margin": {
            "type": "string",
            "title": "Margin",
            "default": "normal"
          },
          "one_long_page": {
            "type": "boolean",
            "title": "One Long Page",
            "default": false
          },
          "block_ads": {
            "type": "boolean",
            "title": "Block Ads",
            "default": false
          },
          "remove_popups": {
            "type": "boolean",
            "title": "Remove Popups",
            "default": false
          }
        },
        "type": "object",
        "required": ["url"],
        "title": "Body_html-to-pdf-html_to_pdf"
      },
      "Body_html-to-pdf-html_to_pdf_previews": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "viewport_width": {
            "type": "integer",
            "title": "Viewport Width",
            "default": 1440
          },
          "viewport_height": {
            "type": "integer",
            "title": "Viewport Height",
            "default": 900
          },
          "block_ads": {
            "type": "boolean",
            "title": "Block Ads",
            "default": false
          },
          "remove_popups": {
            "type": "boolean",
            "title": "Remove Popups",
            "default": false
          }
        },
        "type": "object",
        "required": ["url"],
        "title": "Body_html-to-pdf-html_to_pdf_previews"
      },
      "Body_image-to-pdf-image_to_pdf": {
        "properties": {
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          },
          "merge": {
            "type": "boolean",
            "title": "Merge",
            "default": true
          },
          "margin": {
            "type": "string",
            "title": "Margin",
            "default": "none"
          },
          "page_size": {
            "type": "string",
            "title": "Page Size",
            "default": "same"
          },
          "orientation": {
            "type": "string",
            "title": "Orientation",
            "default": "portrait"
          }
        },
        "type": "object",
        "required": ["files"],
        "title": "Body_image-to-pdf-image_to_pdf"
      },
      "Body_image-to-pdf-pdf_to_image": {
        "properties": {
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          },
          "mode": {
            "type": "string",
            "title": "Mode",
            "default": "pages"
          },
          "quality": {
            "type": "string",
            "title": "Quality",
            "default": "normal"
          },
          "output_format": {
            "type": "string",
            "title": "Output Format",
            "default": "jpg"
          }
        },
        "type": "object",
        "required": ["files"],
        "title": "Body_image-to-pdf-pdf_to_image"
      },
      "Body_media-admin-upload_media": {
        "properties": {
          "file": {
            "type": "string",
            "format": "binary",
            "title": "File"
          },
          "folder": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Folder"
          }
        },
        "type": "object",
        "required": ["file"],
        "title": "Body_media-admin-upload_media"
      },
      "Body_merge-merge_pdfs": {
        "properties": {
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          }
        },
        "type": "object",
        "required": ["files"],
        "title": "Body_merge-merge_pdfs"
      },
      "Body_pdf-to-excel-excel_to_pdf": {
        "properties": {
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          }
        },
        "type": "object",
        "required": ["files"],
        "title": "Body_pdf-to-excel-excel_to_pdf"
      },
      "Body_pdf-to-excel-pdf_to_docx": {
        "properties": {
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          }
        },
        "type": "object",
        "required": ["files"],
        "title": "Body_pdf-to-excel-pdf_to_docx"
      },
      "Body_pdf-to-pdfa-pdf_to_pdfa": {
        "properties": {
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          },
          "conformance": {
            "type": "string",
            "title": "Conformance",
            "default": "pdfa-3a"
          },
          "allow_pdfa_downgrade": {
            "type": "boolean",
            "title": "Allow Pdfa Downgrade",
            "default": true
          }
        },
        "type": "object",
        "required": ["files"],
        "title": "Body_pdf-to-pdfa-pdf_to_pdfa"
      },
      "Body_pdf-to-text-pdf_to_text": {
        "properties": {
          "file": {
            "type": "string",
            "format": "binary",
            "title": "File"
          }
        },
        "type": "object",
        "required": ["file"],
        "title": "Body_pdf-to-text-pdf_to_text"
      },
      "Body_pdf-to-word-pdf_to_docx": {
        "properties": {
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          }
        },
        "type": "object",
        "required": ["files"],
        "title": "Body_pdf-to-word-pdf_to_docx"
      },
      "Body_pdf-to-word-word_to_pdf": {
        "properties": {
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          }
        },
        "type": "object",
        "required": ["files"],
        "title": "Body_pdf-to-word-word_to_pdf"
      },
      "Body_remove-pages-remove_pages": {
        "properties": {
          "file": {
            "type": "string",
            "format": "binary",
            "title": "File"
          },
          "pages": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Pages"
          }
        },
        "type": "object",
        "required": ["file", "pages"],
        "title": "Body_remove-pages-remove_pages"
      },
      "Body_repair-pdf-repair_pdf": {
        "properties": {
          "file": {
            "type": "string",
            "format": "binary",
            "title": "File"
          }
        },
        "type": "object",
        "required": ["file"],
        "title": "Body_repair-pdf-repair_pdf"
      },
      "Body_resize-pdf-resize_pdf": {
        "properties": {
          "file": {
            "type": "string",
            "format": "binary",
            "title": "File"
          },
          "page_size": {
            "type": "string",
            "title": "Page Size"
          }
        },
        "type": "object",
        "required": ["file", "page_size"],
        "title": "Body_resize-pdf-resize_pdf"
      },
      "Body_rotate-rotate_pdfs": {
        "properties": {
          "rotations": {
            "items": {
              "type": "integer"
            },
            "type": "array",
            "title": "Rotations"
          },
          "files": {
            "items": {
              "type": "string",
              "format": "binary"
            },
            "type": "array",
            "title": "Files"
          }
        },
        "type": "object",
        "required": ["rotations", "files"],
        "title": "Body_rotate-rotate_pdfs"
      },
      "Body_split-split_pdf": {
        "properties": {
          "file": {
            "type": "string",
            "format": "binary",
            "title": "File"
          },
          "type": {
            "type": "string",
            "title": "Type"
          },
          "ranges": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ranges"
          },
          "allPages": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Allpages",
            "default": false
          },
          "pages": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pages"
          },
          "maxSize": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Maxsize"
          }
        },
        "type": "object",
        "required": ["file", "type"],
        "title": "Body_split-split_pdf"
      },
      "CompletedUploadResponse": {
        "properties": {
          "upload_id": {
            "type": "string",
            "title": "Upload Id"
          },
          "status": {
            "type": "string",
            "enum": ["ready", "submitted"],
            "title": "Status"
          },
          "size_bytes": {
            "type": "integer",
            "title": "Size Bytes"
          }
        },
        "type": "object",
        "required": ["upload_id", "status", "size_bytes"],
        "title": "CompletedUploadResponse"
      },
      "ConvertJobPublic": {
        "properties": {
          "job_id": {
            "type": "string",
            "title": "Job Id"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "progress": {
            "type": "integer",
            "title": "Progress"
          },
          "stage": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Stage"
          },
          "slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Slug"
          },
          "canonical_slug": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Canonical Slug"
          },
          "output_ready": {
            "type": "boolean",
            "title": "Output Ready",
            "default": false
          },
          "attempts": {
            "type": "integer",
            "title": "Attempts",
            "default": 0
          },
          "queued_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Queued At"
          },
          "updated_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          },
          "error_message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error Message"
          }
        },
        "type": "object",
        "required": ["job_id", "status", "progress"],
        "title": "ConvertJobPublic"
      },
      "ConvertSubmitPublic": {
        "properties": {
          "job_id": {
            "type": "string",
            "title": "Job Id"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "progress": {
            "type": "integer",
            "title": "Progress"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "canonical_slug": {
            "type": "string",
            "title": "Canonical Slug"
          }
        },
        "type": "object",
        "required": ["job_id", "status", "progress", "slug", "canonical_slug"],
        "title": "ConvertSubmitPublic"
      },
      "CreateAIJob": {
        "properties": {
          "operation": {
            "type": "string",
            "enum": [
              "pdfhq.ai.chat",
              "pdfhq.ai.summarize",
              "pdfhq.ai.extract",
              "pdfhq.ai.compare",
              "pdfhq.ai.translate",
              "pdfhq.ai.classify",
              "pdfhq.ai.edit_plan"
            ],
            "title": "Operation"
          },
          "upload_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Upload Id",
            "description": "Required for new jobs; omit when previous_job_id reuses the original PDFs."
          },
          "previous_job_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Previous Job Id",
            "description": "An owned successful chat job to follow up. Requires a new quote and approval."
          },
          "additional_upload_ids": {
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "type": "array",
            "maxItems": 3,
            "title": "Additional Upload Ids",
            "description": "Optional 1-3 additional verified PDFs for multi-document chat (requires a quantity-matched HQTools quote)."
          },
          "comparison_upload_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comparison Upload Id",
            "description": "Required for pdfhq.ai.compare; a second verified document belonging to the same account and API project."
          },
          "quote_id": {
            "type": "string",
            "maxLength": 64,
            "minLength": 1,
            "title": "Quote Id"
          },
          "question": {
            "type": "string",
            "maxLength": 2000,
            "title": "Question",
            "default": ""
          },
          "target_language": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 5
              },
              {
                "type": "null"
              }
            ],
            "title": "Target Language",
            "description": "Required ISO language code for excerpt translation only."
          },
          "allow_ocr": {
            "type": "boolean",
            "title": "Allow Ocr",
            "description": "Allow local OCR of scanned pages. The worker must explicitly enable OCR.",
            "default": false
          },
          "allow_external_ai": {
            "type": "boolean",
            "const": true,
            "title": "Allow External Ai",
            "description": "Explicit consent for selected PDF excerpts to be sent to the configured model provider."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["operation", "quote_id", "allow_external_ai"],
        "title": "CreateAIJob"
      },
      "DocumentJobResponse": {
        "properties": {
          "job_id": {
            "type": "string",
            "title": "Job Id"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "progress": {
            "type": "integer",
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "Progress"
          },
          "stage": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Stage"
          },
          "error_message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error Message"
          },
          "output_ready": {
            "type": "boolean",
            "title": "Output Ready",
            "default": false
          },
          "attempts": {
            "type": "integer",
            "title": "Attempts",
            "default": 0
          },
          "queued_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Queued At"
          },
          "updated_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          }
        },
        "type": "object",
        "required": ["job_id", "status", "progress"],
        "title": "DocumentJobResponse"
      },
      "EnvelopeCreate": {
        "properties": {
          "upload_id": {
            "type": "string",
            "format": "uuid",
            "title": "Upload Id",
            "description": "Completed PDF upload belonging to this account and API project"
          },
          "provider": {
            "type": "string",
            "enum": ["managed", "dropbox_sign", "docusign"],
            "title": "Provider",
            "default": "managed"
          },
          "title": {
            "type": "string",
            "maxLength": 160,
            "minLength": 3,
            "title": "Title"
          },
          "subject": {
            "type": "string",
            "maxLength": 160,
            "minLength": 3,
            "title": "Subject"
          },
          "message": {
            "type": "string",
            "maxLength": 1500,
            "title": "Message",
            "default": "Please review and sign the attached document."
          },
          "signers": {
            "items": {
              "$ref": "#/components/schemas/Signer"
            },
            "type": "array",
            "maxItems": 10,
            "minItems": 1,
            "title": "Signers"
          },
          "fields": {
            "items": {
              "$ref": "#/components/schemas/SigningField"
            },
            "type": "array",
            "maxItems": 40,
            "title": "Fields"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["upload_id", "title", "subject", "signers"],
        "title": "EnvelopeCreate"
      },
      "EnvelopeList": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/EnvelopeRead"
            },
            "type": "array",
            "title": "Data"
          },
          "limit": {
            "type": "integer",
            "title": "Limit"
          },
          "offset": {
            "type": "integer",
            "title": "Offset"
          }
        },
        "type": "object",
        "required": ["data", "limit", "offset"],
        "title": "EnvelopeList"
      },
      "EnvelopePatch": {
        "properties": {
          "title": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 160,
                "minLength": 3
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "subject": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 160,
                "minLength": 3
              },
              {
                "type": "null"
              }
            ],
            "title": "Subject"
          },
          "message": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 1500
              },
              {
                "type": "null"
              }
            ],
            "title": "Message"
          },
          "signers": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/Signer"
                },
                "type": "array",
                "maxItems": 10,
                "minItems": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Signers"
          },
          "fields": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/SigningField"
                },
                "type": "array",
                "maxItems": 40
              },
              {
                "type": "null"
              }
            ],
            "title": "Fields"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "EnvelopePatch",
        "description": "Draft-only edits; a supplied field set is a complete replacement."
      },
      "EnvelopeRead": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "provider": {
            "type": "string",
            "title": "Provider"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "subject": {
            "type": "string",
            "title": "Subject"
          },
          "message": {
            "type": "string",
            "title": "Message"
          },
          "signers": {
            "items": {
              "$ref": "#/components/schemas/Signer"
            },
            "type": "array",
            "title": "Signers"
          },
          "fields": {
            "items": {
              "$ref": "#/components/schemas/SigningField"
            },
            "type": "array",
            "title": "Fields"
          },
          "draft_version": {
            "type": "integer",
            "title": "Draft Version",
            "default": 1
          },
          "draft_digest": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Draft Digest"
          },
          "legacy_signature_page": {
            "type": "boolean",
            "title": "Legacy Signature Page",
            "default": true
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Updated At"
          },
          "sandbox": {
            "type": "boolean",
            "title": "Sandbox",
            "default": true
          },
          "legally_binding": {
            "type": "boolean",
            "title": "Legally Binding",
            "default": false
          },
          "downloadable": {
            "type": "boolean",
            "title": "Downloadable"
          },
          "last_error_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Error Code"
          },
          "links": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "title": "Links"
          }
        },
        "type": "object",
        "required": [
          "id",
          "provider",
          "status",
          "title",
          "subject",
          "message",
          "signers",
          "created_at",
          "updated_at",
          "downloadable",
          "last_error_code",
          "links"
        ],
        "title": "EnvelopeRead"
      },
      "EnvelopeReminder": {
        "properties": {
          "confirm_test_mode": {
            "type": "boolean",
            "const": true,
            "title": "Confirm Test Mode"
          },
          "recipient_index": {
            "type": "integer",
            "maximum": 9.0,
            "minimum": 0.0,
            "title": "Recipient Index"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["confirm_test_mode", "recipient_index"],
        "title": "EnvelopeReminder"
      },
      "EnvelopeSend": {
        "properties": {
          "draft_version": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 1.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Draft Version"
          },
          "confirm_test_mode": {
            "type": "boolean",
            "const": true,
            "title": "Confirm Test Mode",
            "description": "Explicit acknowledgement that Dropbox test requests are watermarked, not legally binding, and can send notifications"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["confirm_test_mode"],
        "title": "EnvelopeSend"
      },
      "EnvelopeVoid": {
        "properties": {
          "confirm_test_mode": {
            "type": "boolean",
            "const": true,
            "title": "Confirm Test Mode"
          },
          "reason": {
            "type": "string",
            "enum": [
              "sent_in_error",
              "incorrect_recipient",
              "agreement_withdrawn",
              "other"
            ],
            "title": "Reason"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["confirm_test_mode", "reason"],
        "title": "EnvelopeVoid"
      },
      "FeedbackIn": {
        "properties": {
          "subject": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "title": "Subject"
          },
          "name": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200,
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "email": {
            "anyOf": [
              {
                "type": "string",
                "format": "email"
              },
              {
                "type": "null"
              }
            ],
            "title": "Email"
          },
          "message": {
            "type": "string",
            "maxLength": 5000,
            "minLength": 1,
            "title": "Message"
          }
        },
        "type": "object",
        "required": ["subject", "message"],
        "title": "FeedbackIn"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "InvoiceBatchWorkbookRequest": {
        "properties": {
          "job_ids": {
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "type": "array",
            "maxItems": 10,
            "minItems": 1,
            "title": "Job Ids",
            "description": "One to ten distinct, succeeded invoice extraction jobs from the same authenticated account and API project."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["job_ids"],
        "title": "InvoiceBatchWorkbookRequest"
      },
      "KnowledgeAdminBlogLinkInput": {
        "properties": {
          "blog_id": {
            "type": "string",
            "format": "uuid",
            "title": "Blog Id"
          },
          "reason": {
            "type": "string",
            "maxLength": 32,
            "title": "Reason",
            "default": "reference"
          },
          "weight": {
            "type": "integer",
            "maximum": 1000.0,
            "minimum": 0.0,
            "title": "Weight",
            "default": 100
          },
          "is_featured": {
            "type": "boolean",
            "title": "Is Featured",
            "default": false
          }
        },
        "type": "object",
        "required": ["blog_id"],
        "title": "KnowledgeAdminBlogLinkInput"
      },
      "KnowledgeAdminEntryList": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeAdminEntrySummary"
            },
            "type": "array",
            "title": "Data"
          },
          "count": {
            "type": "integer",
            "title": "Count"
          }
        },
        "type": "object",
        "required": ["data", "count"],
        "title": "KnowledgeAdminEntryList"
      },
      "KnowledgeAdminEntryPublic": {
        "properties": {
          "entry_type": {
            "type": "string",
            "pattern": "^(format|glossary)$",
            "title": "Entry Type"
          },
          "locale_id": {
            "type": "string",
            "format": "uuid",
            "title": "Locale Id"
          },
          "slug": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "title": "Slug"
          },
          "title": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "title": "Title"
          },
          "excerpt": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 1024
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt"
          },
          "body_markdown": {
            "type": "string",
            "title": "Body Markdown",
            "default": ""
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Url"
          },
          "accent_color": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 32
              },
              {
                "type": "null"
              }
            ],
            "title": "Accent Color"
          },
          "icon_name": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64
              },
              {
                "type": "null"
              }
            ],
            "title": "Icon Name"
          },
          "status": {
            "type": "string",
            "pattern": "^(draft|published|archived)$",
            "title": "Status",
            "default": "draft"
          },
          "published_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Published At"
          },
          "is_featured": {
            "type": "boolean",
            "title": "Is Featured",
            "default": false
          },
          "priority_score": {
            "type": "integer",
            "maximum": 10000.0,
            "minimum": 0.0,
            "title": "Priority Score",
            "default": 0
          },
          "seo_title": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 255
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Title"
          },
          "seo_description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 1024
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Description"
          },
          "robots": {
            "type": "string",
            "maxLength": 64,
            "title": "Robots",
            "default": "index,follow"
          },
          "canonical_override": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 1024
              },
              {
                "type": "null"
              }
            ],
            "title": "Canonical Override"
          },
          "og_image_url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Og Image Url"
          },
          "twitter_title": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 255
              },
              {
                "type": "null"
              }
            ],
            "title": "Twitter Title"
          },
          "twitter_description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 1024
              },
              {
                "type": "null"
              }
            ],
            "title": "Twitter Description"
          },
          "twitter_image_url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Twitter Image Url"
          },
          "schema_override_json": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Schema Override Json"
          },
          "breadcrumb_label": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 255
              },
              {
                "type": "null"
              }
            ],
            "title": "Breadcrumb Label"
          },
          "related_entries": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeAdminRelationInput"
            },
            "type": "array",
            "title": "Related Entries"
          },
          "related_tools": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeAdminToolLinkInput"
            },
            "type": "array",
            "title": "Related Tools"
          },
          "related_blogs": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeAdminBlogLinkInput"
            },
            "type": "array",
            "title": "Related Blogs"
          },
          "faq_items": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeAdminFaqInput"
            },
            "type": "array",
            "title": "Faq Items"
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Updated At"
          }
        },
        "type": "object",
        "required": [
          "entry_type",
          "locale_id",
          "slug",
          "title",
          "id",
          "created_at",
          "updated_at"
        ],
        "title": "KnowledgeAdminEntryPublic"
      },
      "KnowledgeAdminEntrySummary": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "entry_type": {
            "type": "string",
            "title": "Entry Type"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "locale_id": {
            "type": "string",
            "format": "uuid",
            "title": "Locale Id"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "is_featured": {
            "type": "boolean",
            "title": "Is Featured"
          },
          "priority_score": {
            "type": "integer",
            "title": "Priority Score"
          },
          "updated_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "entry_type",
          "slug",
          "locale_id",
          "title",
          "status",
          "is_featured",
          "priority_score"
        ],
        "title": "KnowledgeAdminEntrySummary"
      },
      "KnowledgeAdminEntryWrite": {
        "properties": {
          "entry_type": {
            "type": "string",
            "pattern": "^(format|glossary)$",
            "title": "Entry Type"
          },
          "locale_id": {
            "type": "string",
            "format": "uuid",
            "title": "Locale Id"
          },
          "slug": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "title": "Slug"
          },
          "title": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "title": "Title"
          },
          "excerpt": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 1024
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt"
          },
          "body_markdown": {
            "type": "string",
            "title": "Body Markdown",
            "default": ""
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Url"
          },
          "accent_color": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 32
              },
              {
                "type": "null"
              }
            ],
            "title": "Accent Color"
          },
          "icon_name": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64
              },
              {
                "type": "null"
              }
            ],
            "title": "Icon Name"
          },
          "status": {
            "type": "string",
            "pattern": "^(draft|published|archived)$",
            "title": "Status",
            "default": "draft"
          },
          "published_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Published At"
          },
          "is_featured": {
            "type": "boolean",
            "title": "Is Featured",
            "default": false
          },
          "priority_score": {
            "type": "integer",
            "maximum": 10000.0,
            "minimum": 0.0,
            "title": "Priority Score",
            "default": 0
          },
          "seo_title": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 255
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Title"
          },
          "seo_description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 1024
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Description"
          },
          "robots": {
            "type": "string",
            "maxLength": 64,
            "title": "Robots",
            "default": "index,follow"
          },
          "canonical_override": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 1024
              },
              {
                "type": "null"
              }
            ],
            "title": "Canonical Override"
          },
          "og_image_url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Og Image Url"
          },
          "twitter_title": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 255
              },
              {
                "type": "null"
              }
            ],
            "title": "Twitter Title"
          },
          "twitter_description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 1024
              },
              {
                "type": "null"
              }
            ],
            "title": "Twitter Description"
          },
          "twitter_image_url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Twitter Image Url"
          },
          "schema_override_json": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Schema Override Json"
          },
          "breadcrumb_label": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 255
              },
              {
                "type": "null"
              }
            ],
            "title": "Breadcrumb Label"
          },
          "related_entries": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeAdminRelationInput"
            },
            "type": "array",
            "title": "Related Entries"
          },
          "related_tools": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeAdminToolLinkInput"
            },
            "type": "array",
            "title": "Related Tools"
          },
          "related_blogs": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeAdminBlogLinkInput"
            },
            "type": "array",
            "title": "Related Blogs"
          },
          "faq_items": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeAdminFaqInput"
            },
            "type": "array",
            "title": "Faq Items"
          }
        },
        "type": "object",
        "required": ["entry_type", "locale_id", "slug", "title"],
        "title": "KnowledgeAdminEntryWrite"
      },
      "KnowledgeAdminFaqInput": {
        "properties": {
          "question": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1,
            "title": "Question"
          },
          "answer": {
            "type": "string",
            "minLength": 1,
            "title": "Answer"
          },
          "sort_order": {
            "type": "integer",
            "maximum": 10000.0,
            "minimum": 0.0,
            "title": "Sort Order",
            "default": 0
          },
          "is_active": {
            "type": "boolean",
            "title": "Is Active",
            "default": true
          },
          "include_in_schema": {
            "type": "boolean",
            "title": "Include In Schema",
            "default": true
          }
        },
        "type": "object",
        "required": ["question", "answer"],
        "title": "KnowledgeAdminFaqInput"
      },
      "KnowledgeAdminOptionBlog": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "canonical_slug": {
            "type": "string",
            "title": "Canonical Slug"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "locale": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Locale"
          }
        },
        "type": "object",
        "required": ["id", "canonical_slug"],
        "title": "KnowledgeAdminOptionBlog"
      },
      "KnowledgeAdminOptionEntry": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "entry_type": {
            "type": "string",
            "title": "Entry Type"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "locale_id": {
            "type": "string",
            "format": "uuid",
            "title": "Locale Id"
          }
        },
        "type": "object",
        "required": ["id", "entry_type", "slug", "title", "locale_id"],
        "title": "KnowledgeAdminOptionEntry"
      },
      "KnowledgeAdminOptionLocale": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "locale": {
            "type": "string",
            "title": "Locale"
          },
          "display_name": {
            "type": "string",
            "title": "Display Name"
          },
          "enabled": {
            "type": "boolean",
            "title": "Enabled"
          }
        },
        "type": "object",
        "required": ["id", "locale", "display_name", "enabled"],
        "title": "KnowledgeAdminOptionLocale"
      },
      "KnowledgeAdminOptionTool": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "name": {
            "type": "string",
            "title": "Name"
          }
        },
        "type": "object",
        "required": ["id", "slug", "name"],
        "title": "KnowledgeAdminOptionTool"
      },
      "KnowledgeAdminOptions": {
        "properties": {
          "locales": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeAdminOptionLocale"
            },
            "type": "array",
            "title": "Locales"
          },
          "tools": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeAdminOptionTool"
            },
            "type": "array",
            "title": "Tools"
          },
          "blogs": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeAdminOptionBlog"
            },
            "type": "array",
            "title": "Blogs"
          },
          "entries": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeAdminOptionEntry"
            },
            "type": "array",
            "title": "Entries"
          }
        },
        "type": "object",
        "required": ["locales", "tools", "blogs", "entries"],
        "title": "KnowledgeAdminOptions"
      },
      "KnowledgeAdminRelationInput": {
        "properties": {
          "to_entry_id": {
            "type": "string",
            "format": "uuid",
            "title": "To Entry Id"
          },
          "relation_type": {
            "type": "string",
            "maxLength": 32,
            "title": "Relation Type",
            "default": "related"
          },
          "weight": {
            "type": "integer",
            "maximum": 1000.0,
            "minimum": 0.0,
            "title": "Weight",
            "default": 100
          }
        },
        "type": "object",
        "required": ["to_entry_id"],
        "title": "KnowledgeAdminRelationInput"
      },
      "KnowledgeAdminToolLinkInput": {
        "properties": {
          "tool_id": {
            "type": "string",
            "format": "uuid",
            "title": "Tool Id"
          },
          "link_type": {
            "type": "string",
            "maxLength": 32,
            "title": "Link Type",
            "default": "supports"
          },
          "weight": {
            "type": "integer",
            "maximum": 1000.0,
            "minimum": 0.0,
            "title": "Weight",
            "default": 100
          },
          "is_featured": {
            "type": "boolean",
            "title": "Is Featured",
            "default": false
          }
        },
        "type": "object",
        "required": ["tool_id"],
        "title": "KnowledgeAdminToolLinkInput"
      },
      "KnowledgeEntriesPublic": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeEntrySummaryPublic"
            },
            "type": "array",
            "title": "Data"
          },
          "count": {
            "type": "integer",
            "title": "Count"
          },
          "locale": {
            "type": "string",
            "title": "Locale"
          },
          "resolved_locale": {
            "type": "string",
            "title": "Resolved Locale"
          }
        },
        "type": "object",
        "required": ["data", "count", "locale", "resolved_locale"],
        "title": "KnowledgeEntriesPublic"
      },
      "KnowledgeEntryDetailPublic": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "entry_type": {
            "type": "string",
            "title": "Entry Type"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "excerpt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt"
          },
          "path": {
            "type": "string",
            "title": "Path"
          },
          "locale": {
            "type": "string",
            "title": "Locale"
          },
          "resolved_locale": {
            "type": "string",
            "title": "Resolved Locale"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Url"
          },
          "accent_color": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Accent Color"
          },
          "icon_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Icon Name"
          },
          "updated_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          },
          "body_markdown": {
            "type": "string",
            "title": "Body Markdown"
          },
          "seo_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Title"
          },
          "seo_description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Seo Description"
          },
          "robots": {
            "type": "string",
            "title": "Robots",
            "default": "index,follow"
          },
          "canonical_override": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Canonical Override"
          },
          "og_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Og Image Url"
          },
          "twitter_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Twitter Title"
          },
          "twitter_description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Twitter Description"
          },
          "twitter_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Twitter Image Url"
          },
          "schema_override_json": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Schema Override Json"
          },
          "breadcrumb_label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Breadcrumb Label"
          },
          "published_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Published At"
          },
          "faq_items": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeFaqItemPublic"
            },
            "type": "array",
            "title": "Faq Items"
          },
          "related_entries": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeRelatedEntryPublic"
            },
            "type": "array",
            "title": "Related Entries"
          },
          "related_tools": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeRelatedToolPublic"
            },
            "type": "array",
            "title": "Related Tools"
          },
          "related_blogs": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeRelatedBlogPublic"
            },
            "type": "array",
            "title": "Related Blogs"
          }
        },
        "type": "object",
        "required": [
          "id",
          "entry_type",
          "slug",
          "title",
          "path",
          "locale",
          "resolved_locale",
          "body_markdown",
          "faq_items",
          "related_entries",
          "related_tools",
          "related_blogs"
        ],
        "title": "KnowledgeEntryDetailPublic"
      },
      "KnowledgeEntrySummaryPublic": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "entry_type": {
            "type": "string",
            "title": "Entry Type"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "excerpt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt"
          },
          "path": {
            "type": "string",
            "title": "Path"
          },
          "locale": {
            "type": "string",
            "title": "Locale"
          },
          "resolved_locale": {
            "type": "string",
            "title": "Resolved Locale"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cover Image Url"
          },
          "accent_color": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Accent Color"
          },
          "icon_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Icon Name"
          },
          "updated_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "entry_type",
          "slug",
          "title",
          "path",
          "locale",
          "resolved_locale"
        ],
        "title": "KnowledgeEntrySummaryPublic"
      },
      "KnowledgeFaqItemPublic": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "question": {
            "type": "string",
            "title": "Question"
          },
          "answer": {
            "type": "string",
            "title": "Answer"
          },
          "sort_order": {
            "type": "integer",
            "title": "Sort Order"
          },
          "is_active": {
            "type": "boolean",
            "title": "Is Active"
          },
          "include_in_schema": {
            "type": "boolean",
            "title": "Include In Schema"
          }
        },
        "type": "object",
        "required": [
          "id",
          "question",
          "answer",
          "sort_order",
          "is_active",
          "include_in_schema"
        ],
        "title": "KnowledgeFaqItemPublic"
      },
      "KnowledgeGraphSuggestionPublic": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "score": {
            "type": "integer",
            "title": "Score"
          }
        },
        "type": "object",
        "required": ["id", "slug", "title", "score"],
        "title": "KnowledgeGraphSuggestionPublic"
      },
      "KnowledgeGraphSuggestionsPublic": {
        "properties": {
          "entry_id": {
            "type": "string",
            "format": "uuid",
            "title": "Entry Id"
          },
          "related_entries": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeGraphSuggestionPublic"
            },
            "type": "array",
            "title": "Related Entries"
          },
          "related_tools": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeGraphSuggestionPublic"
            },
            "type": "array",
            "title": "Related Tools"
          },
          "related_blogs": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeGraphSuggestionPublic"
            },
            "type": "array",
            "title": "Related Blogs"
          }
        },
        "type": "object",
        "required": [
          "entry_id",
          "related_entries",
          "related_tools",
          "related_blogs"
        ],
        "title": "KnowledgeGraphSuggestionsPublic"
      },
      "KnowledgeHubPublic": {
        "properties": {
          "locale": {
            "type": "string",
            "title": "Locale"
          },
          "resolved_locale": {
            "type": "string",
            "title": "Resolved Locale"
          },
          "featured_formats": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeEntrySummaryPublic"
            },
            "type": "array",
            "title": "Featured Formats"
          },
          "featured_glossary": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeEntrySummaryPublic"
            },
            "type": "array",
            "title": "Featured Glossary"
          },
          "recent_updates": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeEntrySummaryPublic"
            },
            "type": "array",
            "title": "Recent Updates"
          }
        },
        "type": "object",
        "required": [
          "locale",
          "resolved_locale",
          "featured_formats",
          "featured_glossary",
          "recent_updates"
        ],
        "title": "KnowledgeHubPublic"
      },
      "KnowledgeQualityIssuePublic": {
        "properties": {
          "code": {
            "type": "string",
            "title": "Code"
          },
          "message": {
            "type": "string",
            "title": "Message"
          },
          "field": {
            "type": "string",
            "title": "Field"
          },
          "severity": {
            "type": "string",
            "title": "Severity"
          }
        },
        "type": "object",
        "required": ["code", "message", "field", "severity"],
        "title": "KnowledgeQualityIssuePublic"
      },
      "KnowledgeRelatedBlogPublic": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "excerpt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt"
          },
          "path": {
            "type": "string",
            "title": "Path"
          },
          "locale": {
            "type": "string",
            "title": "Locale"
          },
          "reason": {
            "type": "string",
            "title": "Reason"
          },
          "weight": {
            "type": "integer",
            "title": "Weight"
          }
        },
        "type": "object",
        "required": [
          "id",
          "slug",
          "title",
          "path",
          "locale",
          "reason",
          "weight"
        ],
        "title": "KnowledgeRelatedBlogPublic"
      },
      "KnowledgeRelatedEntryPublic": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "entry_type": {
            "type": "string",
            "title": "Entry Type"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "excerpt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt"
          },
          "path": {
            "type": "string",
            "title": "Path"
          },
          "locale": {
            "type": "string",
            "title": "Locale"
          }
        },
        "type": "object",
        "required": ["id", "entry_type", "slug", "title", "path", "locale"],
        "title": "KnowledgeRelatedEntryPublic"
      },
      "KnowledgeRelatedToolPublic": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "path": {
            "type": "string",
            "title": "Path"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "link_type": {
            "type": "string",
            "title": "Link Type"
          },
          "weight": {
            "type": "integer",
            "title": "Weight"
          }
        },
        "type": "object",
        "required": ["id", "slug", "name", "path", "link_type", "weight"],
        "title": "KnowledgeRelatedToolPublic"
      },
      "KnowledgeSeoHealthEntryPublic": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "entry_type": {
            "type": "string",
            "title": "Entry Type"
          },
          "locale": {
            "type": "string",
            "title": "Locale"
          },
          "score": {
            "type": "integer",
            "title": "Score"
          },
          "issues": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeQualityIssuePublic"
            },
            "type": "array",
            "title": "Issues"
          }
        },
        "type": "object",
        "required": ["id", "slug", "entry_type", "locale", "score", "issues"],
        "title": "KnowledgeSeoHealthEntryPublic"
      },
      "KnowledgeSeoHealthReport": {
        "properties": {
          "generated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Generated At"
          },
          "summary": {
            "$ref": "#/components/schemas/KnowledgeSeoHealthSummary"
          },
          "issue_breakdown": {
            "additionalProperties": {
              "type": "integer"
            },
            "type": "object",
            "title": "Issue Breakdown"
          },
          "entries": {
            "items": {
              "$ref": "#/components/schemas/KnowledgeSeoHealthEntryPublic"
            },
            "type": "array",
            "title": "Entries"
          }
        },
        "type": "object",
        "required": ["generated_at", "summary", "issue_breakdown", "entries"],
        "title": "KnowledgeSeoHealthReport"
      },
      "KnowledgeSeoHealthSummary": {
        "properties": {
          "total_entries": {
            "type": "integer",
            "title": "Total Entries"
          },
          "published_entries": {
            "type": "integer",
            "title": "Published Entries"
          },
          "healthy_entries": {
            "type": "integer",
            "title": "Healthy Entries"
          },
          "entries_with_errors": {
            "type": "integer",
            "title": "Entries With Errors"
          },
          "entries_with_warnings": {
            "type": "integer",
            "title": "Entries With Warnings"
          }
        },
        "type": "object",
        "required": [
          "total_entries",
          "published_entries",
          "healthy_entries",
          "entries_with_errors",
          "entries_with_warnings"
        ],
        "title": "KnowledgeSeoHealthSummary"
      },
      "LocaleBlogStatus": {
        "type": "string",
        "enum": ["ok", "partial", "missing"],
        "title": "LocaleBlogStatus"
      },
      "LocaleEmailStatus": {
        "type": "string",
        "enum": ["ok", "missing_templates"],
        "title": "LocaleEmailStatus"
      },
      "LocaleReadinessPublic": {
        "properties": {
          "locale": {
            "type": "string",
            "title": "Locale"
          },
          "enabled": {
            "type": "boolean",
            "title": "Enabled"
          },
          "ui_status": {
            "$ref": "#/components/schemas/LocaleUiStatus"
          },
          "email_status": {
            "$ref": "#/components/schemas/LocaleEmailStatus"
          },
          "blog_status": {
            "$ref": "#/components/schemas/LocaleBlogStatus"
          },
          "overall": {
            "type": "string",
            "title": "Overall"
          },
          "missing_ui_keys": {
            "type": "integer",
            "title": "Missing Ui Keys"
          },
          "missing_email_templates": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Missing Email Templates"
          },
          "blog_coverage": {
            "type": "number",
            "title": "Blog Coverage"
          },
          "translated_count": {
            "type": "integer",
            "title": "Translated Count"
          },
          "total_blogs": {
            "type": "integer",
            "title": "Total Blogs"
          },
          "last_checked_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Checked At"
          }
        },
        "type": "object",
        "required": [
          "locale",
          "enabled",
          "ui_status",
          "email_status",
          "blog_status",
          "overall",
          "missing_ui_keys",
          "missing_email_templates",
          "blog_coverage",
          "translated_count",
          "total_blogs",
          "last_checked_at"
        ],
        "title": "LocaleReadinessPublic"
      },
      "LocaleStatusPublic": {
        "properties": {
          "locale": {
            "type": "string",
            "title": "Locale"
          },
          "display_name": {
            "type": "string",
            "title": "Display Name"
          },
          "enabled": {
            "type": "boolean",
            "title": "Enabled"
          },
          "ui_status": {
            "$ref": "#/components/schemas/LocaleUiStatus"
          },
          "email_status": {
            "$ref": "#/components/schemas/LocaleEmailStatus"
          },
          "blog_status": {
            "$ref": "#/components/schemas/LocaleBlogStatus"
          },
          "last_checked_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Checked At"
          }
        },
        "type": "object",
        "required": [
          "locale",
          "display_name",
          "enabled",
          "ui_status",
          "email_status",
          "blog_status",
          "last_checked_at"
        ],
        "title": "LocaleStatusPublic"
      },
      "LocaleStatusUpdate": {
        "properties": {
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name"
          },
          "enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Enabled"
          },
          "ui_status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LocaleUiStatus"
              },
              {
                "type": "null"
              }
            ]
          },
          "email_status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LocaleEmailStatus"
              },
              {
                "type": "null"
              }
            ]
          },
          "blog_status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LocaleBlogStatus"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "title": "LocaleStatusUpdate"
      },
      "LocaleUiStatus": {
        "type": "string",
        "enum": ["ok", "missing_keys"],
        "title": "LocaleUiStatus"
      },
      "LocalesPublic": {
        "properties": {
          "default_locale": {
            "type": "string",
            "title": "Default Locale"
          },
          "supported_locales": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Supported Locales"
          },
          "enabled_locales": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Enabled Locales"
          },
          "eligible_locales": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Eligible Locales"
          },
          "indexable_locales": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Indexable Locales"
          },
          "locale_display_names": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "title": "Locale Display Names"
          },
          "locales": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Locales"
          }
        },
        "type": "object",
        "required": [
          "default_locale",
          "supported_locales",
          "enabled_locales",
          "eligible_locales",
          "indexable_locales",
          "locale_display_names",
          "locales"
        ],
        "title": "LocalesPublic"
      },
      "LocalesResponse": {
        "properties": {
          "locales": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Locales"
          }
        },
        "type": "object",
        "required": ["locales"],
        "title": "LocalesResponse"
      },
      "MediaItem": {
        "properties": {
          "key": {
            "type": "string",
            "title": "Key"
          },
          "url": {
            "type": "string",
            "title": "Url"
          },
          "thumbnail_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Thumbnail Url"
          },
          "size": {
            "type": "integer",
            "title": "Size"
          },
          "last_modified": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Modified"
          }
        },
        "type": "object",
        "required": ["key", "url", "size"],
        "title": "MediaItem"
      },
      "MediaListResponse": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/MediaItem"
            },
            "type": "array",
            "title": "Items"
          },
          "next_token": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Token"
          }
        },
        "type": "object",
        "required": ["items"],
        "title": "MediaListResponse"
      },
      "MediaPresignRequest": {
        "properties": {
          "filename": {
            "type": "string",
            "title": "Filename"
          },
          "content_type": {
            "type": "string",
            "title": "Content Type"
          },
          "folder": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Folder"
          }
        },
        "type": "object",
        "required": ["filename", "content_type"],
        "title": "MediaPresignRequest"
      },
      "MediaPresignResponse": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "fields": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "title": "Fields"
          },
          "key": {
            "type": "string",
            "title": "Key"
          },
          "public_url": {
            "type": "string",
            "title": "Public Url"
          }
        },
        "type": "object",
        "required": ["url", "fields", "key", "public_url"],
        "title": "MediaPresignResponse"
      },
      "MediaUploadResponse": {
        "properties": {
          "key": {
            "type": "string",
            "title": "Key"
          },
          "public_url": {
            "type": "string",
            "title": "Public Url"
          },
          "thumbnail_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Thumbnail Url"
          }
        },
        "type": "object",
        "required": ["key", "public_url"],
        "title": "MediaUploadResponse"
      },
      "Message": {
        "properties": {
          "message": {
            "type": "string",
            "title": "Message"
          }
        },
        "type": "object",
        "required": ["message"],
        "title": "Message"
      },
      "NormalizedRect": {
        "properties": {
          "x": {
            "type": "number",
            "exclusiveMaximum": 1.0,
            "minimum": 0.0,
            "title": "X"
          },
          "y": {
            "type": "number",
            "exclusiveMaximum": 1.0,
            "minimum": 0.0,
            "title": "Y"
          },
          "width": {
            "type": "number",
            "maximum": 1.0,
            "exclusiveMinimum": 0.0,
            "title": "Width"
          },
          "height": {
            "type": "number",
            "maximum": 1.0,
            "exclusiveMinimum": 0.0,
            "title": "Height"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["x", "y", "width", "height"],
        "title": "NormalizedRect"
      },
      "PageEditPreviewRequest": {
        "properties": {
          "upload_id": {
            "type": "string",
            "format": "uuid",
            "title": "Upload Id"
          },
          "instruction": {
            "type": "string",
            "maxLength": 2000,
            "minLength": 1,
            "title": "Instruction"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["upload_id", "instruction"],
        "title": "PageEditPreviewRequest"
      },
      "QuoteRequest": {
        "properties": {
          "price_id": {
            "type": "string",
            "maxLength": 40,
            "minLength": 1,
            "title": "Price Id",
            "description": "An active PDFHQ AI price ID returned by GET /v1/ai/credits/prices."
          },
          "quantity": {
            "anyOf": [
              {
                "type": "number",
                "maximum": 200.0,
                "exclusiveMinimum": 0.0
              },
              {
                "type": "string",
                "pattern": "^(?!^[-+.]*$)[+-]?0*(?:\\d{0,8}|(?=[\\d.]{1,13}0*$)\\d{0,8}\\.\\d{0,4}0*$)"
              }
            ],
            "title": "Quantity",
            "description": "Estimated billable units for the selected active price, not tokens or pages unless its provider tariff explicitly says so."
          }
        },
        "type": "object",
        "required": ["price_id", "quantity"],
        "title": "QuoteRequest"
      },
      "RegisterDocument": {
        "properties": {
          "upload_id": {
            "type": "string",
            "format": "uuid",
            "title": "Upload Id"
          },
          "title": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "title": "Title"
          },
          "description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2000
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          }
        },
        "type": "object",
        "required": ["upload_id", "title"],
        "title": "RegisterDocument"
      },
      "RelatedBlogPublic": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "excerpt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt"
          },
          "path": {
            "type": "string",
            "title": "Path"
          },
          "locale": {
            "type": "string",
            "title": "Locale"
          }
        },
        "type": "object",
        "required": ["id", "slug", "title", "path", "locale"],
        "title": "RelatedBlogPublic"
      },
      "RelatedToolPublic": {
        "properties": {
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "path": {
            "type": "string",
            "title": "Path"
          },
          "relation_type": {
            "type": "string",
            "title": "Relation Type"
          },
          "weight": {
            "type": "integer",
            "title": "Weight"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          }
        },
        "type": "object",
        "required": ["slug", "name", "path", "relation_type", "weight"],
        "title": "RelatedToolPublic"
      },
      "ReminderRead": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "recipient_index": {
            "type": "integer",
            "title": "Recipient Index"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "last_error_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Error Code"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "recipient_index",
          "status",
          "last_error_code",
          "created_at"
        ],
        "title": "ReminderRead"
      },
      "RetentionUpdate": {
        "properties": {
          "retained_until": {
            "type": "string",
            "format": "date-time",
            "title": "Retained Until"
          }
        },
        "type": "object",
        "required": ["retained_until"],
        "title": "RetentionUpdate"
      },
      "SignedDownloadResponse": {
        "properties": {
          "job_id": {
            "type": "string",
            "title": "Job Id"
          },
          "url": {
            "type": "string",
            "title": "Url",
            "description": "Short-lived presigned URL; do not store or log it."
          },
          "expires_in_seconds": {
            "type": "integer",
            "title": "Expires In Seconds"
          }
        },
        "type": "object",
        "required": ["job_id", "url", "expires_in_seconds"],
        "title": "SignedDownloadResponse"
      },
      "SignedUploadResponse": {
        "properties": {
          "upload_id": {
            "type": "string",
            "title": "Upload Id",
            "description": "Opaque unique upload ID; not an S3 object key."
          },
          "status": {
            "type": "string",
            "title": "Status",
            "description": "Initial lifecycle state; pending until completed."
          },
          "method": {
            "type": "string",
            "const": "POST",
            "title": "Method"
          },
          "url": {
            "type": "string",
            "title": "Url",
            "description": "Short-lived presigned S3 form submission URL."
          },
          "fields": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "title": "Fields",
            "description": "Signed multipart form fields. Submit all unchanged alongside file bytes."
          },
          "expires_at": {
            "type": "string",
            "title": "Expires At",
            "description": "Date/time after which the upload record cannot be completed."
          },
          "upload_url_expires_in_seconds": {
            "type": "integer",
            "title": "Upload Url Expires In Seconds",
            "description": "Validity window for the S3 presigned form policy, usually 300 seconds."
          },
          "next": {
            "type": "string",
            "title": "Next",
            "description": "API endpoint used to verify and seal this upload."
          }
        },
        "type": "object",
        "required": [
          "upload_id",
          "status",
          "method",
          "url",
          "fields",
          "expires_at",
          "upload_url_expires_in_seconds",
          "next"
        ],
        "title": "SignedUploadResponse"
      },
      "Signer": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 120,
            "minLength": 2,
            "title": "Name"
          },
          "email": {
            "type": "string",
            "format": "email",
            "title": "Email"
          },
          "order": {
            "type": "integer",
            "maximum": 9.0,
            "minimum": 0.0,
            "title": "Order",
            "default": 0
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["name", "email"],
        "title": "Signer"
      },
      "SigningField": {
        "properties": {
          "field_id": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^[a-zA-Z][a-zA-Z0-9_-]{0,39}$",
            "title": "Field Id"
          },
          "signer_index": {
            "type": "integer",
            "maximum": 9.0,
            "minimum": 0.0,
            "title": "Signer Index"
          },
          "type": {
            "type": "string",
            "enum": ["signature", "initials", "date_signed"],
            "title": "Type"
          },
          "page": {
            "type": "integer",
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Page"
          },
          "rect": {
            "$ref": "#/components/schemas/NormalizedRect"
          },
          "required": {
            "type": "boolean",
            "const": true,
            "title": "Required",
            "default": true
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["field_id", "signer_index", "type", "page", "rect"],
        "title": "SigningField"
      },
      "SigningHandoff": {
        "properties": {
          "provider": {
            "type": "string",
            "title": "Provider",
            "default": "managed"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "subject": {
            "type": "string",
            "title": "Subject"
          },
          "message": {
            "type": "string",
            "title": "Message",
            "default": "Please review and sign the attached document."
          },
          "signers": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array",
            "title": "Signers"
          }
        },
        "type": "object",
        "required": ["title", "subject", "signers"],
        "title": "SigningHandoff",
        "description": "Draft only; sending remains a separate explicitly authorized operation."
      },
      "StartUpload": {
        "properties": {
          "filename": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "title": "Filename",
            "description": "Source document filename ending in .pdf; directory components are discarded.",
            "examples": ["annual-report.pdf"]
          },
          "content_type": {
            "type": "string",
            "const": "application/pdf",
            "title": "Content Type",
            "description": "MIME type; only application/pdf is supported.",
            "default": "application/pdf"
          },
          "size_bytes": {
            "type": "integer",
            "exclusiveMinimum": 0.0,
            "title": "Size Bytes",
            "description": "Exact PDF size in bytes, limited by HQTools entitlements and the PDFHQ upload ceiling.",
            "examples": ["142008"]
          },
          "sha256": {
            "type": "string",
            "title": "Sha256",
            "description": "Exact file content SHA-256 digest in lowercase hexadecimal, checked on worker fetch."
          }
        },
        "type": "object",
        "required": ["filename", "size_bytes", "sha256"],
        "title": "StartUpload"
      },
      "SubmitJob": {
        "properties": {
          "tool": {
            "type": "string",
            "enum": [
              "compress",
              "merge",
              "split",
              "rotate",
              "pdf_to_image",
              "optimize",
              "remove_metadata",
              "redact",
              "sign",
              "organize",
              "annotate",
              "fill_form",
              "flatten"
            ],
            "title": "Tool",
            "description": "Document operation; operation-specific settings are listed in /developers."
          },
          "upload_ids": {
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "type": "array",
            "maxItems": 12,
            "minItems": 1,
            "title": "Upload Ids",
            "description": "Ordered identifiers returned by /documents/uploads and sealed by /complete."
          },
          "options": {
            "additionalProperties": true,
            "type": "object",
            "title": "Options",
            "description": "Operation-specific settings. Unknown parameters are rejected, and defaults are explicit."
          }
        },
        "type": "object",
        "required": ["tool", "upload_ids"],
        "title": "SubmitJob"
      },
      "SubscriptionCreate": {
        "properties": {
          "target_url": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 10,
            "title": "Target Url"
          },
          "events": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "maxItems": 12,
            "minItems": 1,
            "title": "Events",
            "description": "Published metadata-only event identifiers"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": ["target_url", "events"],
        "title": "SubscriptionCreate"
      },
      "SubscriptionCreated": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "target_url": {
            "type": "string",
            "title": "Target Url"
          },
          "events": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Events"
          },
          "active": {
            "type": "boolean",
            "title": "Active"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          },
          "secret": {
            "type": "string",
            "title": "Secret",
            "description": "One-time webhook HMAC secret; store securely, never display again"
          }
        },
        "type": "object",
        "required": [
          "id",
          "target_url",
          "events",
          "active",
          "created_at",
          "secret"
        ],
        "title": "SubscriptionCreated"
      },
      "SubscriptionView": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "target_url": {
            "type": "string",
            "title": "Target Url"
          },
          "events": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Events"
          },
          "active": {
            "type": "boolean",
            "title": "Active"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          }
        },
        "type": "object",
        "required": ["id", "target_url", "events", "active", "created_at"],
        "title": "SubscriptionView"
      },
      "TaskAttach": {
        "properties": {
          "upload_id": {
            "type": "string",
            "format": "uuid",
            "title": "Upload Id",
            "description": "Completed document upload to attach, in processing order."
          }
        },
        "type": "object",
        "required": ["upload_id"],
        "title": "TaskAttach"
      },
      "TaskHandoff": {
        "properties": {
          "task_id": {
            "type": "string",
            "format": "uuid",
            "title": "Task Id"
          }
        },
        "type": "object",
        "required": ["task_id"],
        "title": "TaskHandoff"
      },
      "TaskList": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/TaskResponse"
            },
            "type": "array",
            "title": "Data"
          },
          "limit": {
            "type": "integer",
            "title": "Limit"
          },
          "offset": {
            "type": "integer",
            "title": "Offset"
          },
          "has_more": {
            "type": "boolean",
            "title": "Has More"
          }
        },
        "type": "object",
        "required": ["data", "limit", "offset", "has_more"],
        "title": "TaskList"
      },
      "TaskProcess": {
        "properties": {
          "approval_token": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 1200
              },
              {
                "type": "null"
              }
            ],
            "title": "Approval Token",
            "description": "Optional page-edit preview approval token. Bound to owner, sealed upload revision, options and 15-minute expiry."
          },
          "options": {
            "additionalProperties": true,
            "type": "object",
            "title": "Options",
            "description": "Validated settings for the selected operation."
          }
        },
        "type": "object",
        "title": "TaskProcess"
      },
      "TaskResponse": {
        "properties": {
          "task_id": {
            "type": "string",
            "format": "uuid",
            "title": "Task Id"
          },
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "status": {
            "type": "string",
            "title": "Status",
            "description": "waiting, submitting, queued, running, succeeded, failed, cancelled, expired or deleted."
          },
          "upload_ids": {
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "type": "array",
            "title": "Upload Ids"
          },
          "job_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Job Id"
          },
          "progress": {
            "type": "integer",
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "Progress"
          },
          "output_ready": {
            "type": "boolean",
            "title": "Output Ready"
          },
          "stage": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Stage"
          },
          "error_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error Code"
          },
          "error_message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error Message"
          },
          "attempts": {
            "type": "integer",
            "title": "Attempts",
            "default": 0
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Updated At"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "title": "Expires At"
          },
          "links": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "title": "Links"
          }
        },
        "type": "object",
        "required": [
          "task_id",
          "tool",
          "status",
          "upload_ids",
          "progress",
          "output_ready",
          "created_at",
          "updated_at",
          "expires_at",
          "links"
        ],
        "title": "TaskResponse"
      },
      "TaskStart": {
        "properties": {
          "tool": {
            "type": "string",
            "enum": [
              "compress",
              "merge",
              "split",
              "rotate",
              "pdf_to_image",
              "optimize",
              "remove_metadata",
              "redact",
              "sign",
              "organize",
              "annotate",
              "fill_form",
              "flatten"
            ],
            "title": "Tool",
            "description": "Operation to perform; immutable once started."
          }
        },
        "type": "object",
        "required": ["tool"],
        "title": "TaskStart"
      },
      "TaskTool": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "min_files": {
            "type": "integer",
            "title": "Min Files"
          },
          "max_files": {
            "type": "integer",
            "title": "Max Files"
          },
          "options": {
            "items": {
              "$ref": "#/components/schemas/ToolOption"
            },
            "type": "array",
            "title": "Options"
          },
          "start_endpoint": {
            "type": "string",
            "title": "Start Endpoint",
            "default": "/v1/tasks"
          },
          "process_endpoint": {
            "type": "string",
            "title": "Process Endpoint",
            "default": "/v1/tasks/{task_id}/process"
          }
        },
        "type": "object",
        "required": ["tool", "min_files", "max_files", "options"],
        "title": "TaskTool"
      },
      "TemplateDetailResponse": {
        "properties": {
          "locale": {
            "type": "string",
            "title": "Locale"
          },
          "resolved_locale": {
            "type": "string",
            "title": "Resolved Locale"
          },
          "template": {
            "type": "string",
            "title": "Template"
          },
          "html": {
            "type": "string",
            "title": "Html"
          },
          "plain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Plain"
          },
          "metadata": {
            "$ref": "#/components/schemas/TemplateMetadata"
          }
        },
        "type": "object",
        "required": [
          "locale",
          "resolved_locale",
          "template",
          "html",
          "plain",
          "metadata"
        ],
        "title": "TemplateDetailResponse"
      },
      "TemplateMetadata": {
        "properties": {
          "subject": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Subject"
          },
          "allowed_vars": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Allowed Vars"
          },
          "required_vars": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Required Vars"
          }
        },
        "type": "object",
        "title": "TemplateMetadata"
      },
      "TemplateUpdatePayload": {
        "properties": {
          "html": {
            "type": "string",
            "title": "Html"
          },
          "plain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Plain"
          },
          "metadata": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TemplateMetadata"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": ["html"],
        "title": "TemplateUpdatePayload"
      },
      "TemplatesListResponse": {
        "properties": {
          "locale": {
            "type": "string",
            "title": "Locale"
          },
          "templates": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Templates"
          }
        },
        "type": "object",
        "required": ["locale", "templates"],
        "title": "TemplatesListResponse"
      },
      "ToolDetailPublic": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "path": {
            "type": "string",
            "title": "Path"
          },
          "tool_type": {
            "type": "string",
            "title": "Tool Type"
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "priority_score": {
            "type": "integer",
            "title": "Priority Score"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "intro": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Intro"
          },
          "resolved_locale": {
            "type": "string",
            "title": "Resolved Locale"
          },
          "h1": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H1"
          },
          "meta_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Meta Title"
          },
          "meta_description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Meta Description"
          },
          "how_it_works": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "How It Works"
          },
          "below_fold_heading": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Below Fold Heading"
          },
          "below_fold_content": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Below Fold Content"
          },
          "use_cases": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Use Cases"
          },
          "pro_tips": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pro Tips"
          },
          "limits_and_notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Limits And Notes"
          },
          "faq": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Faq"
          },
          "trust_copy": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Trust Copy"
          },
          "related_tools": {
            "items": {
              "$ref": "#/components/schemas/RelatedToolPublic"
            },
            "type": "array",
            "title": "Related Tools"
          },
          "related_blogs": {
            "items": {
              "$ref": "#/components/schemas/RelatedBlogPublic"
            },
            "type": "array",
            "title": "Related Blogs"
          }
        },
        "type": "object",
        "required": [
          "id",
          "slug",
          "name",
          "path",
          "tool_type",
          "status",
          "priority_score",
          "title",
          "resolved_locale",
          "related_tools",
          "related_blogs"
        ],
        "title": "ToolDetailPublic"
      },
      "ToolListPublic": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/ToolSummaryPublic"
            },
            "type": "array",
            "title": "Data"
          },
          "count": {
            "type": "integer",
            "title": "Count"
          },
          "locale": {
            "type": "string",
            "title": "Locale"
          },
          "resolved_locale": {
            "type": "string",
            "title": "Resolved Locale"
          }
        },
        "type": "object",
        "required": ["data", "count", "locale", "resolved_locale"],
        "title": "ToolListPublic"
      },
      "ToolOption": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "type": {
            "type": "string",
            "title": "Type"
          },
          "required": {
            "type": "boolean",
            "title": "Required"
          },
          "description": {
            "type": "string",
            "title": "Description"
          },
          "enum": {
            "anyOf": [
              {
                "items": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "integer"
                    }
                  ]
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Enum"
          },
          "default": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Default"
          },
          "minimum_exclusive": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Minimum Exclusive"
          },
          "maximum": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Maximum"
          },
          "json_schema": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Json Schema"
          }
        },
        "type": "object",
        "required": ["name", "type", "required", "description"],
        "title": "ToolOption"
      },
      "ToolSummaryPublic": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "slug": {
            "type": "string",
            "title": "Slug"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "path": {
            "type": "string",
            "title": "Path"
          },
          "tool_type": {
            "type": "string",
            "title": "Tool Type"
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "priority_score": {
            "type": "integer",
            "title": "Priority Score"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "intro": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Intro"
          },
          "resolved_locale": {
            "type": "string",
            "title": "Resolved Locale"
          }
        },
        "type": "object",
        "required": [
          "id",
          "slug",
          "name",
          "path",
          "tool_type",
          "status",
          "priority_score",
          "title",
          "resolved_locale"
        ],
        "title": "ToolSummaryPublic"
      },
      "TranslationStatus": {
        "properties": {
          "exists": {
            "type": "boolean",
            "title": "Exists"
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BlogTranslationStatus"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": ["exists"],
        "title": "TranslationStatus"
      },
      "UpdateDocument": {
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "title": "Title"
          },
          "description": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2000
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          }
        },
        "type": "object",
        "required": ["title"],
        "title": "UpdateDocument"
      },
      "UploadDetailsResponse": {
        "properties": {
          "upload_id": {
            "type": "string",
            "title": "Upload Id"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "filename": {
            "type": "string",
            "title": "Filename"
          },
          "size_bytes": {
            "type": "integer",
            "title": "Size Bytes"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "title": "Expires At"
          },
          "job_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Job Id"
          }
        },
        "type": "object",
        "required": [
          "upload_id",
          "status",
          "filename",
          "size_bytes",
          "expires_at"
        ],
        "title": "UploadDetailsResponse"
      },
      "UserPublic": {
        "properties": {
          "full_name": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 255
              },
              {
                "type": "null"
              }
            ],
            "title": "Full Name"
          },
          "country": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64
              },
              {
                "type": "null"
              }
            ],
            "title": "Country"
          },
          "timezone": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64
              },
              {
                "type": "null"
              }
            ],
            "title": "Timezone"
          },
          "locale": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 8
              },
              {
                "type": "null"
              }
            ],
            "title": "Locale"
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "email": {
            "type": "string",
            "maxLength": 320,
            "format": "email",
            "title": "Email"
          },
          "hq_user_id": {
            "type": "string",
            "title": "Hq User Id"
          },
          "hq_account_id": {
            "type": "string",
            "title": "Hq Account Id"
          },
          "is_admin": {
            "type": "boolean",
            "title": "Is Admin",
            "default": false
          },
          "resolved_locale": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Resolved Locale"
          }
        },
        "type": "object",
        "required": ["id", "email", "hq_user_id", "hq_account_id"],
        "title": "UserPublic"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          }
        },
        "type": "object",
        "required": ["loc", "msg", "type"],
        "title": "ValidationError"
      },
      "WorkspaceActivityList": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/WorkspaceActivityPublic"
            },
            "type": "array",
            "title": "Data"
          }
        },
        "type": "object",
        "required": ["data"],
        "title": "WorkspaceActivityList"
      },
      "WorkspaceActivityPublic": {
        "properties": {
          "action": {
            "type": "string",
            "title": "Action"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          }
        },
        "type": "object",
        "required": ["action", "created_at"],
        "title": "WorkspaceActivityPublic"
      },
      "WorkspaceDocumentList": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/WorkspaceDocumentPublic"
            },
            "type": "array",
            "title": "Data"
          },
          "has_more": {
            "type": "boolean",
            "title": "Has More"
          },
          "limit": {
            "type": "integer",
            "title": "Limit"
          },
          "offset": {
            "type": "integer",
            "title": "Offset"
          }
        },
        "type": "object",
        "required": ["data", "has_more", "limit", "offset"],
        "title": "WorkspaceDocumentList"
      },
      "WorkspaceDocumentPublic": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "upload_id": {
            "type": "string",
            "format": "uuid",
            "title": "Upload Id"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "filename": {
            "type": "string",
            "title": "Filename"
          },
          "page_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Page Count"
          },
          "size_bytes": {
            "type": "integer",
            "title": "Size Bytes"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "title": "Expires At"
          },
          "retained_until": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retained Until"
          },
          "state": {
            "type": "string",
            "const": "ready",
            "title": "State"
          }
        },
        "type": "object",
        "required": [
          "id",
          "upload_id",
          "title",
          "description",
          "filename",
          "page_count",
          "size_bytes",
          "created_at",
          "expires_at",
          "retained_until",
          "state"
        ],
        "title": "WorkspaceDocumentPublic"
      },
      "WorkspacePreviewURL": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url",
            "description": "Short-lived authorized storage URL. Never log or cache."
          },
          "expires_in_seconds": {
            "type": "integer",
            "maximum": 60.0,
            "minimum": 1.0,
            "title": "Expires In Seconds"
          }
        },
        "type": "object",
        "required": ["url", "expires_in_seconds"],
        "title": "WorkspacePreviewURL"
      }
    },
    "securitySchemes": {
      "APIKeyHeader": {
        "type": "apiKey",
        "description": "Your HQTools PDFHQ project API key. Never include it in browser scripts.",
        "in": "header",
        "name": "x-api-key"
      }
    }
  }
}
