@factify/sdk 0.3.11 → 0.3.13-rc.1

package/openapi.json

@@ -403,6 +403,7 @@
           },
           "owner_user_id": {
             "description": "Owner user ID. If not provided, the authenticated user becomes the owner.\n Authorization: Specifying a different user requires system maintainer role.\n Required when the caller is a service account (service accounts cannot own organizations).\n Pattern: user_[0-9a-hjkmnp-tv-z]{26}",
+            "nullable": true,
             "pattern": "^user_[0-9a-hjkmnp-tv-z]{26}$",
             "title": "owner_user_id",
             "type": "string"
@@ -478,6 +479,27 @@
         "title": "CreateVersionRequest",
         "type": "object"
       },
+      "DailyUsage": {
+        "additionalProperties": false,
+        "description": "DailyUsage represents usage for a single day.",
+        "properties": {
+          "date": {
+            "description": "The date (YYYY-MM-DD format).",
+            "example": "2026-01-15",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "title": "date",
+            "type": "string"
+          },
+          "request_count": {
+            "description": "Request count for this day.",
+            "format": "int32",
+            "title": "request_count",
+            "type": "integer"
+          }
+        },
+        "title": "DailyUsage",
+        "type": "object"
+      },
       "DetachPolicyRequest": {
         "additionalProperties": false,
         "description": "DetachPolicyRequest identifies a policy to detach from a document.",
@@ -729,6 +751,35 @@
         "title": "GetDocumentResponse",
         "type": "object"
       },
+      "GetOrganizationQuotaRequest": {
+        "additionalProperties": false,
+        "description": "GetOrganizationQuotaRequest is a request to get quota status.",
+        "properties": {
+          "organization_id": {
+            "description": "Optional: organization ID to query. If not provided, uses the caller's organization.\n Only admins can query other organizations.",
+            "example": "org_01h2xcejqtf2nbrexx3vqjhp41",
+            "nullable": true,
+            "pattern": "^org_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "organization_id",
+            "type": "string"
+          }
+        },
+        "title": "GetOrganizationQuotaRequest",
+        "type": "object"
+      },
+      "GetOrganizationQuotaResponse": {
+        "additionalProperties": false,
+        "description": "GetOrganizationQuotaResponse returns the quota status.",
+        "properties": {
+          "quota": {
+            "$ref": "#/components/schemas/OrganizationQuota",
+            "description": "The organization's quota status.",
+            "title": "quota"
+          }
+        },
+        "title": "GetOrganizationQuotaResponse",
+        "type": "object"
+      },
       "GetOrganizationRequest": {
         "additionalProperties": false,
         "description": "GetOrganizationRequest identifies an organization to retrieve.",
@@ -762,6 +813,69 @@
         "title": "GetOrganizationResponse",
         "type": "object"
       },
+      "GetUsageHistoryRequest": {
+        "additionalProperties": false,
+        "description": "GetUsageHistoryRequest is a request to get usage history.\ndate_range_valid // end_date must be after start_date\n",
+        "properties": {
+          "end_date": {
+            "description": "End date for the history (exclusive, YYYY-MM-DD format).",
+            "example": "2026-02-01",
+            "maxLength": 10,
+            "minLength": 10,
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "title": "end_date",
+            "type": "string"
+          },
+          "organization_id": {
+            "description": "Optional: organization ID to query. If not provided, uses the caller's organization.",
+            "example": "org_01h2xcejqtf2nbrexx3vqjhp41",
+            "nullable": true,
+            "pattern": "^org_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "organization_id",
+            "type": "string"
+          },
+          "start_date": {
+            "description": "Start date for the history (inclusive, YYYY-MM-DD format).",
+            "example": "2026-01-01",
+            "maxLength": 10,
+            "minLength": 10,
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "title": "start_date",
+            "type": "string"
+          }
+        },
+        "title": "GetUsageHistoryRequest",
+        "type": "object"
+      },
+      "GetUsageHistoryResponse": {
+        "additionalProperties": false,
+        "description": "GetUsageHistoryResponse returns usage history.",
+        "properties": {
+          "daily_usage": {
+            "description": "Daily usage records.",
+            "items": {
+              "$ref": "#/components/schemas/DailyUsage"
+            },
+            "title": "daily_usage",
+            "type": "array"
+          },
+          "organization_id": {
+            "description": "The organization ID.",
+            "example": "org_01h2xcejqtf2nbrexx3vqjhp41",
+            "pattern": "^org_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "organization_id",
+            "type": "string"
+          },
+          "total_requests": {
+            "description": "Total requests in the period.",
+            "format": "int32",
+            "title": "total_requests",
+            "type": "integer"
+          }
+        },
+        "title": "GetUsageHistoryResponse",
+        "type": "object"
+      },
       "GetVersionRequest": {
         "additionalProperties": false,
         "description": "GetVersionRequest identifies a specific version to retrieve.",
@@ -1094,6 +1208,67 @@
         "title": "Organization",
         "type": "object"
       },
+      "OrganizationQuota": {
+        "additionalProperties": false,
+        "description": "OrganizationQuota represents the quota status for an organization.",
+        "properties": {
+          "current_usage": {
+            "description": "Current usage in the billing period.",
+            "format": "int32",
+            "title": "current_usage",
+            "type": "integer"
+          },
+          "effective_limit": {
+            "description": "The effective monthly limit (considers custom_limit if set).",
+            "format": "int32",
+            "title": "effective_limit",
+            "type": "integer"
+          },
+          "is_exceeded": {
+            "description": "Whether quota is exceeded.",
+            "title": "is_exceeded",
+            "type": "boolean"
+          },
+          "organization_id": {
+            "description": "The organization ID.\n Pattern: org_[0-9a-hjkmnp-tv-z]{26}",
+            "example": "org_01h2xcejqtf2nbrexx3vqjhp41",
+            "pattern": "^org_[0-9a-hjkmnp-tv-z]{26}$",
+            "title": "organization_id",
+            "type": "string"
+          },
+          "period_start": {
+            "description": "Start of current billing period.",
+            "format": "date-time",
+            "title": "period_start",
+            "type": "string"
+          },
+          "remaining": {
+            "description": "Remaining requests in the billing period.",
+            "format": "int32",
+            "title": "remaining",
+            "type": "integer"
+          },
+          "reset_at": {
+            "description": "When the quota resets (start of next billing period).",
+            "format": "date-time",
+            "title": "reset_at",
+            "type": "string"
+          },
+          "tier": {
+            "$ref": "#/components/schemas/QuotaTier",
+            "description": "The quota tier (free or custom).",
+            "title": "tier"
+          },
+          "usage_percent": {
+            "description": "Usage as a percentage (0-100+).",
+            "format": "int32",
+            "title": "usage_percent",
+            "type": "integer"
+          }
+        },
+        "title": "OrganizationQuota",
+        "type": "object"
+      },
       "Pagination": {
         "additionalProperties": false,
         "description": "Pagination contains cursor-based pagination metadata.\n Follows Google AIP-158 for pagination field naming.",
@@ -1159,6 +1334,16 @@
           "failed"
         ]
       },
+      "QuotaTier": {
+        "description": "QuotaTier represents the organization's quota tier.",
+        "enum": [
+          "QUOTA_TIER_UNSPECIFIED",
+          "QUOTA_TIER_FREE",
+          "QUOTA_TIER_CUSTOM"
+        ],
+        "title": "QuotaTier",
+        "type": "string"
+      },
       "RevokeApiKeyRequest": {
         "additionalProperties": false,
         "description": "RevokeApiKeyRequest identifies an API key to revoke.",
@@ -1541,7 +1726,14 @@
           },
           "type": "cursor"
         },
-        "x-speakeasy-name-override": "list"
+        "x-speakeasy-name-override": "list",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "listApiKeys",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.apiKeys.list({\n    organizationId: \"\u003cid\u003e\",\n  });\n\n  for await (const page of result) {\n    console.log(page);\n  }\n}\n\nrun();"
+          }
+        ]
       },
       "post": {
         "description": "Creates a new API key for the specified organization. The secret is only returned once in the response and cannot be retrieved later.",
@@ -1590,7 +1782,14 @@
         "tags": [
           "API Keys"
         ],
-        "x-speakeasy-name-override": "create"
+        "x-speakeasy-name-override": "create",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "createApiKey",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.apiKeys.create({\n    name: \"\u003cvalue\u003e\",\n    organizationId: \"\u003cid\u003e\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
       }
     },
     "/v1beta/api-keys/{api_key_id}/revoke": {
@@ -1669,7 +1868,14 @@
         "tags": [
           "API Keys"
         ],
-        "x-speakeasy-name-override": "revoke"
+        "x-speakeasy-name-override": "revoke",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "revokeApiKey",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.apiKeys.revoke({\n    apiKeyId: \"\u003cid\u003e\",\n    body: {},\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
       }
     },
     "/v1beta/documents": {
@@ -1813,7 +2019,14 @@
           },
           "type": "cursor"
         },
-        "x-speakeasy-name-override": "list"
+        "x-speakeasy-name-override": "list",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "listDocuments",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.documents.list({\n    pageToken: \"eyJpZCI6ImRvY18wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0In0\",\n  });\n\n  for await (const page of result) {\n    console.log(page);\n  }\n}\n\nrun();"
+          }
+        ]
       },
       "post": {
         "description": "Creates a new document by uploading a PDF file.",
@@ -1862,7 +2075,14 @@
         "tags": [
           "Documents"
         ],
-        "x-speakeasy-name-override": "create"
+        "x-speakeasy-name-override": "create",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "createDocument",
+            "source": "import { Factify } from \"@factify/sdk\";\nimport { openAsBlob } from \"node:fs\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.documents.create({\n    payload: await openAsBlob(\"example.file\"),\n    title: \"\u003cvalue\u003e\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
       }
     },
     "/v1beta/documents/{document_id}": {
@@ -1917,7 +2137,14 @@
         "tags": [
           "Documents"
         ],
-        "x-speakeasy-name-override": "get"
+        "x-speakeasy-name-override": "get",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "getDocument",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.documents.get({\n    documentId: \"\u003cid\u003e\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
       },
       "patch": {
         "description": "Update document title and description.",
@@ -2000,7 +2227,14 @@
         "tags": [
           "Documents"
         ],
-        "x-speakeasy-name-override": "update"
+        "x-speakeasy-name-override": "update",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "updateDocument",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.documents.update({\n    documentId: \"\u003cid\u003e\",\n    body: {},\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
       }
     },
     "/v1beta/documents/{document_id}/entry_page": {
@@ -2056,7 +2290,14 @@
           "Sharing \u0026 Distribution"
         ],
         "x-speakeasy-group": "entryPages",
-        "x-speakeasy-name-override": "generate"
+        "x-speakeasy-name-override": "generate",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "generateDocumentEntryPage",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.entryPages.generate({\n    documentId: \"\u003cid\u003e\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
       }
     },
     "/v1beta/documents/{document_id}/policies": {
@@ -2148,7 +2389,14 @@
           },
           "type": "cursor"
         },
-        "x-speakeasy-name-override": "list"
+        "x-speakeasy-name-override": "list",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "listDocumentPolicies",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.policies.list({\n    documentId: \"\u003cid\u003e\",\n    pageToken: \"eyJpZCI6InBvbF8wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0IiwiZiI6eyJkb2NfaWQiOiJkb2NfMDFoMnhjZWpxdGYybmJyZXh4M3ZxamhwNDEifX0\",\n  });\n\n  for await (const page of result) {\n    console.log(page);\n  }\n}\n\nrun();"
+          }
+        ]
       },
       "post": {
         "description": "Attach a policy to a document.",
@@ -2225,7 +2473,14 @@
         "tags": [
           "Policies"
         ],
-        "x-speakeasy-name-override": "attach"
+        "x-speakeasy-name-override": "attach",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "attachDocumentPolicy",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.policies.attach({\n    documentId: \"\u003cid\u003e\",\n    body: {\n      policyId: \"\u003cid\u003e\",\n    },\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
       }
     },
     "/v1beta/documents/{document_id}/policies/{policy_id}": {
@@ -2292,7 +2547,14 @@
         "tags": [
           "Policies"
         ],
-        "x-speakeasy-name-override": "detach"
+        "x-speakeasy-name-override": "detach",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "detachDocumentPolicy",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.policies.detach({\n    documentId: \"\u003cid\u003e\",\n    policyId: \"\u003cid\u003e\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
       }
     },
     "/v1beta/documents/{document_id}/versions": {
@@ -2384,7 +2646,14 @@
           },
           "type": "cursor"
         },
-        "x-speakeasy-name-override": "list"
+        "x-speakeasy-name-override": "list",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "listDocumentVersions",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.versions.list({\n    documentId: \"\u003cid\u003e\",\n    pageToken: \"eyJpZCI6InZlcl8wMWgyYWJjZDEyMzRlZmdoNTY3OGprbW5wdCIsImQiOiJuZXh0IiwiZiI6eyJkb2NfaWQiOiJkb2NfMDFoMnhjZWpxdGYybmJyZXh4M3ZxamhwNDEifX0\",\n  });\n\n  for await (const page of result) {\n    console.log(page);\n  }\n}\n\nrun();"
+          }
+        ]
       },
       "post": {
         "description": "Creates a new version by uploading a PDF file.",
@@ -2447,7 +2716,14 @@
         "tags": [
           "Versions"
         ],
-        "x-speakeasy-name-override": "create"
+        "x-speakeasy-name-override": "create",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "createDocumentVersion",
+            "source": "import { Factify } from \"@factify/sdk\";\nimport { openAsBlob } from \"node:fs\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.versions.create({\n    documentId: \"\u003cid\u003e\",\n    body: {\n      payload: await openAsBlob(\"example.file\"),\n    },\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
       }
     },
     "/v1beta/organizations": {
@@ -2526,7 +2802,14 @@
           },
           "type": "cursor"
         },
-        "x-speakeasy-name-override": "list"
+        "x-speakeasy-name-override": "list",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "listOrganizations",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.organizations.list();\n\n  for await (const page of result) {\n    console.log(page);\n  }\n}\n\nrun();"
+          }
+        ]
       },
       "post": {
         "description": "Creates a new organization. The authenticated user becomes the organization owner.",
@@ -2575,7 +2858,14 @@
         "tags": [
           "Organizations"
         ],
-        "x-speakeasy-name-override": "create"
+        "x-speakeasy-name-override": "create",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "createOrganization",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.organizations.create({\n    name: \"\u003cvalue\u003e\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
       }
     },
     "/v1beta/organizations/{organization_id}": {
@@ -2630,7 +2920,164 @@
         "tags": [
           "Organizations"
         ],
-        "x-speakeasy-name-override": "get"
+        "x-speakeasy-name-override": "get",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "getOrganization",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.organizations.get({\n    organizationId: \"\u003cid\u003e\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
+      }
+    },
+    "/v1beta/quota": {
+      "get": {
+        "description": "Returns the current quota status for an organization including usage, limits, tier, and reset date.",
+        "operationId": "getOrganizationQuota",
+        "parameters": [
+          {
+            "description": "Optional: organization ID to query. If not provided, uses the caller's organization.\n Only admins can query other organizations.",
+            "in": "query",
+            "name": "organization_id",
+            "schema": {
+              "description": "Optional: organization ID to query. If not provided, uses the caller's organization.\n Only admins can query other organizations.",
+              "example": "org_01h2xcejqtf2nbrexx3vqjhp41",
+              "pattern": "^org_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "organization_id",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetOrganizationQuotaResponse"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "Get organization quota status",
+        "tags": [
+          "Quota"
+        ],
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "getOrganizationQuota",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.quota.getOrganizationQuota({\n    organizationId: \"org_01h2xcejqtf2nbrexx3vqjhp41\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
+      }
+    },
+    "/v1beta/quota/usage": {
+      "get": {
+        "description": "Returns daily usage records for an organization within a specified date range.",
+        "operationId": "getUsageHistory",
+        "parameters": [
+          {
+            "description": "Optional: organization ID to query. If not provided, uses the caller's organization.",
+            "in": "query",
+            "name": "organization_id",
+            "schema": {
+              "description": "Optional: organization ID to query. If not provided, uses the caller's organization.",
+              "example": "org_01h2xcejqtf2nbrexx3vqjhp41",
+              "pattern": "^org_[0-9a-hjkmnp-tv-z]{26}$",
+              "title": "organization_id",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Start date for the history (inclusive, YYYY-MM-DD format).",
+            "in": "query",
+            "name": "start_date",
+            "schema": {
+              "description": "Start date for the history (inclusive, YYYY-MM-DD format).",
+              "example": "2026-01-01",
+              "maxLength": 10,
+              "minLength": 10,
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+              "title": "start_date",
+              "type": "string"
+            }
+          },
+          {
+            "description": "End date for the history (exclusive, YYYY-MM-DD format).",
+            "in": "query",
+            "name": "end_date",
+            "schema": {
+              "description": "End date for the history (exclusive, YYYY-MM-DD format).",
+              "example": "2026-02-01",
+              "maxLength": 10,
+              "minLength": 10,
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+              "title": "end_date",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetUsageHistoryResponse"
+                }
+              }
+            },
+            "description": "Success"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        },
+        "summary": "Get usage history",
+        "tags": [
+          "Quota"
+        ],
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "getUsageHistory",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.quota.getUsageHistory({\n    organizationId: \"org_01h2xcejqtf2nbrexx3vqjhp41\",\n    startDate: \"2026-01-01\",\n    endDate: \"2026-02-01\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
       }
     },
     "/v1beta/versions/{version_id}": {
@@ -2685,7 +3132,14 @@
         "tags": [
           "Versions"
         ],
-        "x-speakeasy-name-override": "get"
+        "x-speakeasy-name-override": "get",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "getVersion",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.versions.get({\n    versionId: \"\u003cid\u003e\",\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
       },
       "patch": {
         "description": "Update version title and description.",
@@ -2766,7 +3220,14 @@
         "tags": [
           "Versions"
         ],
-        "x-speakeasy-name-override": "update"
+        "x-speakeasy-name-override": "update",
+        "x-codeSamples": [
+          {
+            "lang": "typescript",
+            "label": "updateVersion",
+            "source": "import { Factify } from \"@factify/sdk\";\n\nconst factify = new Factify({\n  bearerAuth: \"\u003cYOUR_BEARER_TOKEN_HERE\u003e\",\n});\n\nasync function run() {\n  const result = await factify.versions.update({\n    versionId: \"\u003cid\u003e\",\n    body: {},\n  });\n\n  console.log(result);\n}\n\nrun();"
+          }
+        ]
       }
     }
   },
@@ -2802,6 +3263,10 @@
       "description": "Generate and manage API keys for authentication.",
       "name": "API Keys"
     },
+    {
+      "description": "Query API usage and quota information for your organization.",
+      "name": "Quota"
+    },
     {
       "description": "Attach and manage access policies for documents.",
       "name": "Policies"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@factify/sdk",
-  "version": "0.3.11",
+  "version": "0.3.13-rc.1",
   "author": "Factify",
   "type": "module",
   "tshy": {