{
  "components": {
    "schemas": {
      "AccountClosure": {
        "additionalProperties": false,
        "properties": {
          "case_id": {
            "format": "uuid",
            "type": "string"
          },
          "completed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "confirmed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "scope": {
            "enum": [
              "account",
              "workspace"
            ],
            "type": "string"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "AccountClosureInput": {
        "additionalProperties": false,
        "properties": {
          "confirm": {
            "const": true,
            "type": "boolean"
          },
          "current_password": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          },
          "scope": {
            "enum": [
              "account",
              "workspace"
            ],
            "type": "string"
          }
        },
        "required": [
          "scope",
          "current_password",
          "confirm",
          "request_id"
        ],
        "type": "object"
      },
      "AccountClosureList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/AccountClosure"
            },
            "type": "array"
          },
          "now": {
            "format": "date-time",
            "type": "string"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "AccountClosureReview": {
        "additionalProperties": false,
        "properties": {
          "acknowledge_finance": {
            "type": "boolean"
          },
          "approve": {
            "type": "boolean"
          },
          "decision": {
            "type": "string"
          }
        },
        "required": [
          "approve",
          "decision"
        ],
        "type": "object"
      },
      "AccountCorrection": {
        "additionalProperties": false,
        "properties": {
          "current_password": {
            "type": "string"
          },
          "email": {
            "format": "email",
            "type": "string"
          },
          "name": {
            "maxLength": 120,
            "type": "string"
          }
        },
        "required": [
          "name",
          "current_password"
        ],
        "type": "object"
      },
      "Activation": {
        "additionalProperties": false,
        "example": {
          "created_at": "2026-10-18T00:00:00Z",
          "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
          "device_name": "Office PC",
          "generation": 1,
          "id": "44444444-4444-4444-8444-444444444444",
          "last_seen_at": "2026-10-18T00:00:00Z",
          "license_id": "33333333-3333-4333-8333-333333333333",
          "product_id": "11111111-1111-4111-8111-111111111111",
          "released_at": null,
          "status": "active",
          "virtual_machine": false
        },
        "properties": {
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "device_id": {
            "description": "পণ্য-পরিসরের ডিভাইস ফিঙ্গারপ্রিন্ট, সাধারণত 64 ছোট হাতের hex অক্ষর, SDK তৈরি করে।",
            "type": "string"
          },
          "device_name": {
            "description": "মানুষের পাঠযোগ্য ডিভাইস লেবেল, নিরাপত্তা পরিচয় নয়।",
            "type": "string"
          },
          "generation": {
            "description": "পুরোনো ডিভাইস ক্রেডেনশিয়াল অবৈধ করতে ব্যবহৃত অ্যাক্টিভেশন জেনারেশন।",
            "type": "integer"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "last_seen_at": {
            "description": "সার্ভারের দেখা সর্বশেষ ডিভাইস কার্যকলাপ টাইমস্ট্যাম্প, UTC।",
            "format": "date-time",
            "type": "string"
          },
          "lease_expires_at": {
            "anyOf": [
              {
                "description": "Floating সিট লিজ মেয়াদ; মেয়াদোত্তীর্ণ সিট পুনরুদ্ধার করা যায়।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "Floating সিট লিজ মেয়াদ; মেয়াদোত্তীর্ণ সিট পুনরুদ্ধার করা যায়।",
                "type": "null"
              }
            ],
            "description": "Floating সিট লিজ মেয়াদ; মেয়াদোত্তীর্ণ সিট পুনরুদ্ধার করা যায়।"
          },
          "license_id": {
            "description": "লাইসেন্স UUID, lv_lic_ গোপন মান থেকে আলাদা।",
            "format": "uuid",
            "type": "string"
          },
          "product_id": {
            "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
            "format": "uuid",
            "type": "string"
          },
          "released_at": {
            "anyOf": [
              {
                "description": "রিলিজ টাইমস্ট্যাম্প; রিলিজ না হওয়া পর্যন্ত null।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "রিলিজ টাইমস্ট্যাম্প; রিলিজ না হওয়া পর্যন্ত null।",
                "type": "null"
              }
            ],
            "description": "রিলিজ টাইমস্ট্যাম্প; রিলিজ না হওয়া পর্যন্ত null।"
          },
          "session_id": {
            "description": "Floating ইনস্ট্যান্স সেশন শনাক্তকারী; node-locked লাইসেন্সে বাদ দেওয়া যায়।",
            "type": "string"
          },
          "status": {
            "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
            "enum": [
              "active",
              "released"
            ],
            "type": "string"
          },
          "virtual_machine": {
            "description": "SDK ভার্চুয়াল মেশিন শনাক্ত করেছে কি না।",
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "product_id",
          "license_id",
          "device_id",
          "virtual_machine",
          "device_name",
          "status",
          "generation",
          "created_at",
          "last_seen_at",
          "released_at"
        ],
        "type": "object"
      },
      "ActivationList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/Activation"
            },
            "type": "array"
          },
          "limit": {
            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
            "type": "integer"
          },
          "offset": {
            "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
            "type": "integer"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total"
        ],
        "type": "object"
      },
      "AdminPlanList": {
        "additionalProperties": false,
        "properties": {
          "currencies": {
            "items": {
              "pattern": "^[A-Z]{3}$",
              "type": "string"
            },
            "type": "array"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/Price"
            },
            "type": "array"
          },
          "settings": {
            "$ref": "#/components/schemas/DefaultPlan"
          }
        },
        "required": [],
        "type": "object"
      },
      "AttemptList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "anyOf": [
              {
                "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
                "items": {
                  "$ref": "#/components/schemas/WebhookAttempt"
                },
                "type": "array"
              },
              {
                "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
                "type": "null"
              }
            ],
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।"
          }
        },
        "required": [],
        "type": "object"
      },
      "Audit": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "description": "অডিট কাজের শনাক্তকারী, যেমন product.create বা license.renew।",
            "type": "string"
          },
          "actor_id": {
            "description": "কাজের জন্য দায়ী অ্যাকাউন্টের UUID।",
            "format": "uuid",
            "type": "string"
          },
          "actor_kind": {
            "description": "কাজের উৎস: session, api_key বা system।",
            "enum": [
              "session",
              "api_key",
              "system"
            ],
            "type": "string"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "request_id": {
            "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
            "type": "string"
          },
          "resource_id": {
            "description": "প্রভাবিত রিসোর্সের UUID।",
            "maxLength": 36,
            "type": "string"
          }
        },
        "required": [
          "id",
          "action",
          "resource_id",
          "created_at"
        ],
        "type": "object"
      },
      "AuditList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/Audit"
            },
            "type": "array"
          },
          "limit": {
            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
            "type": "integer"
          },
          "offset": {
            "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "limit",
          "offset"
        ],
        "type": "object"
      },
      "AutoRenewal": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "description": "শতভাগে অর্থ; লেজার এন্ট্রি ধনাত্মক ক্রেডিট বা ঋণাত্মক ডেবিট হতে পারে।",
            "minimum": 0,
            "type": "integer"
          },
          "currency": {
            "description": "তিন অক্ষরের বড় হাতের মুদ্রা কোড, যেমন USD।",
            "type": "string"
          },
          "enabled": {
            "description": "ওয়েবহুক এন্ডপয়েন্ট সক্ষম কি না।",
            "type": "boolean"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "plan": {
            "description": "প্রকাশিত ক্যাটালগের স্থির বিলিং প্ল্যান শনাক্তকারী।",
            "type": "string"
          },
          "plan_name": {
            "description": "প্ল্যানের প্রদর্শন নাম।",
            "type": "string"
          },
          "policy_version": {
            "description": "স্বয়ংক্রিয় নবায়ন সংরক্ষণের সময় গৃহীত পরিষেবা নীতি সংশোধন।",
            "type": "string"
          },
          "price_version": {
            "description": "স্থির করা মূল্য সংশোধন; পুরোনো ইনপুটের কারণে PLAN_VERSION_CONFLICT হতে পারে।",
            "type": "string"
          },
          "status": {
            "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
            "enum": [
              "disabled",
              "enabled",
              "insufficient_balance",
              "price_changed",
              "plan_changed",
              "plan_unavailable",
              "account_unavailable"
            ],
            "type": "string"
          },
          "term_months": {
            "description": "কেনা মেয়াদে মাসের সংখ্যা।",
            "enum": [
              1,
              3,
              6,
              12
            ],
            "type": "integer"
          },
          "updated_at": {
            "description": "UTC-তে সর্বশেষ আপডেট টাইমস্ট্যাম্প।",
            "format": "date-time",
            "type": "string"
          },
          "version": {
            "description": "স্বয়ংক্রিয় নবায়ন কনফিগারেশন সংশোধন।",
            "type": "string"
          }
        },
        "required": [
          "mode",
          "enabled",
          "plan",
          "plan_name",
          "currency",
          "price_version",
          "term_months",
          "amount_cents",
          "status",
          "version",
          "updated_at"
        ],
        "type": "object"
      },
      "AutoRenewalInput": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "expected_version": {
            "type": "string"
          },
          "overage_accepted": {
            "description": "প্রদর্শিত চার্জযোগ্য অতিরিক্ত ব্যবহারের পৃথক স্পষ্ট অনুমোদন।",
            "type": "boolean"
          },
          "plan": {
            "type": "string"
          },
          "policy_version": {
            "description": "বর্তমানে প্রকাশিত অপরিবর্তনীয় নীতি সংস্করণ। অপারেটর নীতি প্রকাশের পর উভয় পেমেন্ট পরিবেশে সম্মতি-সুরক্ষিত কাজে প্রয়োজন।",
            "type": "string"
          },
          "price_version": {
            "type": "string"
          },
          "term_months": {
            "enum": [
              1,
              3,
              6,
              12
            ],
            "type": "integer"
          },
          "terms_accepted": {
            "description": "স্পষ্ট সম্মতি, ডিফল্টে অনির্বাচিত।",
            "type": "boolean"
          }
        },
        "required": [
          "enabled",
          "expected_version"
        ],
        "type": "object"
      },
      "AutoRenewalResult": {
        "additionalProperties": false,
        "properties": {
          "next_renewal_at": {
            "anyOf": [
              {
                "description": "UTC-তে প্রত্যাশিত পরবর্তী নবায়ন টাইমস্ট্যাম্প; নিষ্ক্রিয় বা অপ্রয়োজনীয় হলে null হতে পারে।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "UTC-তে প্রত্যাশিত পরবর্তী নবায়ন টাইমস্ট্যাম্প; নিষ্ক্রিয় বা অপ্রয়োজনীয় হলে null হতে পারে।",
                "type": "null"
              }
            ],
            "description": "UTC-তে প্রত্যাশিত পরবর্তী নবায়ন টাইমস্ট্যাম্প; নিষ্ক্রিয় বা অপ্রয়োজনীয় হলে null হতে পারে।"
          },
          "setting": {
            "$ref": "#/components/schemas/AutoRenewal",
            "description": "বর্তমান স্বয়ংক্রিয় নবায়ন কনফিগারেশন।"
          }
        },
        "required": [
          "setting",
          "next_renewal_at"
        ],
        "type": "object"
      },
      "BatchInput": {
        "additionalProperties": false,
        "properties": {
          "days": {
            "description": "renew-এর জন্য প্রয়োজন: অতিরিক্ত বৈধতার দিন, 1–36500; অন্য কাজে অব্যবহৃত।",
            "maximum": 36500,
            "minimum": 1,
            "type": "integer"
          },
          "duration_days": {
            "description": "duration_days বাদ দেওয়া create এন্ট্রির সাধারণ মেয়াদ। প্রতিটি এন্ট্রি ওভাররাইড করতে পারে। নিজস্ব মেয়াদহীন timed/trial এন্ট্রিতে প্রয়োজন; perpetual তৈরিতে বাদ দিন।",
            "maximum": 36500,
            "minimum": 1,
            "type": [
              "integer",
              "null"
            ]
          },
          "entries": {
            "description": "create-এর জন্য প্রয়োজন: 1–100 গ্রাহক এন্ট্রি; অন্য কাজে বাদ দিন।",
            "items": {
              "additionalProperties": false,
              "properties": {
                "customer": {
                  "description": "বিক্রেতা নির্ধারিত গ্রাহক লেবেল, গ্রাহক পোর্টাল ইমেইল থেকে আলাদা।",
                  "maxLength": 120,
                  "type": "string"
                },
                "customer_email": {
                  "description": "সংযুক্ত গ্রাহক পোর্টাল ইমেইল; নির্ধারিত না হলে ফাঁকা।",
                  "maxLength": 254,
                  "type": "string"
                },
                "duration_days": {
                  "description": "প্রতি লাইসেন্স তৈরির মেয়াদ; BatchInput.duration_days ওভাররাইড করে। সাধারণ মেয়াদ ব্যবহার করতে বাদ দিন।",
                  "maximum": 36500,
                  "minimum": 1,
                  "type": [
                    "integer",
                    "null"
                  ]
                }
              },
              "required": [],
              "type": "object"
            },
            "maxItems": 100,
            "minItems": 1,
            "type": "array"
          },
          "ids": {
            "description": "renew, revoke ও apply_policy-র জন্য প্রয়োজন: 1–100 পৃথক লাইসেন্স UUID; create-এ বাদ দিন।",
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "maxItems": 100,
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "operation": {
            "description": "কাজের নাম; ব্যাচ create/renew/revoke/apply_policy এবং অফলাইন অনুরোধ activate/deactivate সমর্থন করে।",
            "enum": [
              "create",
              "renew",
              "revoke",
              "apply_policy"
            ],
            "type": "string"
          },
          "policy_id": {
            "description": "create ও apply_policy-র জন্য প্রয়োজন: লক্ষ্য লাইসেন্স নীতি UUID।",
            "format": "uuid",
            "type": "string"
          },
          "preview_token": {
            "description": "apply_policy-র জন্য এনক্রিপ্টেড প্রিভিউ নিশ্চিতকরণ টোকেন প্রয়োজন; 600 সেকেন্ড বৈধ এবং রিসোর্স বদলালে অবৈধ।",
            "type": "string",
            "writeOnly": true
          },
          "product_id": {
            "description": "create-এর জন্য প্রয়োজন: নতুন লাইসেন্সের পণ্য UUID।",
            "format": "uuid",
            "type": "string"
          },
          "request_id": {
            "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "request_id",
          "operation"
        ],
        "type": "object"
      },
      "BatchItem": {
        "additionalProperties": false,
        "example": {
          "customer": "Order #1001",
          "customer_email": "buyer@example.com",
          "duration_days": 30,
          "expires_at": null,
          "first_activated_at": null,
          "id": "33333333-3333-4333-8333-333333333333",
          "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
        },
        "properties": {
          "customer": {
            "description": "বিক্রেতা নির্ধারিত গ্রাহক লেবেল, গ্রাহক পোর্টাল ইমেইল থেকে আলাদা।",
            "type": "string"
          },
          "customer_email": {
            "description": "সংযুক্ত গ্রাহক পোর্টাল ইমেইল; নির্ধারিত না হলে ফাঁকা।",
            "type": "string"
          },
          "duration_days": {
            "description": "প্রথম অ্যাক্টিভেশন থেকে প্রতি লাইসেন্সের দিন। timed/trial ইস্যুতে 1–36500 প্রয়োজন; perpetual-এ অনুপস্থিত/null। নীতিতে কখনো সংরক্ষিত হয় না।",
            "type": [
              "integer",
              "null"
            ]
          },
          "expires_at": {
            "anyOf": [
              {
                "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                "type": "null"
              }
            ],
            "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।"
          },
          "first_activated_at": {
            "anyOf": [
              {
                "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "প্রথম সফল অ্যাক্টিভেশন টাইমস্ট্যাম্প; আগে null এবং নবায়ন বা স্থানান্তরে অপরিবর্তিত।",
                "type": "null"
              }
            ],
            "description": "প্রথম সফল অ্যাক্টিভেশন টাইমস্ট্যাম্প; আগে null এবং নবায়ন বা স্থানান্তরে অপরিবর্তিত।"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "license_key": {
            "description": "অ্যাক্টিভেশনে দেওয়া সম্পূর্ণ গ্রাহক লাইসেন্স কী। পণ্য ইনিশিয়ালাইজেশন কোড ও উদাহরণ ডাউনলোডে এই গোপন মান নেই। অফলাইন অনুরোধ SDK-প্রদত্ত ক্রেডেনশিয়াল ব্যবহার করে।",
            "type": "string"
          },
          "operation": {
            "description": "কাজের নাম; ব্যাচ create/renew/revoke/apply_policy এবং অফলাইন অনুরোধ activate/deactivate সমর্থন করে।",
            "enum": [
              "create",
              "renew",
              "revoke",
              "apply_policy"
            ],
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "BatchResult": {
        "additionalProperties": false,
        "properties": {
          "count": {
            "description": "বর্তমান গোষ্ঠীর সংখ্যা, বা ব্যাচে প্রক্রিয়াকৃত রেকর্ড সংখ্যা।",
            "type": "integer"
          },
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/BatchItem"
            },
            "type": "array"
          },
          "operation": {
            "description": "কাজের নাম; ব্যাচ create/renew/revoke/apply_policy এবং অফলাইন অনুরোধ activate/deactivate সমর্থন করে।",
            "enum": [
              "create",
              "renew",
              "revoke",
              "apply_policy"
            ],
            "type": "string"
          },
          "request_id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "request_id",
          "operation",
          "items",
          "count"
        ],
        "type": "object"
      },
      "BillingEmailPreview": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "link": {
            "format": "uri",
            "type": "string"
          },
          "reply_to": {
            "description": "বিলিং মেইলের প্রকাশ্য সহায়তা ইমেইল ও Reply-To। ফাঁকা হলে যোগাযোগ লুকানো। এটি বিদ্যমান SMTP From ঠিকানা বদলায় না বা ইনবক্স তৈরি করে না।",
            "maxLength": 254,
            "type": "string"
          },
          "subject": {
            "type": "string"
          },
          "to": {
            "format": "email",
            "type": "string"
          }
        },
        "required": [
          "id",
          "to",
          "subject",
          "body",
          "link"
        ],
        "type": "object"
      },
      "BillingEmailTestInput": {
        "additionalProperties": false,
        "properties": {
          "kind": {
            "enum": [
              "purchase_success",
              "expiry_reminder",
              "auto_renewal_success",
              "auto_renewal_problem"
            ],
            "type": "string"
          },
          "locale": {
            "default": "zh",
            "enum": [
              "zh",
              "zh-hant",
              "en",
              "es",
              "hi",
              "ar",
              "fr",
              "bn",
              "pt",
              "id",
              "ur"
            ],
            "type": "string"
          },
          "to": {
            "format": "email",
            "type": "string"
          }
        },
        "required": [
          "kind",
          "to"
        ],
        "type": "object"
      },
      "BillingJob": {
        "additionalProperties": false,
        "properties": {
          "attempts": {
            "description": "কাজের প্রচেষ্টার ক্রমসঞ্চিত সংখ্যা।",
            "type": "integer"
          },
          "available_at": {
            "description": "কাজ চালানোর সর্বপ্রথম UTC সময়।",
            "format": "date-time",
            "type": "string"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "last_error": {
            "description": "সর্বশেষ ব্যর্থতার শ্রেণি; ফাঁকা হতে পারে।",
            "type": "string"
          },
          "month": {
            "description": "UTC মাস YYYY-MM; বাদ দেওয়া কোয়েরি মানে বর্তমান মাস ব্যবহৃত হয়। বিলিং কাজে বন্ধ মাস প্রয়োজন।",
            "type": "string"
          },
          "status": {
            "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
            "enum": [
              "pending",
              "running",
              "done",
              "failed"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "month",
          "status"
        ],
        "type": "object"
      },
      "BillingJobList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/BillingJob"
            },
            "type": "array"
          },
          "limit": {
            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
            "type": "integer"
          },
          "offset": {
            "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
            "type": "integer"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total"
        ],
        "type": "object"
      },
      "BillingNotificationPreference": {
        "additionalProperties": false,
        "properties": {
          "auto_renewal_problem": {
            "default": true,
            "type": "boolean"
          },
          "auto_renewal_success": {
            "default": true,
            "type": "boolean"
          },
          "expiry_reminder": {
            "default": true,
            "type": "boolean"
          },
          "locale": {
            "enum": [
              "zh",
              "zh-hant",
              "en",
              "es",
              "hi",
              "ar",
              "fr",
              "bn",
              "pt",
              "id",
              "ur"
            ],
            "type": "string"
          },
          "purchase_success": {
            "default": true,
            "type": "boolean"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "version": {
            "type": "string"
          }
        },
        "required": [
          "purchase_success",
          "expiry_reminder",
          "auto_renewal_success",
          "auto_renewal_problem",
          "locale",
          "version",
          "updated_at"
        ],
        "type": "object"
      },
      "BillingNotificationPreferenceInput": {
        "additionalProperties": false,
        "properties": {
          "auto_renewal_problem": {
            "default": true,
            "type": "boolean"
          },
          "auto_renewal_success": {
            "default": true,
            "type": "boolean"
          },
          "expected_version": {
            "description": "GET থেকে Version; এখনও সংরক্ষিত নয় এমন পছন্দে ফাঁকা। পুরোনো মান BILLING_EMAIL_PREFERENCE_CONFLICT ফেরত দেয়।",
            "type": "string"
          },
          "expiry_reminder": {
            "default": true,
            "type": "boolean"
          },
          "locale": {
            "enum": [
              "zh",
              "zh-hant",
              "en",
              "es",
              "hi",
              "ar",
              "fr",
              "bn",
              "pt",
              "id",
              "ur"
            ],
            "type": "string"
          },
          "purchase_success": {
            "default": true,
            "type": "boolean"
          }
        },
        "required": [
          "expected_version"
        ],
        "type": "object"
      },
      "BillingNotificationPreferencesResult": {
        "additionalProperties": false,
        "properties": {
          "platform": {
            "$ref": "#/components/schemas/BillingNotificationSettings"
          },
          "preferences": {
            "$ref": "#/components/schemas/BillingNotificationPreference"
          },
          "recipient": {
            "format": "email",
            "type": "string"
          }
        },
        "required": [
          "preferences",
          "platform",
          "recipient"
        ],
        "type": "object"
      },
      "BillingNotificationSettings": {
        "additionalProperties": false,
        "properties": {
          "auto_renewal_problem": {
            "default": true,
            "type": "boolean"
          },
          "auto_renewal_success": {
            "default": true,
            "type": "boolean"
          },
          "expiry_reminder": {
            "default": true,
            "type": "boolean"
          },
          "purchase_success": {
            "default": true,
            "type": "boolean"
          },
          "reminder_days": {
            "default": [
              7
            ],
            "description": "ধারাবাহিক কভারেজ শেষের আগের সীমা, 24-ঘণ্টার দিনে। ঊর্ধ্বক্রমে সংরক্ষিত। দেরিতে শুরু ওয়ার্কার শুধু নিকটতম অবশিষ্ট সীমা বেছে নেয়, সব মিস করা স্মরণিকা নয়।",
            "items": {
              "maximum": 90,
              "minimum": 1,
              "type": "integer"
            },
            "maxItems": 10,
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "support_email": {
            "description": "বিলিং মেইলের প্রকাশ্য সহায়তা ইমেইল ও Reply-To। ফাঁকা হলে যোগাযোগ লুকানো। এটি বিদ্যমান SMTP From ঠিকানা বদলায় না বা ইনবক্স তৈরি করে না।",
            "maxLength": 254,
            "type": "string"
          },
          "version": {
            "type": "string"
          }
        },
        "required": [
          "purchase_success",
          "expiry_reminder",
          "auto_renewal_success",
          "auto_renewal_problem",
          "reminder_days",
          "support_email",
          "version"
        ],
        "type": "object"
      },
      "BillingNotificationSettingsInput": {
        "additionalProperties": false,
        "properties": {
          "auto_renewal_problem": {
            "default": true,
            "type": "boolean"
          },
          "auto_renewal_success": {
            "default": true,
            "type": "boolean"
          },
          "expected_version": {
            "description": "GET থেকে Version। পুরোনো মান BILLING_EMAIL_SETTINGS_CONFLICT ফেরত দেয়।",
            "type": "string"
          },
          "expiry_reminder": {
            "default": true,
            "type": "boolean"
          },
          "purchase_success": {
            "default": true,
            "type": "boolean"
          },
          "reminder_days": {
            "default": [
              7
            ],
            "description": "ধারাবাহিক কভারেজ শেষের আগের সীমা, 24-ঘণ্টার দিনে। ঊর্ধ্বক্রমে সংরক্ষিত। দেরিতে শুরু ওয়ার্কার শুধু নিকটতম অবশিষ্ট সীমা বেছে নেয়, সব মিস করা স্মরণিকা নয়।",
            "items": {
              "maximum": 90,
              "minimum": 1,
              "type": "integer"
            },
            "maxItems": 10,
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "support_email": {
            "description": "বিলিং মেইলের প্রকাশ্য সহায়তা ইমেইল ও Reply-To। ফাঁকা হলে যোগাযোগ লুকানো। এটি বিদ্যমান SMTP From ঠিকানা বদলায় না বা ইনবক্স তৈরি করে না।",
            "maxLength": 254,
            "type": "string"
          }
        },
        "required": [
          "expected_version"
        ],
        "type": "object"
      },
      "BundleInput": {
        "additionalProperties": false,
        "properties": {
          "language": {
            "description": "ডাউনলোড বান্ডলের SDK ভাষা শনাক্তকারী।",
            "enum": [
              "go",
              "java",
              "c",
              "cpp",
              "csharp",
              "python",
              "javascript",
              "rust",
              "ruby"
            ],
            "type": "string"
          }
        },
        "required": [
          "language"
        ],
        "type": "object"
      },
      "BuyPlan": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "overage_accepted": {
            "description": "প্রদর্শিত চার্জযোগ্য অতিরিক্ত ব্যবহারের পৃথক স্পষ্ট অনুমোদন।",
            "type": "boolean"
          },
          "plan": {
            "pattern": "^[a-z][a-z0-9_-]{0,63}$",
            "type": "string"
          },
          "policy_version": {
            "description": "বর্তমানে প্রকাশিত অপরিবর্তনীয় নীতি সংস্করণ। অপারেটর নীতি প্রকাশের পর উভয় পেমেন্ট পরিবেশে সম্মতি-সুরক্ষিত কাজে প্রয়োজন।",
            "type": "string"
          },
          "price_version": {
            "type": "string"
          },
          "renewal": {
            "default": false,
            "description": "স্পষ্ট আগাম নবায়ন। এখন পেমেন্ট নেওয়া হয় ও প্রিপেইড কভারেজ অবিলম্বে বাড়ে। পরবর্তী কোটা চক্র বিদ্যমান পরিশোধিত বা উপহার কভারেজের পরে আসে। বর্তমান ব্যবহার রিসেট হয় না। সর্বশেষ পরিশোধিত প্ল্যান ও মুদ্রায় নবায়ন করুন; মেয়াদোত্তীর্ণ গ্রাহক স্বাভাবিকভাবেও কিনতে পারেন।",
            "type": "boolean"
          },
          "request_id": {
            "maxLength": 80,
            "type": "string"
          },
          "term_months": {
            "default": 1,
            "description": "চুক্তির মেয়াদ। বাদ দিলে ডিফল্ট এক মাস। পুনর্ব্যবহৃত request_id-এ মেয়াদ বদলালে 409 ফেরত আসে।",
            "enum": [
              1,
              3,
              6,
              12
            ],
            "type": "integer"
          },
          "terms_accepted": {
            "description": "স্পষ্ট সম্মতি, ডিফল্টে অনির্বাচিত।",
            "type": "boolean"
          }
        },
        "required": [
          "plan",
          "currency",
          "price_version",
          "request_id"
        ],
        "type": "object"
      },
      "CSRF": {
        "additionalProperties": false,
        "properties": {
          "csrf_token": {
            "type": "string"
          }
        },
        "required": [
          "csrf_token"
        ],
        "type": "object"
      },
      "CancelCustomerRefund": {
        "additionalProperties": false,
        "properties": {
          "confirm_service_stays_cancelled": {
            "description": "পর্যালোচনার আগে পরিষেবা বাতিল ইতিমধ্যে সম্পন্ন হলে প্রয়োজন। স্পষ্ট পরিসরযুক্ত অপেক্ষমাণ আবেদন পরিষেবা থামানো বা পুনরুদ্ধার ছাড়া প্রত্যাহার করা যায়।",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "ChangePassword": {
        "additionalProperties": false,
        "properties": {
          "current_password": {
            "description": "12–128 UTF-8 বাইট, অক্ষর নয়",
            "type": "string",
            "writeOnly": true
          },
          "password": {
            "description": "12–128 UTF-8 বাইট, অক্ষর নয়",
            "type": "string",
            "writeOnly": true
          },
          "password_confirmation": {
            "description": "আবশ্যক এবং পাসওয়ার্ডের সঙ্গে হুবহু মিলতে হবে",
            "type": "string",
            "writeOnly": true
          }
        },
        "required": [
          "current_password",
          "password",
          "password_confirmation"
        ],
        "type": "object"
      },
      "ClosureExportCredential": {
        "additionalProperties": false,
        "properties": {
          "download_url": {
            "type": "string"
          },
          "expires_at": {
            "format": "date-time",
            "type": "string"
          },
          "export_deadline": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "ClosureExportLogin": {
        "additionalProperties": false,
        "properties": {
          "current_password": {
            "type": "string"
          },
          "email": {
            "format": "email",
            "type": "string"
          }
        },
        "required": [
          "email",
          "current_password"
        ],
        "type": "object"
      },
      "CommerceNotice": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "description": "পরিষেবা বিজ্ঞপ্তির বডি।",
            "type": "string"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "effective_at": {
            "anyOf": [
              {
                "description": "বিজ্ঞাপিত পরিবর্তন কার্যকর হওয়ার সময়, বা null।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "বিজ্ঞাপিত পরিবর্তন কার্যকর হওয়ার সময়, বা null।",
                "type": "null"
              }
            ],
            "description": "বিজ্ঞাপিত পরিবর্তন কার্যকর হওয়ার সময়, বা null।"
          },
          "emailed_at": {
            "anyOf": [
              {
                "description": "বিজ্ঞপ্তি ইমেইল ডেলিভারি টাইমস্ট্যাম্প, বা null।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "বিজ্ঞপ্তি ইমেইল ডেলিভারি টাইমস্ট্যাম্প, বা null।",
                "type": "null"
              }
            ],
            "description": "বিজ্ঞপ্তি ইমেইল ডেলিভারি টাইমস্ট্যাম্প, বা null।"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "kind": {
            "description": "লেজার এন্ট্রি বা বিজ্ঞপ্তির শ্রেণি শনাক্তকারী।",
            "type": "string"
          },
          "read_at": {
            "anyOf": [
              {
                "description": "বিজ্ঞপ্তি পড়ার টাইমস্ট্যাম্প, বা null।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "বিজ্ঞপ্তি পড়ার টাইমস্ট্যাম্প, বা null।",
                "type": "null"
              }
            ],
            "description": "বিজ্ঞপ্তি পড়ার টাইমস্ট্যাম্প, বা null।"
          },
          "reference": {
            "description": "ট্রেসিংয়ের জন্য সংশ্লিষ্ট ব্যবসায়িক রেফারেন্স।",
            "type": "string"
          },
          "title": {
            "description": "পরিষেবা বিজ্ঞপ্তির শিরোনাম।",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "CommerceNoticeList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/CommerceNotice"
            },
            "type": "array"
          }
        },
        "required": [
          "items"
        ],
        "type": "object"
      },
      "CommercePolicy": {
        "additionalProperties": false,
        "properties": {
          "documents": {
            "properties": {
              "privacy": {
                "type": "string"
              },
              "refunds": {
                "type": "string"
              },
              "terms": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "locale": {
            "type": "string"
          },
          "pending": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "created_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "effective_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "version": {
                  "type": "string"
                }
              },
              "required": [],
              "type": "object"
            },
            "type": "array"
          },
          "profile": {
            "$ref": "#/components/schemas/OperatorProfile"
          },
          "published": {
            "type": "boolean"
          },
          "ready": {
            "type": "boolean"
          },
          "version": {
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "CommercePolicyInput": {
        "additionalProperties": false,
        "properties": {
          "expected_version": {
            "type": "string"
          },
          "profile": {
            "$ref": "#/components/schemas/OperatorProfile"
          },
          "published": {
            "type": "boolean"
          }
        },
        "required": [
          "profile",
          "published",
          "expected_version"
        ],
        "type": "object"
      },
      "CommerceResult": {
        "additionalProperties": true,
        "type": "object"
      },
      "Confirmation": {
        "additionalProperties": false,
        "properties": {
          "confirm": {
            "const": true,
            "type": "boolean"
          }
        },
        "required": [
          "confirm"
        ],
        "type": "object"
      },
      "Consumption": {
        "additionalProperties": false,
        "properties": {
          "feature": {
            "description": "খরচ করা ফিচারের পরিচয়।",
            "type": "string"
          },
          "limit": {
            "description": "এই কোটার মেয়াদে ফিচার ব্যবহারের সীমা।",
            "type": "integer"
          },
          "overage": {
            "description": "এই পর্যায়ে limit ছাড়ানো ইউনিট, টাকা নয়। নীতি অতিরিক্ত সীমা ঠিক করে।",
            "type": "integer"
          },
          "period": {
            "description": "পর্যায়: মাসে YYYY-MM, দিনে YYYY-MM-DD, মোটে lifetime। দিন/মাস UTC অনুযায়ী।",
            "type": "string"
          },
          "quantity": {
            "description": "এই কাজের চাওয়া ইউনিট, পূর্ণসংখ্যা 1–1000000000।",
            "type": "integer"
          },
          "remaining": {
            "description": "remaining = max(0, limit - used - reserved); অতিরিক্ত ইউনিট বাদে।",
            "type": "integer"
          },
          "reserved": {
            "description": "এই সময়কালের মেয়াদ না ফুরানো সংরক্ষিত ইউনিট; এখনো কাটা হয়নি।",
            "type": "integer"
          },
          "reset_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "পরের রিসেট UTC ISO 8601; lifetime-এ null।"
          },
          "used": {
            "description": "এই সময়কালে নিশ্চিতভাবে কাটা ইউনিট; সংরক্ষণ বাদে।",
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "ConsumptionResult": {
        "additionalProperties": false,
        "properties": {
          "activation_id": {
            "description": "ডিভাইস বাঁধন বা রানটাইম সেশন UUID। পরের অনুরোধে রাখুন; লাইসেন্স কী নয়।",
            "format": "uuid",
            "type": "string"
          },
          "consumption": {
            "$ref": "#/components/schemas/Consumption"
          },
          "heartbeat_seconds": {
            "anyOf": [
              {
                "const": 0
              },
              {
                "maximum": 86400,
                "minimum": 600,
                "type": "integer"
              }
            ],
            "description": "বর্তমান heartbeat ব্যবধান সেকেন্ডে; মিটারিং স্বাক্ষর বা টাইমার নবায়ন করে না।",
            "type": "integer"
          }
        },
        "required": [
          "activation_id",
          "consumption"
        ],
        "type": "object"
      },
      "CustomerAssignment": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "description": "ফাঁকা মান পোর্টাল সংযোগ সরায়",
            "type": "string"
          },
          "name": {
            "description": "মানুষের পড়ার উপযোগী নাম; দৈর্ঘ্যের সীমা দেখুন।",
            "maxLength": 120,
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "type": "object"
      },
      "CustomerControlsInput": {
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "device_enabled"
            ]
          },
          {
            "required": [
              "api_enabled"
            ]
          }
        ],
        "properties": {
          "api_enabled": {
            "type": "boolean"
          },
          "device_enabled": {
            "type": "boolean"
          }
        },
        "required": [],
        "type": "object"
      },
      "CustomerControlsResult": {
        "additionalProperties": false,
        "properties": {
          "api_enabled": {
            "type": "boolean"
          },
          "device_enabled": {
            "type": "boolean"
          }
        },
        "required": [
          "device_enabled",
          "api_enabled"
        ],
        "type": "object"
      },
      "CustomerDataExportInput": {
        "additionalProperties": false,
        "properties": {
          "current_password": {
            "type": "string"
          },
          "reason": {
            "maxLength": 500,
            "type": "string"
          },
          "scope": {
            "enum": [
              "account",
              "workspace"
            ],
            "type": "string"
          }
        },
        "required": [
          "scope",
          "current_password",
          "reason"
        ],
        "type": "object"
      },
      "CustomerLicenses": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "type": "string"
          },
          "items": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "email",
          "items"
        ],
        "type": "object"
      },
      "CustomerOverageConsent": {
        "additionalProperties": false,
        "properties": {
          "overage_accepted": {
            "description": "প্রদর্শিত চার্জযোগ্য অতিরিক্ত ব্যবহারের পৃথক স্পষ্ট অনুমোদন।",
            "type": "boolean"
          },
          "policy_version": {
            "description": "বর্তমানে প্রকাশিত অপরিবর্তনীয় নীতি সংস্করণ। অপারেটর নীতি প্রকাশের পর উভয় পেমেন্ট পরিবেশে সম্মতি-সুরক্ষিত কাজে প্রয়োজন।",
            "type": "string"
          },
          "price_version": {
            "type": "string"
          },
          "terms_accepted": {
            "description": "স্পষ্ট সম্মতি, ডিফল্টে অনির্বাচিত।",
            "type": "boolean"
          }
        },
        "required": [
          "price_version",
          "policy_version",
          "terms_accepted",
          "overage_accepted"
        ],
        "type": "object"
      },
      "CustomerRefundInput": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "type": "string"
          },
          "change_id": {
            "type": "string"
          },
          "confirm_termination": {
            "type": "boolean"
          },
          "incident_id": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "order_id": {
            "type": "string"
          },
          "purchase_id": {
            "type": "string"
          },
          "quote_hash": {
            "type": "string"
          },
          "quoted_at": {
            "format": "date-time",
            "type": "string"
          },
          "reason": {
            "enum": [
              "customer_request",
              "future",
              "wallet",
              "usage_change",
              "platform_failure",
              "statutory",
              "billing_error",
              "failed_delivery"
            ],
            "type": "string"
          },
          "request_id": {
            "type": "string"
          },
          "scope": {
            "description": "স্পষ্ট পরিসরে অনুমোদনের সময় বাতিল হয়; বাদ দিলে স্পষ্ট নিশ্চিতকরণের পরে যোগ্য তাৎক্ষণিক বাতিল অনুমত।",
            "enum": [
              "purchase",
              "service"
            ],
            "type": "string"
          }
        },
        "required": [
          "reason",
          "message",
          "request_id"
        ],
        "type": "object"
      },
      "CustomerRefundQuote": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/RefundQuote"
          },
          {
            "$ref": "#/components/schemas/ScopedRefundPreview"
          }
        ]
      },
      "CustomerRefundQuoteInput": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "type": "string"
          },
          "change_id": {
            "type": "string"
          },
          "confirm_termination": {
            "type": "boolean"
          },
          "incident_id": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "order_id": {
            "type": "string"
          },
          "purchase_id": {
            "type": "string"
          },
          "quote_hash": {
            "type": "string"
          },
          "quoted_at": {
            "format": "date-time",
            "type": "string"
          },
          "reason": {
            "enum": [
              "customer_request",
              "future",
              "wallet",
              "usage_change",
              "platform_failure",
              "statutory",
              "billing_error",
              "failed_delivery"
            ],
            "type": "string"
          },
          "request_id": {
            "type": "string"
          },
          "scope": {
            "description": "স্পষ্ট পরিসরে অনুমোদনের সময় বাতিল হয়; বাদ দিলে স্পষ্ট নিশ্চিতকরণের পরে যোগ্য তাৎক্ষণিক বাতিল অনুমত।",
            "enum": [
              "purchase",
              "service"
            ],
            "type": "string"
          }
        },
        "required": [
          "reason",
          "message"
        ],
        "type": "object"
      },
      "CustomerReleaseInput": {
        "additionalProperties": false,
        "description": "জমা দেওয়ার আগে রিলিজ নিশ্চিত করুন। send_email ঐচ্ছিকভাবে যাচাইকৃত গ্রাহক ঠিকানায় অস্থায়ী কোড সারিতে রাখে; generation পুরোনো ডিভাইস দৃশ্য থেকে রক্ষা করে।",
        "properties": {
          "generation": {
            "minimum": 1,
            "type": "integer"
          },
          "send_email": {
            "type": "boolean"
          }
        },
        "required": [],
        "type": "object"
      },
      "CustomerReleaseResult": {
        "additionalProperties": false,
        "properties": {
          "email_queued": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "status": {
            "const": "released",
            "type": "string"
          },
          "transfer": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TransferCode"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "status",
          "transfer",
          "email_queued"
        ],
        "type": "object"
      },
      "CustomerSession": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "format": "email",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "DatabaseStatus": {
        "additionalProperties": false,
        "properties": {
          "connected": {
            "type": "boolean"
          },
          "database": {
            "type": "string"
          },
          "host": {
            "type": "string"
          },
          "open_connections": {
            "type": "integer"
          },
          "version": {
            "type": "string"
          }
        },
        "required": [
          "connected",
          "host",
          "database"
        ],
        "type": "object"
      },
      "DefaultPlan": {
        "additionalProperties": false,
        "properties": {
          "allow_customer_api_overage": {
            "default": false,
            "description": "শুধু গ্রাহকের API অতিরিক্ত ব্যবহার পছন্দ অনুমোদন করে। ডিভাইস অনুমতি থেকে স্বাধীন। false হলে API ব্যবহার প্রশাসকের নিয়ম অনুসরণ করে। সীমাহীন API সীমাহীন থাকে।",
            "type": "boolean"
          },
          "allow_customer_device_overage": {
            "default": false,
            "description": "শুধু গ্রাহকের ডিভাইস অতিরিক্ত ব্যবহার পছন্দ অনুমোদন করে। false হলে ডিভাইস ব্যবহার প্রশাসকের নিয়ম অনুসরণ করে এবং সংরক্ষিত গ্রাহক পছন্দ পুনরায় সক্ষম না হওয়া পর্যন্ত উপেক্ষিত হয়।",
            "type": "boolean"
          },
          "default_currency": {
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "default_plan": {
            "pattern": "^[a-z][a-z0-9_-]{0,63}$",
            "type": "string"
          }
        },
        "required": [
          "default_plan",
          "default_currency"
        ],
        "type": "object"
      },
      "DeliveryList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "anyOf": [
              {
                "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
                "items": {
                  "$ref": "#/components/schemas/WebhookDelivery"
                },
                "type": "array"
              },
              {
                "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
                "type": "null"
              }
            ],
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।"
          },
          "limit": {
            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
            "type": "integer"
          },
          "offset": {
            "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
            "type": "integer"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "DeviceProfile": {
        "additionalProperties": false,
        "properties": {
          "hardware_id": {
            "description": "পণ্য ও হার্ডওয়্যার পরিচয়ের SHA-256। না পেলে ফাঁকা; বাধ্যতামূলক হার্ডওয়্যার নীতি ফিরিয়ে দেবে।",
            "type": "string"
          },
          "platform": {
            "description": "স্থানীয় OS: windows, linux বা darwin (macOS)।",
            "enum": [
              "windows",
              "linux",
              "darwin"
            ],
            "type": "string"
          },
          "system_id": {
            "description": "পণ্য ও সিস্টেম পরিচয়ের SHA-256: 64 ছোট হেক্স অক্ষর।",
            "pattern": "^[0-9a-f]{64}$",
            "type": "string"
          },
          "version": {
            "const": 3,
            "description": "ডিভাইস ফিঙ্গারপ্রিন্ট প্রোটোকল সংস্করণ, এখন 3।",
            "type": "integer"
          },
          "virtual_machine": {
            "description": "বুলিয়ান: SDK ভার্চুয়াল মেশিন পেয়েছে কি না।",
            "type": "boolean"
          }
        },
        "required": [
          "version",
          "system_id",
          "hardware_id",
          "virtual_machine",
          "platform"
        ],
        "type": "object"
      },
      "DeviceReleaseOperation": {
        "additionalProperties": false,
        "properties": {
          "activation_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "attempts": {
            "description": "Licentivo সংরক্ষিত ব্যর্থ প্রক্রিয়াকরণ প্রচেষ্টার সংখ্যা।",
            "type": "integer"
          },
          "available_at": {
            "description": "রেকর্ড তৈরির UTC সময়।",
            "format": "date-time",
            "type": "string"
          },
          "completed_at": {
            "anyOf": [
              {
                "description": "রেকর্ড তৈরির UTC সময়।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "কাজ সম্পন্নের সময়; অপেক্ষমাণ অবস্থায় বাদ।",
                "type": "null"
              }
            ],
            "description": "কাজ সম্পন্নের সময়; অপেক্ষমাণ অবস্থায় বাদ।"
          },
          "connection_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "created_at": {
            "description": "রেকর্ড তৈরির UTC সময়।",
            "format": "date-time",
            "type": "string"
          },
          "error_code": {
            "description": "স্থির প্রক্রিয়াকরণ বা পর্যালোচনার কারণ; সফলতার পরে ফাঁকা।",
            "type": "string"
          },
          "expected_generation": {
            "description": "প্রত্যাশিত ডিভাইস বাইন্ডিং জেনারেশন, প্রত্যাহার লেনদেনের মধ্যে তুলনা করা হয়।",
            "minimum": 1,
            "type": "integer"
          },
          "license_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "operation_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "source": {
            "description": "এই প্রত্যাহার কাজের উৎস।",
            "enum": [
              "logout",
              "launch",
              "admin"
            ],
            "type": "string"
          },
          "status": {
            "description": "সার্ভার-নিয়ন্ত্রিত বর্তমান জীবনচক্র বা প্রক্রিয়াকরণ অবস্থা।",
            "enum": [
              "pending",
              "succeeded",
              "stale",
              "manual_review"
            ],
            "type": "string"
          }
        },
        "required": [
          "operation_id",
          "license_id",
          "activation_id",
          "expected_generation",
          "source",
          "status"
        ],
        "type": "object"
      },
      "EligibleReleases": {
        "additionalProperties": false,
        "properties": {
          "authorization": {
            "additionalProperties": true,
            "type": "object"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/Release"
            },
            "type": "array"
          }
        },
        "required": [],
        "type": "object"
      },
      "Email": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "format": "email",
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "type": "object"
      },
      "EmailChangeConfirmation": {
        "additionalProperties": false,
        "properties": {
          "token": {
            "maxLength": 2048,
            "minLength": 32,
            "type": "string"
          }
        },
        "required": [
          "token"
        ],
        "type": "object"
      },
      "Empty": {
        "additionalProperties": false,
        "properties": {},
        "required": [],
        "type": "object"
      },
      "EmptyRefundPreviewInput": {
        "additionalProperties": false,
        "properties": {},
        "required": [],
        "type": "object"
      },
      "Error": {
        "additionalProperties": false,
        "example": {
          "error": {
            "code": "UNAUTHENTICATED",
            "message": "Please sign in again"
          },
          "request_id": "55555555-5555-4555-8555-555555555555"
        },
        "properties": {
          "error": {
            "additionalProperties": false,
            "description": "ত্রুটি অবজেক্ট বা ডেলিভারি ব্যর্থতার শ্রেণি; চাইল্ড ফিল্ড বা বর্তমান ধরন দেখুন।",
            "properties": {
              "code": {
                "description": "স্থির মেশিন-পঠনযোগ্য ত্রুটি কোড।",
                "type": "string"
              },
              "message": {
                "description": "মানুষের পড়ার উপযোগী ত্রুটি বার্তা; পরিবর্তে code অনুযায়ী সিদ্ধান্ত নিন।",
                "type": "string"
              }
            },
            "required": [
              "code",
              "message"
            ],
            "type": "object"
          },
          "request_id": {
            "description": "লগের জন্য সার্ভার-তৈরি HTTP UUID; লাইসেন্স বা ইডেমপোটেন্সি ID নয়।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "error",
          "request_id"
        ],
        "type": "object"
      },
      "FeatureReservation": {
        "additionalProperties": false,
        "properties": {
          "consumption": {
            "$ref": "#/components/schemas/Consumption",
            "description": "ব্যবহারের রসিদ: কাটা ইউনিট, মোট ব্যবহার, অবশিষ্ট কোটা ও পরের রিসেট।"
          },
          "expires_at": {
            "description": "সংরক্ষণের শেষ সময় UTC-তে; এর আগে নিশ্চিত করুন।",
            "format": "date-time",
            "type": "string"
          },
          "operation_id": {
            "description": "সংরক্ষণের মূল কাজের আইডি; পুনরায় চেষ্টায় একই রাখুন।",
            "type": "string"
          },
          "reservation_id": {
            "description": "সংরক্ষণের আইডি; নিশ্চিত বা বাতিল করার সময় এটি পাঠান।",
            "format": "uuid",
            "type": "string"
          },
          "status": {
            "description": "pending: কাজ করুন; committed: কাটা হয়েছে; canceled ও expired: কাটা ছাড়াই বন্ধ।",
            "enum": [
              "pending",
              "committed",
              "canceled",
              "expired"
            ],
            "type": "string"
          }
        },
        "required": [
          "reservation_id",
          "operation_id",
          "status",
          "expires_at",
          "consumption"
        ],
        "type": "object"
      },
      "FeatureUsage": {
        "additionalProperties": false,
        "properties": {
          "feature": {
            "description": "মিটার করা ফিচার শনাক্তকারী, নীতির ফিচারে থাকতে হবে।",
            "type": "string"
          },
          "license_id": {
            "description": "লাইসেন্স UUID, lv_lic_ গোপন মান থেকে আলাদা।",
            "format": "uuid",
            "type": "string"
          },
          "period": {
            "description": "ডিফল্ট UTC মাসিক বিলিং স্ন্যাপশট; মিটার নিয়ম month/day/lifetime এবং ব্যবহার সারি নির্দিষ্ট সময়কাল কী ব্যবহার করে।",
            "type": "string"
          },
          "quantity": {
            "description": "এই ফিচার ও সময়ে ক্রমসঞ্চিত ব্যবহৃত পরিমাণ।",
            "type": "integer"
          },
          "updated_at": {
            "description": "UTC-তে সর্বশেষ আপডেট টাইমস্ট্যাম্প।",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "license_id",
          "feature",
          "period",
          "quantity",
          "updated_at"
        ],
        "type": "object"
      },
      "ForumAuthor": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name"
        ],
        "type": "object"
      },
      "ForumImage": {
        "additionalProperties": false,
        "properties": {
          "height": {
            "type": "integer"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "size": {
            "type": "integer"
          },
          "url": {
            "type": "string"
          },
          "width": {
            "type": "integer"
          }
        },
        "required": [
          "id",
          "url",
          "width",
          "height",
          "size"
        ],
        "type": "object"
      },
      "ForumModerationInput": {
        "additionalProperties": false,
        "description": "প্ল্যাটফর্ম প্রশাসক ব্রাউজার সেশন প্রয়োজন। অন্তত একটি ফিল্ড দিন; বাদ দেওয়া ফিল্ড বর্তমান মান রাখে। পিন প্রকাশিত বা লুকানো বিষয়ে প্রযোজ্য, মোছা বিষয়বস্তু ফেরায় না।",
        "minProperties": 1,
        "properties": {
          "hidden": {
            "type": "boolean"
          },
          "locked": {
            "type": "boolean"
          },
          "pinned": {
            "type": "boolean"
          }
        },
        "required": [],
        "type": "object"
      },
      "ForumReply": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "$ref": "#/components/schemas/ForumAuthor"
          },
          "body": {
            "type": "string"
          },
          "can_delete": {
            "type": "boolean"
          },
          "can_edit": {
            "type": "boolean"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "images": {
            "items": {
              "$ref": "#/components/schemas/ForumImage"
            },
            "type": "array"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "body",
          "author",
          "images",
          "created_at",
          "updated_at",
          "can_edit",
          "can_delete"
        ],
        "type": "object"
      },
      "ForumReplyInput": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "maxLength": 12000,
            "minLength": 1,
            "type": "string"
          },
          "image_ids": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "maxItems": 6,
            "type": "array",
            "uniqueItems": true
          }
        },
        "required": [
          "body"
        ],
        "type": "object"
      },
      "ForumTopic": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "$ref": "#/components/schemas/ForumAuthor"
          },
          "body": {
            "type": "string"
          },
          "can_delete": {
            "type": "boolean"
          },
          "can_edit": {
            "type": "boolean"
          },
          "can_moderate": {
            "type": "boolean"
          },
          "category": {
            "enum": [
              "integration",
              "help",
              "ideas",
              "showcase"
            ],
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "images": {
            "items": {
              "$ref": "#/components/schemas/ForumImage"
            },
            "type": "array"
          },
          "language": {
            "enum": [
              "en",
              "zh",
              "zh-hant",
              "hi",
              "es",
              "ar",
              "fr",
              "bn",
              "pt",
              "id",
              "ur"
            ],
            "type": "string"
          },
          "last_reply_at": {
            "format": "date-time",
            "type": "string"
          },
          "locked": {
            "type": "boolean"
          },
          "pinned": {
            "type": "boolean"
          },
          "reply_count": {
            "type": "integer"
          },
          "title": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "body",
          "category",
          "language",
          "locked",
          "pinned",
          "author",
          "images",
          "reply_count",
          "created_at",
          "updated_at",
          "last_reply_at",
          "can_edit",
          "can_delete",
          "can_moderate"
        ],
        "type": "object"
      },
      "ForumTopicDetail": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          },
          "replies": {
            "items": {
              "$ref": "#/components/schemas/ForumReply"
            },
            "type": "array"
          },
          "topic": {
            "$ref": "#/components/schemas/ForumTopic"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [
          "topic",
          "replies",
          "total",
          "limit",
          "offset"
        ],
        "type": "object"
      },
      "ForumTopicInput": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "maxLength": 12000,
            "minLength": 1,
            "type": "string"
          },
          "category": {
            "enum": [
              "integration",
              "help",
              "ideas",
              "showcase"
            ],
            "type": "string"
          },
          "image_ids": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "maxItems": 6,
            "type": "array",
            "uniqueItems": true
          },
          "language": {
            "enum": [
              "en",
              "zh",
              "zh-hant",
              "hi",
              "es",
              "ar",
              "fr",
              "bn",
              "pt",
              "id",
              "ur"
            ],
            "type": "string"
          },
          "title": {
            "maxLength": 180,
            "minLength": 2,
            "type": "string"
          }
        },
        "required": [
          "title",
          "body",
          "category",
          "language"
        ],
        "type": "object"
      },
      "ForumTopicList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/ForumTopic"
            },
            "type": "array"
          },
          "limit": {
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total",
          "limit",
          "offset"
        ],
        "type": "object"
      },
      "ForumTranslationInput": {
        "additionalProperties": false,
        "properties": {
          "reply_id": {
            "format": "uuid",
            "type": "string"
          },
          "target_language": {
            "description": "GET /forum/translation ফেরত ভাষা নির্বাচন করুন।",
            "type": "string"
          }
        },
        "required": [
          "target_language"
        ],
        "type": "object"
      },
      "ForumTranslationResult": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "description": "অনূদিত সাধারণ পাঠ্য। textContent দিয়ে রেন্ডার করুন, HTML হিসেবে নয়।",
            "type": "string"
          },
          "cached": {
            "type": "boolean"
          },
          "provider": {
            "type": "string"
          },
          "source_language": {
            "description": "DeepL শনাক্ত করা উৎস ভাষা।",
            "type": "string"
          },
          "target_language": {
            "description": "নির্বাচিত প্রদানকারীর লক্ষ্য ভাষা।",
            "type": "string"
          },
          "title": {
            "description": "অনূদিত বিষয়ের শিরোনাম; উত্তরে ফাঁকা।",
            "type": "string"
          }
        },
        "required": [
          "title",
          "body",
          "source_language",
          "target_language",
          "cached",
          "provider"
        ],
        "type": "object"
      },
      "Health": {
        "additionalProperties": false,
        "properties": {
          "status": {
            "enum": [
              "ok",
              "ready"
            ],
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "type": "object"
      },
      "ID": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "Invite": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "format": "email",
            "type": "string"
          },
          "name": {
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "role": {
            "enum": [
              "owner",
              "read_only"
            ],
            "type": "string"
          }
        },
        "required": [
          "email",
          "name",
          "role"
        ],
        "type": "object"
      },
      "Invited": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "message"
        ],
        "type": "object"
      },
      "Invoice": {
        "additionalProperties": false,
        "properties": {
          "active_devices": {
            "description": "ডিফল্ট সময়ের দখলের শীর্ষ থেকে বিলিংয়ের জন্য স্থির ডিভাইস সংখ্যা। এটি বর্তমান দখল বা ক্রমসঞ্চিত ডিভাইস ব্যবহার তালিকা নয়।",
            "type": "integer"
          },
          "base_covered": {
            "description": "কেনা প্যাকেজ ইতিমধ্যে ভিত্তি চার্জ কভার করে কি না।",
            "type": "boolean"
          },
          "base_micros": {
            "description": "মুদ্রা এককের দশ লক্ষ ভাগে ভিত্তি চার্জ।",
            "type": "integer"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "description": "তিন অক্ষরের বড় হাতের মুদ্রা কোড, যেমন USD।",
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "finalized_at": {
            "anyOf": [
              {
                "description": "ইনভয়েস চূড়ান্তকরণ টাইমস্ট্যাম্প, বা null।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "ইনভয়েস চূড়ান্তকরণ টাইমস্ট্যাম্প, বা null।",
                "type": "null"
              }
            ],
            "description": "ইনভয়েস চূড়ান্তকরণ টাইমস্ট্যাম্প, বা null।"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "included_devices": {
            "description": "অন্তর্ভুক্ত সক্রিয় ডিভাইস ভাতা।",
            "type": "integer"
          },
          "month": {
            "description": "UTC মাস YYYY-MM; বাদ দেওয়া কোয়েরি মানে বর্তমান মাস ব্যবহৃত হয়। বিলিং কাজে বন্ধ মাস প্রয়োজন।",
            "type": "string"
          },
          "overage_devices": {
            "description": "অন্তর্ভুক্ত ভাতা অতিক্রম করা ডিভাইস।",
            "type": "integer"
          },
          "paid_at": {
            "anyOf": [
              {
                "description": "ইনভয়েস পেমেন্ট টাইমস্ট্যাম্প, বা null।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "ইনভয়েস পেমেন্ট টাইমস্ট্যাম্প, বা null।",
                "type": "null"
              }
            ],
            "description": "ইনভয়েস পেমেন্ট টাইমস্ট্যাম্প, বা null।"
          },
          "payment_mode": {
            "description": "পেমেন্ট পরিবেশ, sandbox বা live।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "plan": {
            "description": "প্রকাশিত ক্যাটালগের স্থির বিলিং প্ল্যান শনাক্তকারী।",
            "type": "string"
          },
          "plan_name": {
            "description": "প্ল্যানের প্রদর্শন নাম।",
            "type": "string"
          },
          "price_version": {
            "description": "স্থির করা মূল্য সংশোধন; পুরোনো ইনপুটের কারণে PLAN_VERSION_CONFLICT হতে পারে।",
            "type": "string"
          },
          "refunded_at": {
            "anyOf": [
              {
                "description": "ইনভয়েস রিফান্ড টাইমস্ট্যাম্প, বা null।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "ইনভয়েস রিফান্ড টাইমস্ট্যাম্প, বা null।",
                "type": "null"
              }
            ],
            "description": "ইনভয়েস রিফান্ড টাইমস্ট্যাম্প, বা null।"
          },
          "status": {
            "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
            "enum": [
              "draft",
              "finalized",
              "void"
            ],
            "type": "string"
          },
          "total_cents": {
            "description": "শতাংশ এককে ইনভয়েস মোট; পেমেন্ট অবস্থার জন্য paid_at দেখুন।",
            "type": "integer"
          },
          "total_micros": {
            "description": "মুদ্রা এককের দশ লক্ষ ভাগে ইনভয়েস মোট।",
            "type": "integer"
          },
          "unit_micros": {
            "description": "প্রতি অতিরিক্ত সক্রিয় ডিভাইসের মূল্য দশ লক্ষ ভাগে।",
            "type": "integer"
          },
          "voided_at": {
            "anyOf": [
              {
                "description": "ইনভয়েস বাতিল টাইমস্ট্যাম্প, বা null।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "ইনভয়েস বাতিল টাইমস্ট্যাম্প, বা null।",
                "type": "null"
              }
            ],
            "description": "ইনভয়েস বাতিল টাইমস্ট্যাম্প, বা null।"
          }
        },
        "required": [
          "id",
          "month",
          "currency",
          "status",
          "total_cents"
        ],
        "type": "object"
      },
      "InvoiceList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/Invoice"
            },
            "type": "array"
          },
          "limit": {
            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
            "type": "integer"
          },
          "offset": {
            "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
            "type": "integer"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total"
        ],
        "type": "object"
      },
      "Key": {
        "additionalProperties": false,
        "properties": {
          "allow_http": {
            "description": "এই কীকে HTTP Launch সাইটের অরিজিন নিবন্ধন বা হালনাগাদ করার অনুমতি দিন, যার মধ্যে পরীক্ষামূলক সার্ভারের ডোমেইন, ব্যক্তিগত IP ঠিকানা ও অভ্যন্তরীণ হোস্টনাম অন্তর্ভুক্ত। Licentivo API অনুরোধ এখনও HTTPS ব্যবহার করে।",
            "type": "boolean"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "expires_at": {
            "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "description": "মানুষের পড়ার উপযোগী নাম; দৈর্ঘ্যের সীমা দেখুন।",
            "type": "string"
          },
          "prefix": {
            "description": "ব্যবস্থাপনা কী-এর প্রথম 14 অক্ষর; শুধু শনাক্তকরণ।",
            "type": "string"
          },
          "revoked": {
            "description": "প্রত্যাহৃত কি না; মেয়াদের জন্য expires_at-ও দেখুন।",
            "type": "boolean"
          },
          "scope": {
            "description": "read পড়তে দেয়; write পড়তে ও লিখতে দেয়। লেখার জন্য সক্রিয় Owner নির্মাতাও প্রয়োজন।",
            "enum": [
              "read",
              "write"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "prefix",
          "scope",
          "revoked",
          "allow_http"
        ],
        "type": "object"
      },
      "KeyBundle": {
        "additionalProperties": false,
        "properties": {
          "keys": {
            "items": {
              "$ref": "#/components/schemas/SigningKey"
            },
            "type": "array"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "protocol": {
            "type": "string"
          },
          "runtime_policy_source": {
            "const": "current_license_policy",
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "keys"
        ],
        "type": "object"
      },
      "KeyCreate": {
        "additionalProperties": false,
        "properties": {
          "allow_http": {
            "default": false,
            "description": "এই কীকে HTTP Launch সাইটের অরিজিন নিবন্ধন বা হালনাগাদ করার অনুমতি দিন, যার মধ্যে পরীক্ষামূলক সার্ভারের ডোমেইন, ব্যক্তিগত IP ঠিকানা ও অভ্যন্তরীণ হোস্টনাম অন্তর্ভুক্ত। Licentivo API অনুরোধ এখনও HTTPS ব্যবহার করে।",
            "type": "boolean"
          },
          "expires_days": {
            "description": "তৈরি থেকে মেয়াদ শেষ পর্যন্ত দিন, 1–365।",
            "maximum": 365,
            "minimum": 1,
            "type": "integer"
          },
          "name": {
            "description": "মানুষের পড়ার উপযোগী নাম; দৈর্ঘ্যের সীমা দেখুন।",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "scope": {
            "description": "read পড়তে দেয়; write পড়তে ও লিখতে দেয়। লেখার জন্য সক্রিয় Owner নির্মাতাও প্রয়োজন।",
            "enum": [
              "read",
              "write"
            ],
            "type": "string"
          }
        },
        "required": [
          "name",
          "scope",
          "expires_days"
        ],
        "type": "object"
      },
      "KeyList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/Key"
            },
            "type": "array"
          },
          "limit": {
            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
            "type": "integer"
          },
          "offset": {
            "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
            "type": "integer"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [
          "items"
        ],
        "type": "object"
      },
      "KeyRotated": {
        "additionalProperties": false,
        "example": {
          "id": "33333333-3333-4333-8333-333333333333",
          "key": "lv_api_BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB",
          "prefix": "lv_api_BBBBBBB"
        },
        "properties": {
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "key": {
            "description": "Full secret returned on creation or rotation. Owners may also view saved license keys on demand in a browser session. Store privately; the prefix cannot authenticate.",
            "type": "string"
          },
          "prefix": {
            "description": "ব্যবস্থাপনা কী-এর প্রথম 14 অক্ষর; শুধু শনাক্তকরণ।",
            "type": "string"
          }
        },
        "required": [
          "id",
          "key",
          "prefix"
        ],
        "type": "object"
      },
      "KeySecret": {
        "additionalProperties": false,
        "example": {
          "expires_at": "2027-01-16T00:00:00Z",
          "id": "33333333-3333-4333-8333-333333333333",
          "key": "lv_api_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
          "prefix": "lv_api_AAAAAAA"
        },
        "properties": {
          "allow_http": {
            "description": "এই কীকে HTTP Launch সাইটের অরিজিন নিবন্ধন বা হালনাগাদ করার অনুমতি দিন, যার মধ্যে পরীক্ষামূলক সার্ভারের ডোমেইন, ব্যক্তিগত IP ঠিকানা ও অভ্যন্তরীণ হোস্টনাম অন্তর্ভুক্ত। Licentivo API অনুরোধ এখনও HTTPS ব্যবহার করে।",
            "type": "boolean"
          },
          "expires_at": {
            "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "key": {
            "description": "শুধু তৈরি/রোটেশনে দেখানো হয়",
            "type": "string"
          },
          "prefix": {
            "description": "ব্যবস্থাপনা কী-এর প্রথম 14 অক্ষর; শুধু শনাক্তকরণ।",
            "type": "string"
          }
        },
        "required": [
          "id",
          "key",
          "prefix"
        ],
        "type": "object"
      },
      "KeyUpdate": {
        "additionalProperties": false,
        "properties": {
          "allow_http": {
            "description": "এই কীকে HTTP Launch সাইটের অরিজিন নিবন্ধন বা হালনাগাদ করার অনুমতি দিন, যার মধ্যে পরীক্ষামূলক সার্ভারের ডোমেইন, ব্যক্তিগত IP ঠিকানা ও অভ্যন্তরীণ হোস্টনাম অন্তর্ভুক্ত। Licentivo API অনুরোধ এখনও HTTPS ব্যবহার করে।",
            "type": "boolean"
          }
        },
        "required": [
          "allow_http"
        ],
        "type": "object"
      },
      "KeyUpdated": {
        "additionalProperties": false,
        "properties": {
          "allow_http": {
            "description": "এই কীকে HTTP Launch সাইটের অরিজিন নিবন্ধন বা হালনাগাদ করার অনুমতি দিন, যার মধ্যে পরীক্ষামূলক সার্ভারের ডোমেইন, ব্যক্তিগত IP ঠিকানা ও অভ্যন্তরীণ হোস্টনাম অন্তর্ভুক্ত। Licentivo API অনুরোধ এখনও HTTPS ব্যবহার করে।",
            "type": "boolean"
          },
          "id": {
            "description": "Unique record identifier.",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "id",
          "allow_http"
        ],
        "type": "object"
      },
      "LaunchCommerceEvent": {
        "additionalProperties": false,
        "properties": {
          "account_ref": {
            "description": "বড়-ছোট অক্ষর সংবেদনশীল অপরিবর্তনীয় ক্রয় অধিকার রেফারেন্স।",
            "pattern": "^[A-Za-z0-9_-]{1,128}$",
            "type": "string"
          },
          "entitlement_ref": {
            "description": "বড়-ছোট অক্ষর সংবেদনশীল অপরিবর্তনীয় ক্রয় অধিকার রেফারেন্স।",
            "pattern": "^[A-Za-z0-9_-]{1,128}$",
            "type": "string"
          },
          "environment": {
            "description": "বাণিজ্য পরিবেশ, সংযোগ ও স্বাক্ষরিত গ্রান্ট উভয়ে পিন করা।",
            "enum": [
              "live",
              "sandbox"
            ],
            "type": "string"
          },
          "event_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "launch_product_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "legacy_license_id": {
            "description": "শুধু entitlement.migrated-এর জন্য। বিদ্যমান লাইসেন্স, মেয়াদ, সক্ষমতা ও ডিভাইস রেকর্ড থাকে; পুরোনো কী ও ডিভাইস ক্রেডেনশিয়াল রানটাইম প্রবেশ হারায়।",
            "format": "uuid",
            "type": "string"
          },
          "plan_ref": {
            "description": "বড়-ছোট অক্ষর সংবেদনশীল অপরিবর্তনীয় ক্রয় অধিকার রেফারেন্স।",
            "pattern": "^[A-Za-z0-9_-]{1,128}$",
            "type": "string"
          },
          "type": {
            "description": "সংস্করণযুক্ত পূর্ণ-স্ন্যাপশট বাণিজ্য ইভেন্ট ধরন।",
            "enum": [
              "entitlement.created",
              "entitlement.renewed",
              "entitlement.upgraded",
              "entitlement.downgraded",
              "entitlement.refunded",
              "entitlement.suspended",
              "entitlement.expired",
              "entitlement.resumed",
              "entitlement.migrated"
            ],
            "type": "string"
          },
          "valid_from": {
            "description": "রেকর্ড তৈরির UTC সময়।",
            "format": "date-time",
            "type": "string"
          },
          "valid_until": {
            "anyOf": [
              {
                "description": "রেকর্ড তৈরির UTC সময়।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "নির্দিষ্ট ক্রয় মেয়াদ শেষ, UTC; শুধু perpetual নীতিতে null।",
                "type": "null"
              }
            ],
            "description": "নির্দিষ্ট ক্রয় মেয়াদ শেষ, UTC; শুধু perpetual নীতিতে null।"
          },
          "version": {
            "description": "এই অধিকার রেফারেন্সের একমুখী বাড়তে থাকা পূর্ণ-স্ন্যাপশট সংস্করণ, ডেলিভারি প্রচেষ্টা সংখ্যা নয়।",
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "event_id",
          "environment",
          "type",
          "entitlement_ref",
          "account_ref",
          "launch_product_id",
          "plan_ref",
          "version",
          "valid_from"
        ],
        "type": "object"
      },
      "LaunchConnection": {
        "additionalProperties": false,
        "properties": {
          "audience": {
            "description": "Launch লগইন assertion-এর নির্ভুল নির্ধারিত প্রাপক।",
            "type": "string"
          },
          "created_at": {
            "description": "রেকর্ড তৈরির UTC সময়।",
            "format": "date-time",
            "type": "string"
          },
          "enabled": {
            "description": "এই বিশ্বাস সংযোগ নতুন রানটাইম ব্যবহার অনুমোদন করতে পারে কি না।",
            "type": "boolean"
          },
          "environment": {
            "description": "বাণিজ্য পরিবেশ, সংযোগ ও স্বাক্ষরিত গ্রান্ট উভয়ে পিন করা।",
            "enum": [
              "live",
              "sandbox"
            ],
            "type": "string"
          },
          "heartbeat_seconds": {
            "description": "সার্ভার-নির্বাচিত অনলাইন যাচাই ব্যবধান সেকেন্ডে।",
            "type": "integer"
          },
          "id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "issuer": {
            "description": "নির্ভুল বিশ্বস্ত Launch উৎস।",
            "type": "string"
          },
          "offline_seconds": {
            "description": "সসীম অনুমত অফলাইন ব্যবধান সেকেন্ডে; শূন্য হলে অনলাইন যাচাই প্রয়োজন।",
            "type": "integer"
          },
          "session_seconds": {
            "description": "অনুমোদন সেশনের সর্বাধিক জীবনকাল সেকেন্ডে।",
            "type": "integer"
          },
          "updated_at": {
            "description": "রেকর্ড তৈরির UTC সময়।",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "issuer",
          "audience",
          "environment",
          "enabled"
        ],
        "type": "object"
      },
      "LaunchConnectionInput": {
        "additionalProperties": false,
        "properties": {
          "audience": {
            "description": "Launch লগইন assertion-এর নির্ভুল নির্ধারিত প্রাপক।",
            "maxLength": 255,
            "minLength": 1,
            "type": "string"
          },
          "enabled": {
            "description": "এই বিশ্বাস সংযোগ নতুন রানটাইম ব্যবহার অনুমোদন করতে পারে কি না।",
            "type": "boolean"
          },
          "environment": {
            "description": "বাণিজ্য পরিবেশ, সংযোগ ও স্বাক্ষরিত গ্রান্ট উভয়ে পিন করা।",
            "enum": [
              "live",
              "sandbox"
            ],
            "type": "string"
          },
          "heartbeat_seconds": {
            "default": 600,
            "description": "সার্ভার-নির্বাচিত অনলাইন যাচাই ব্যবধান সেকেন্ডে।",
            "maximum": 86400,
            "minimum": 600,
            "type": "integer"
          },
          "issuer": {
            "description": "পাথ বা শেষের স্ল্যাশ ছাড়া নির্ভুল বিশ্বস্ত Launch উৎস। HTTPS ডিফল্ট। HTTP-এর জন্য এই অনুরোধের API কী-তে allow_http প্রয়োজন; ব্যক্তিগত IP ও অভ্যন্তরীণ হোস্টনাম সমর্থিত। এই উৎসে কোনো কলব্যাক বা আবিষ্কার অনুরোধ হয় না।",
            "format": "uri",
            "type": "string"
          },
          "offline_seconds": {
            "default": 0,
            "description": "0 হলে অনলাইনে যাচাই করতে হবে। ধনাত্মক অফলাইন মেয়াদ অন্তত 3 × heartbeat_seconds হতে হবে। অ্যাকাউন্টের স্থায়ী অফলাইন অনুমোদন বন্ধ আছে।",
            "maximum": 86400,
            "minimum": 0,
            "type": "integer"
          },
          "public_keys": {
            "additionalProperties": {
              "description": "পিন করা ক্যানোনিক্যাল Base64URL Ed25519 পাবলিক কী, 32 বাইট।",
              "type": "string"
            },
            "description": "কী ID অনুসারে সূচিবদ্ধ Launch Ed25519 পাবলিক কী-এর সম্পূর্ণ পিন করা সেট।",
            "maxProperties": 16,
            "minProperties": 1,
            "type": "object"
          },
          "session_seconds": {
            "default": 86400,
            "description": "অন্তত 3 × heartbeat_seconds।",
            "maximum": 2592000,
            "minimum": 1800,
            "type": "integer"
          }
        },
        "required": [
          "issuer",
          "audience",
          "environment",
          "public_keys",
          "enabled"
        ],
        "type": "object"
      },
      "LaunchDeviceReleaseInput": {
        "additionalProperties": false,
        "properties": {
          "account_ref": {
            "description": "বড়-ছোট অক্ষর সংবেদনশীল অপরিবর্তনীয় ক্রয় অধিকার রেফারেন্স।",
            "pattern": "^[A-Za-z0-9_-]{1,128}$",
            "type": "string"
          },
          "entitlement_ref": {
            "description": "বড়-ছোট অক্ষর সংবেদনশীল অপরিবর্তনীয় ক্রয় অধিকার রেফারেন্স।",
            "pattern": "^[A-Za-z0-9_-]{1,128}$",
            "type": "string"
          },
          "environment": {
            "description": "বাণিজ্য পরিবেশ, সংযোগ ও স্বাক্ষরিত গ্রান্ট উভয়ে পিন করা।",
            "enum": [
              "live",
              "sandbox"
            ],
            "type": "string"
          },
          "expected_generation": {
            "description": "প্রত্যাশিত ডিভাইস বাইন্ডিং জেনারেশন, প্রত্যাহার লেনদেনের মধ্যে তুলনা করা হয়।",
            "minimum": 1,
            "type": "integer"
          },
          "operation_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "operation_id",
          "account_ref",
          "entitlement_ref",
          "environment",
          "expected_generation"
        ],
        "type": "object"
      },
      "LaunchEvent": {
        "additionalProperties": false,
        "properties": {
          "applied_at": {
            "anyOf": [
              {
                "description": "রেকর্ড তৈরির UTC সময়।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "স্ন্যাপশট প্রয়োগ বা পুরোনো হিসেবে শ্রেণিবদ্ধ হওয়ার সময়।",
                "type": "null"
              }
            ],
            "description": "স্ন্যাপশট প্রয়োগ বা পুরোনো হিসেবে শ্রেণিবদ্ধ হওয়ার সময়।"
          },
          "attempts": {
            "description": "Licentivo সংরক্ষিত ব্যর্থ প্রক্রিয়াকরণ প্রচেষ্টার সংখ্যা।",
            "type": "integer"
          },
          "available_at": {
            "description": "রেকর্ড তৈরির UTC সময়।",
            "format": "date-time",
            "type": "string"
          },
          "connection_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "created_at": {
            "description": "রেকর্ড তৈরির UTC সময়।",
            "format": "date-time",
            "type": "string"
          },
          "error_code": {
            "description": "স্থির প্রক্রিয়াকরণ বা পর্যালোচনার কারণ; সফলতার পরে ফাঁকা।",
            "type": "string"
          },
          "event_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "status": {
            "description": "সার্ভার-নিয়ন্ত্রিত বর্তমান জীবনচক্র বা প্রক্রিয়াকরণ অবস্থা।",
            "enum": [
              "pending",
              "applied",
              "stale",
              "manual_review"
            ],
            "type": "string"
          }
        },
        "required": [
          "connection_id",
          "event_id",
          "status",
          "attempts",
          "available_at"
        ],
        "type": "object"
      },
      "LaunchExchangeInput": {
        "additionalProperties": false,
        "properties": {
          "activation_id": {
            "description": "শেষ সফল সক্রিয়করণের data.activation_id। প্রথম activate ছাড়া যাচাই, হার্টবিট, consume ও আনবাইন্ডে আবশ্যক।",
            "format": "uuid",
            "type": "string"
          },
          "app_version": {
            "description": "বর্তমান সংস্করণ major.minor.patch, যেমন 1.0.0। রক্ষণাবেক্ষণ বা সংস্করণ সীমায় আবশ্যক। পুরোনো সংস্করণ বলে ভুল দেবেন না।",
            "pattern": "^$|^(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})$",
            "type": "string"
          },
          "device_id": {
            "description": "পণ্য, সিস্টেম ও হার্ডওয়্যার থেকে SDK গণিত 64 ছোট হাতের হেক্স SHA-256। ইচ্ছামতো স্থির মান দেবেন না।",
            "pattern": "^[0-9a-f]{64}$",
            "type": "string"
          },
          "device_name": {
            "description": "ড্যাশবোর্ডের নাম, সর্বোচ্চ 120 অক্ষর। ডিভাইস পরিচয় নির্ধারণ করে না।",
            "maxLength": 120,
            "type": "string"
          },
          "device_profile": {
            "$ref": "#/components/schemas/DeviceProfile",
            "description": "SDK-তৈরি মেশিন প্রোফাইল। হার্ডওয়্যার, VM প্রত্যাখ্যান বা হার্ডওয়্যার স্থানান্তর নীতি চাইলে দিন।"
          },
          "environment": {
            "description": "বাণিজ্য পরিবেশ, সংযোগ ও স্বাক্ষরিত গ্রান্ট উভয়ে পিন করা।",
            "enum": [
              "live",
              "sandbox"
            ],
            "type": "string"
          },
          "feature": {
            "description": "খরচ করা ফিচারের পরিচয়।",
            "maxLength": 64,
            "type": "string"
          },
          "identity_token": {
            "description": "একবার ব্যবহারযোগ্য নির্দিষ্ট ধরনযুক্ত Ed25519 Launch পরিচয় JWT; কোনো অধিকার দাবি ক্রয় অধিকার হিসেবে বিশ্বাস করা হয় না।",
            "maxLength": 12288,
            "type": "string",
            "writeOnly": true
          },
          "launch_connection_id": {
            "description": "এই Launch অনুমোদন কাজের launch connection id।",
            "format": "uuid",
            "type": "string"
          },
          "license_key": {
            "const": "",
            "description": "বাদ দিন বা ফাঁকা রাখুন। অ্যাকাউন্ট বিনিময় দীর্ঘমেয়াদি লাইসেন্স কী ব্যবহার করে না।",
            "type": "string"
          },
          "product_id": {
            "description": "পণ্য UUID; লাইসেন্সের পণ্যের সঙ্গে মিলবে।",
            "format": "uuid",
            "type": "string"
          },
          "quantity": {
            "description": "এই কাজের চাওয়া ইউনিট, পূর্ণসংখ্যা 1–1000000000।",
            "maximum": 1000000000,
            "minimum": 1,
            "type": "integer"
          },
          "request_logout_ticket": {
            "description": "SDK সক্ষমতা সমঝোতা। বর্তমান বাইন্ডিংয়ের টিকিট সংরক্ষিত না থাকলে শুধু আনলিঙ্ক লগআউট টিকিট অনুরোধ করুন। বৈধ টিকিট আগে থেকে থাকলে বাদ দিন; স্থিতিশীল হার্টবিট অতিরিক্ত টিকিট খোঁজা এড়ায়।",
            "type": "boolean"
          },
          "reservation_id": {
            "description": "সংরক্ষণের আইডি; নিশ্চিত বা বাতিল করার সময় এটি পাঠান।",
            "format": "uuid",
            "type": "string"
          },
          "reservation_seconds": {
            "default": 900,
            "description": "সংরক্ষণের ঐচ্ছিক মেয়াদ 30–3600 সেকেন্ড, ডিফল্ট 900। সময়কাল রিসেট হলে আগে শেষ হয়।",
            "maximum": 3600,
            "minimum": 30,
            "type": "integer"
          },
          "session_id": {
            "description": "ফ্লোটিং-এ আবশ্যক: প্রতি চলন্ত ইনস্ট্যান্সে নতুন UUID, তার সব অনুরোধে একই। ডিভাইসে বাঁধা ধরনে ঐচ্ছিক।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "device_id",
          "identity_token",
          "launch_connection_id",
          "environment"
        ],
        "type": "object"
      },
      "LaunchPlanMappingInput": {
        "additionalProperties": false,
        "properties": {
          "launch_product_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "policy_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "policy_version": {
            "description": "ম্যাপ করা অনুমোদন নীতির প্রত্যাশিত বর্তমান সংস্করণ।",
            "minimum": 1,
            "type": "integer"
          },
          "product_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "launch_product_id",
          "product_id",
          "policy_id",
          "policy_version"
        ],
        "type": "object"
      },
      "LaunchSessionRevocation": {
        "additionalProperties": false,
        "properties": {
          "account_ref": {
            "description": "বড়-ছোট অক্ষর সংবেদনশীল অপরিবর্তনীয় ক্রয় অধিকার রেফারেন্স।",
            "pattern": "^[A-Za-z0-9_-]{1,128}$",
            "type": "string"
          },
          "completed_at": {
            "description": "রেকর্ড তৈরির UTC সময়।",
            "format": "date-time",
            "type": "string"
          },
          "connection_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "created_at": {
            "description": "রেকর্ড তৈরির UTC সময়।",
            "format": "date-time",
            "type": "string"
          },
          "environment": {
            "description": "বাণিজ্য পরিবেশ, সংযোগ ও স্বাক্ষরিত গ্রান্ট উভয়ে পিন করা।",
            "enum": [
              "live",
              "sandbox"
            ],
            "type": "string"
          },
          "event_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "reason": {
            "description": "ঐচ্ছিক অডিট কারণ; ফাঁকা বাদ দেওয়ার সমতুল্য। forced_logout-এ session পরিসর প্রয়োজন; password_changed ও account_disabled-এ account পরিসর প্রয়োজন।",
            "enum": [
              "",
              "forced_logout",
              "password_changed",
              "account_disabled"
            ],
            "type": "string"
          },
          "released_devices": {
            "description": "রিলিজ করা বর্তমান ডিভাইস বাইন্ডিং জেনারেশন; নতুন লগইন বজায় থাকে।",
            "minimum": 0,
            "type": "integer"
          },
          "revoked_before": {
            "description": "account পরিসরে উপস্থিত। নতুন প্রমাণীকরণের auth_time Unix-সেকেন্ড নির্ভুলতায় তুলিত এই UTC কাটঅফের কঠোরভাবে পরে হতে হবে। আগে জানা sid মান স্থায়ীভাবে প্রত্যাহৃত থাকে।",
            "format": "date-time",
            "type": "string"
          },
          "revoked_credentials": {
            "description": "মূল ইভেন্টে নতুন প্রত্যাহৃত ডিভাইস ক্রেডেনশিয়াল।",
            "minimum": 0,
            "type": "integer"
          },
          "revoked_sessions": {
            "description": "মূল ইভেন্টে নতুন প্রত্যাহৃত অনুমোদন সেশন।",
            "minimum": 0,
            "type": "integer"
          },
          "scope": {
            "description": "session এই সংযোগের সব পণ্য ও ডিভাইসে একটি Launch sid প্রত্যাহার করে; account বিদ্যমান সব অ্যাকাউন্ট সেশন প্রত্যাহার করে ও পুরোনো প্রমাণীকরণ assertion প্রত্যাখ্যান করে।",
            "enum": [
              "session",
              "account"
            ],
            "type": "string"
          },
          "sid": {
            "description": "session পরিসরে প্রয়োজন ও অশূন্য; account পরিসরে বাদ দিন বা ফাঁকা রাখুন। এটি Launch লগইন sid, Licentivo অনুমোদন সেশন বা ডিভাইস ID নয়।",
            "pattern": "^[A-Za-z0-9_-]{0,128}$",
            "type": "string"
          },
          "status": {
            "const": "succeeded",
            "description": "সার্ভার-নিয়ন্ত্রিত বর্তমান জীবনচক্র বা প্রক্রিয়াকরণ অবস্থা।",
            "type": "string"
          }
        },
        "required": [
          "connection_id",
          "event_id",
          "environment",
          "account_ref",
          "scope",
          "status",
          "revoked_sessions",
          "revoked_credentials",
          "released_devices",
          "created_at",
          "completed_at"
        ],
        "type": "object"
      },
      "LaunchSessionRevocationInput": {
        "additionalProperties": false,
        "oneOf": [
          {
            "properties": {
              "reason": {
                "enum": [
                  "",
                  "forced_logout"
                ]
              },
              "scope": {
                "const": "session"
              },
              "sid": {
                "description": "বড়-ছোট অক্ষর সংবেদনশীল অপরিবর্তনীয় ক্রয় অধিকার রেফারেন্স।",
                "pattern": "^[A-Za-z0-9_-]{1,128}$",
                "type": "string"
              }
            },
            "required": [
              "sid"
            ]
          },
          {
            "properties": {
              "reason": {
                "enum": [
                  "",
                  "password_changed",
                  "account_disabled"
                ]
              },
              "scope": {
                "const": "account"
              },
              "sid": {
                "const": ""
              }
            }
          }
        ],
        "properties": {
          "account_ref": {
            "description": "বড়-ছোট অক্ষর সংবেদনশীল অপরিবর্তনীয় ক্রয় অধিকার রেফারেন্স।",
            "pattern": "^[A-Za-z0-9_-]{1,128}$",
            "type": "string"
          },
          "environment": {
            "description": "ঐচ্ছিক সামঞ্জস্য পরীক্ষা। সংযোগের পরিবেশ ব্যবহার করতে বাদ দিন বা ফাঁকা রাখুন; অশূন্য মান মিলতে হবে। এই ফিল্ড বিলিং বদলায় না বা বিনামূল্যে অনুমোদন পরীক্ষা দেয় না।",
            "enum": [
              "",
              "live",
              "sandbox"
            ],
            "type": "string"
          },
          "event_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "reason": {
            "description": "ঐচ্ছিক অডিট কারণ; ফাঁকা বাদ দেওয়ার সমতুল্য। forced_logout-এ session পরিসর প্রয়োজন; password_changed ও account_disabled-এ account পরিসর প্রয়োজন।",
            "enum": [
              "",
              "forced_logout",
              "password_changed",
              "account_disabled"
            ],
            "type": "string"
          },
          "scope": {
            "description": "session এই সংযোগের সব পণ্য ও ডিভাইসে একটি Launch sid প্রত্যাহার করে; account বিদ্যমান সব অ্যাকাউন্ট সেশন প্রত্যাহার করে ও পুরোনো প্রমাণীকরণ assertion প্রত্যাখ্যান করে।",
            "enum": [
              "session",
              "account"
            ],
            "type": "string"
          },
          "sid": {
            "description": "session পরিসরে প্রয়োজন ও অশূন্য; account পরিসরে বাদ দিন বা ফাঁকা রাখুন। এটি Launch লগইন sid, Licentivo অনুমোদন সেশন বা ডিভাইস ID নয়।",
            "pattern": "^[A-Za-z0-9_-]{0,128}$",
            "type": "string"
          }
        },
        "required": [
          "event_id",
          "account_ref",
          "scope"
        ],
        "type": "object"
      },
      "Lease": {
        "additionalProperties": false,
        "properties": {
          "key_id": {
            "description": "স্বাক্ষর পাবলিক কী UUID; পণ্যের trusted_keys-এ থাকতে হবে।",
            "format": "uuid",
            "type": "string"
          },
          "payload": {
            "description": "মূল লাইসেন্স JSON বাইটের প্যাডিংবিহীন Base64URL। ডিকোড করা শুধু পড়ার জন্য; স্বাক্ষর যাচাই আবশ্যক।",
            "type": "string"
          },
          "signature": {
            "description": "Base64URL-এ Ed25519 স্বাক্ষর। LicenovaLease/v1 পাঠ্য, একটি newline এবং ডিকোড করা পে-লোডের মূল JSON বাইট যাচাই করুন। JSON পুনরায় serialize করবেন না। ডিকোড করা স্বাক্ষর 64 বাইট।",
            "type": "string"
          },
          "version": {
            "const": 1,
            "description": "স্বাক্ষর এনভেলপ প্রোটোকল সংস্করণ, এখন 1।",
            "type": "integer"
          }
        },
        "required": [
          "version",
          "key_id",
          "payload",
          "signature"
        ],
        "type": "object"
      },
      "LeaseClaims": {
        "additionalProperties": false,
        "description": "মূল স্বাক্ষরিত পেলোড বাইট ডিকোড করুন। runtime_policy ছাড়া TTL সর্বাধিক 86400 সেকেন্ড; অন্যথায় স্বাক্ষরিত নীতি প্রয়োগ করুন। স্বাক্ষর/প্রসঙ্গ যাচাই ছাড়া পেলোড বিশ্বাস করবেন না।",
        "properties": {
          "activation_id": {
            "format": "uuid",
            "type": "string"
          },
          "capabilities": {
            "$ref": "#/components/schemas/SignedCapabilities"
          },
          "device_id": {
            "pattern": "^[0-9a-f]{64}$",
            "type": "string"
          },
          "expires_at": {
            "maximum": 253402300799,
            "type": "integer"
          },
          "features": {
            "items": {
              "pattern": "^[A-Za-z0-9_.-]{1,64}$",
              "type": "string"
            },
            "maxItems": 32,
            "type": "array",
            "uniqueItems": true
          },
          "issued_at": {
            "type": "integer"
          },
          "key_id": {
            "format": "uuid",
            "type": "string"
          },
          "license_id": {
            "format": "uuid",
            "type": "string"
          },
          "max_devices": {
            "maximum": 10000,
            "minimum": 1,
            "type": "integer"
          },
          "mode": {
            "enum": [
              "perpetual",
              "timed",
              "trial"
            ],
            "type": "string"
          },
          "offline_request_id": {
            "format": "uuid",
            "type": "string"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "runtime_policy": {
            "$ref": "#/components/schemas/RuntimePolicy"
          },
          "tenant_id": {
            "format": "uuid",
            "type": "string"
          },
          "version": {
            "const": 1,
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "LegalAcceptance": {
        "additionalProperties": false,
        "properties": {
          "accepted_at": {
            "format": "date-time",
            "type": "string"
          },
          "api_overage_accepted": {
            "type": "boolean"
          },
          "device_overage_accepted": {
            "type": "boolean"
          },
          "digest": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "mode": {
            "type": "string"
          },
          "overage_accepted": {
            "type": "boolean"
          },
          "price_version": {
            "type": "string"
          },
          "reference": {
            "type": "string"
          },
          "scope": {
            "type": "string"
          },
          "version": {
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "LegalAcceptanceList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/LegalAcceptance"
            },
            "type": "array"
          },
          "now": {
            "format": "date-time",
            "type": "string"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "LegalConsent": {
        "additionalProperties": false,
        "properties": {
          "overage_accepted": {
            "description": "প্রদর্শিত চার্জযোগ্য অতিরিক্ত ব্যবহারের পৃথক স্পষ্ট অনুমোদন।",
            "type": "boolean"
          },
          "policy_version": {
            "description": "বর্তমানে প্রকাশিত অপরিবর্তনীয় নীতি সংস্করণ। অপারেটর নীতি প্রকাশের পর উভয় পেমেন্ট পরিবেশে সম্মতি-সুরক্ষিত কাজে প্রয়োজন।",
            "type": "string"
          },
          "terms_accepted": {
            "description": "স্পষ্ট সম্মতি, ডিফল্টে অনির্বাচিত।",
            "type": "boolean"
          }
        },
        "required": [],
        "type": "object"
      },
      "License": {
        "additionalProperties": false,
        "description": "প্রথম সফল অ্যাক্টিভেশন পর্যন্ত মেয়াদ null। ইস্যুতে মেয়াদের স্ন্যাপশট নেওয়া হয়; পুনঃঅ্যাক্টিভেশন কখনো রিসেট করে না।",
        "example": {
          "created_at": "2026-10-18T00:00:00Z",
          "customer": "Order #1001",
          "duration_days": 30,
          "expires_at": null,
          "features": [
            "export"
          ],
          "first_activated_at": null,
          "id": "33333333-3333-4333-8333-333333333333",
          "key_prefix": "lv_lic_AAAAAAA",
          "max_devices": 1,
          "mode": "timed",
          "policy_id": "22222222-2222-4222-8222-222222222222",
          "policy_version": 1,
          "product_id": "11111111-1111-4111-8111-111111111111",
          "status": "active",
          "updated_at": "2026-10-18T00:00:00Z"
        },
        "properties": {
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "customer": {
            "description": "বিক্রেতা নির্ধারিত গ্রাহক লেবেল, গ্রাহক পোর্টাল ইমেইল থেকে আলাদা।",
            "type": "string"
          },
          "duration_days": {
            "description": "প্রথম অ্যাক্টিভেশন থেকে প্রতি লাইসেন্সের দিন। timed/trial ইস্যুতে 1–36500 প্রয়োজন; perpetual-এ অনুপস্থিত/null। নীতিতে কখনো সংরক্ষিত হয় না।",
            "type": [
              "integer",
              "null"
            ]
          },
          "expires_at": {
            "anyOf": [
              {
                "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                "type": "null"
              }
            ],
            "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।"
          },
          "features": {
            "description": "সর্বাধিক 32 পৃথক ফিচার শনাক্তকারী, প্রতিটি 1–64 ASCII বর্ণ, সংখ্যা, বিন্দু, ড্যাশ বা আন্ডারস্কোর।",
            "items": {
              "pattern": "^[A-Za-z0-9_.-]{1,64}$",
              "type": "string"
            },
            "maxItems": 32,
            "type": "array",
            "uniqueItems": true
          },
          "first_activated_at": {
            "anyOf": [
              {
                "description": "প্রথম সফল অ্যাক্টিভেশন টাইমস্ট্যাম্প; আগে null এবং নবায়ন বা স্থানান্তরে অপরিবর্তিত।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "প্রথম সফল অ্যাক্টিভেশন টাইমস্ট্যাম্প; আগে null এবং নবায়ন বা স্থানান্তরে অপরিবর্তিত।",
                "type": "null"
              }
            ],
            "description": "প্রথম সফল অ্যাক্টিভেশন টাইমস্ট্যাম্প; আগে null এবং নবায়ন বা স্থানান্তরে অপরিবর্তিত।"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "key_prefix": {
            "description": "শনাক্তকরণ/অনুসন্ধানের জন্য সংক্ষিপ্ত লাইসেন্স-কী প্রিফিক্স, প্রমাণীকরণের জন্য নয়।",
            "type": "string"
          },
          "max_devices": {
            "description": "প্রতি লাইসেন্স সর্বাধিক সমসাময়িক ডিভাইস বা floating সিট।",
            "type": "integer"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "perpetual",
              "timed",
              "trial"
            ],
            "type": "string"
          },
          "policy_id": {
            "description": "নীতি UUID; ইস্যুর সময় পণ্যের অন্তর্ভুক্ত হতে হবে।",
            "format": "uuid",
            "type": "string"
          },
          "policy_version": {
            "description": "নীতি সংশোধন; পুরোনো লেখা ঠেকাতে সম্পূর্ণ সক্ষমতা সম্পাদনায় বর্তমান মান পাঠান।",
            "type": "integer"
          },
          "product_id": {
            "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
            "format": "uuid",
            "type": "string"
          },
          "status": {
            "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
            "enum": [
              "active",
              "expired",
              "suspended",
              "revoked"
            ],
            "type": "string"
          },
          "updated_at": {
            "description": "UTC-তে সর্বশেষ আপডেট টাইমস্ট্যাম্প।",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "product_id",
          "key_prefix",
          "mode",
          "status"
        ],
        "type": "object"
      },
      "LicenseCapabilities": {
        "additionalProperties": false,
        "example": {
          "license_id": "33333333-3333-4333-8333-333333333333",
          "license_model": "node_locked",
          "maintenance_days": 0,
          "maintenance_until": null,
          "max_version": "",
          "min_version": "",
          "product_id": "11111111-1111-4111-8111-111111111111",
          "updated_at": "2026-10-18T00:00:00Z"
        },
        "properties": {
          "license_id": {
            "description": "লাইসেন্স UUID, lv_lic_ গোপন মান থেকে আলাদা।",
            "format": "uuid",
            "type": "string"
          },
          "license_model": {
            "description": "node_locked ডিভাইস বাইন্ডিং বা floating সিট।",
            "enum": [
              "node_locked",
              "floating"
            ],
            "type": "string"
          },
          "maintenance_days": {
            "description": "প্রথম অ্যাক্টিভেশন থেকে রক্ষণাবেক্ষণ দিন; 0 মানে রক্ষণাবেক্ষণ কাটঅফ নেই।",
            "type": "integer"
          },
          "maintenance_until": {
            "anyOf": [
              {
                "description": "নতুন রিলিজের রক্ষণাবেক্ষণ কাটঅফ; অ্যাক্টিভেশনের আগে বা সীমাহীন হলে null হতে পারে।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "নতুন রিলিজের রক্ষণাবেক্ষণ কাটঅফ; অ্যাক্টিভেশনের আগে বা সীমাহীন হলে null হতে পারে।",
                "type": "null"
              }
            ],
            "description": "নতুন রিলিজের রক্ষণাবেক্ষণ কাটঅফ; অ্যাক্টিভেশনের আগে বা সীমাহীন হলে null হতে পারে।"
          },
          "max_version": {
            "description": "সর্বোচ্চ অনুমোদিত অ্যাপ সংস্করণ; ফাঁকা মানে ঊর্ধ্বসীমা নেই।",
            "type": "string"
          },
          "min_version": {
            "description": "সর্বনিম্ন অনুমোদিত অ্যাপ সংস্করণ; ফাঁকা মানে নিম্নসীমা নেই।",
            "type": "string"
          },
          "product_id": {
            "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
            "format": "uuid",
            "type": "string"
          },
          "updated_at": {
            "description": "UTC-তে সর্বশেষ আপডেট টাইমস্ট্যাম্প।",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "license_id",
          "product_id",
          "license_model",
          "maintenance_days",
          "maintenance_until",
          "min_version",
          "max_version",
          "updated_at"
        ],
        "type": "object"
      },
      "LicenseCapabilityResult": {
        "additionalProperties": false,
        "example": {
          "customer_email": "buyer@example.com",
          "license": {
            "license_id": "33333333-3333-4333-8333-333333333333",
            "license_model": "node_locked",
            "maintenance_days": 0,
            "maintenance_until": null,
            "max_version": "",
            "min_version": "",
            "product_id": "11111111-1111-4111-8111-111111111111",
            "updated_at": "2026-10-18T00:00:00Z"
          },
          "meter_rules": [],
          "usage": null
        },
        "properties": {
          "customer_email": {
            "description": "সংযুক্ত গ্রাহক পোর্টাল ইমেইল; নির্ধারিত না হলে ফাঁকা।",
            "type": "string"
          },
          "license": {
            "$ref": "#/components/schemas/LicenseCapabilities",
            "description": "লাইসেন্স সক্ষমতা স্ন্যাপশট।"
          },
          "meter_rules": {
            "description": "ফিচার মিটারিং নিয়ম; ফাঁকা মানে কনফিগার করা নেই।",
            "items": {
              "additionalProperties": false,
              "properties": {
                "allow_overage": {
                  "description": "অতিরিক্ত ফিচার ব্যবহার অনুমোদিত কি না।",
                  "type": "boolean"
                },
                "feature": {
                  "description": "মিটার করা ফিচার শনাক্তকারী, নীতির ফিচারে থাকতে হবে।",
                  "pattern": "^[A-Za-z0-9_.-]{1,64}$",
                  "type": "string"
                },
                "limit": {
                  "description": "প্রতি মিটারিং সময়ে অন্তর্ভুক্ত ফিচার ব্যবহার (পৃষ্ঠাবিন্যাস সীমা নয়)।",
                  "maximum": 1000000000000,
                  "minimum": 0,
                  "type": "integer"
                },
                "max_overage": {
                  "description": "সর্বাধিক অনুমোদিত অতিরিক্ত ব্যবহার; allow_overage false হলে নিষ্ক্রিয়।",
                  "maximum": 1000000000000,
                  "minimum": 0,
                  "type": "integer"
                },
                "period": {
                  "description": "ডিফল্ট UTC মাসিক বিলিং স্ন্যাপশট; মিটার নিয়ম month/day/lifetime এবং ব্যবহার সারি নির্দিষ্ট সময়কাল কী ব্যবহার করে।",
                  "enum": [
                    "month",
                    "day",
                    "lifetime"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "feature",
                "limit",
                "period"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "usage": {
            "anyOf": [
              {
                "description": "প্রকৃত ফিচার ব্যবহার রেকর্ড; ফাঁকা হলে null হতে পারে।",
                "items": {
                  "$ref": "#/components/schemas/FeatureUsage"
                },
                "type": "array"
              },
              {
                "description": "প্রকৃত ফিচার ব্যবহার রেকর্ড; ফাঁকা হলে null হতে পারে।",
                "type": "null"
              }
            ],
            "description": "প্রকৃত ফিচার ব্যবহার রেকর্ড; ফাঁকা হলে null হতে পারে।"
          }
        },
        "required": [],
        "type": "object"
      },
      "LicenseCreate": {
        "additionalProperties": false,
        "description": "নিজস্ব duration_days দিয়ে লাইসেন্স ইস্যু করুন। timed/trial লাইসেন্সে 1–36500 দিন প্রয়োজন; perpetual লাইসেন্সে অনুপস্থিত/null প্রয়োজন। প্রথম সফল অ্যাক্টিভেশনে সময় গণনা শুরু।",
        "properties": {
          "customer": {
            "description": "ড্যাশবোর্ডে খোঁজার গ্রাহক নাম বা অর্ডার পরিচয়, সর্বোচ্চ 254 অক্ষর।",
            "maxLength": 254,
            "type": "string"
          },
          "customer_email": {
            "description": "সংযুক্ত গ্রাহক পোর্টাল ইমেইল; নির্ধারিত না হলে ফাঁকা।",
            "format": "email",
            "maxLength": 254,
            "type": "string"
          },
          "duration_days": {
            "description": "প্রথম সফল অ্যাক্টিভেশন থেকে লাইসেন্স মেয়াদ দিন হিসেবে। timed/trial ইস্যুতে প্রয়োজন; perpetual লাইসেন্সে বাদ দিন বা null। নীতি থেকে কখনো উত্তরাধিকার হয় না।",
            "maximum": 36500,
            "minimum": 1,
            "type": [
              "integer",
              "null"
            ]
          },
          "policy_id": {
            "description": "এই পণ্যের লাইসেন্স নীতির UUID।",
            "format": "uuid",
            "type": "string"
          },
          "product_id": {
            "description": "পণ্য ID (UUID).",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "policy_id"
        ],
        "type": "object"
      },
      "LicenseKeyReveal": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "key": {
            "description": "Original full license key, revealed only to a current Owner session.",
            "type": "string"
          },
          "key_prefix": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "key",
          "key_prefix"
        ],
        "type": "object"
      },
      "LicenseList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/License"
            },
            "type": "array"
          },
          "limit": {
            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
            "type": "integer"
          },
          "offset": {
            "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
            "type": "integer"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total",
          "limit",
          "offset"
        ],
        "type": "object"
      },
      "LicenseSecret": {
        "additionalProperties": false,
        "example": {
          "duration_days": 30,
          "expires_at": null,
          "first_activated_at": null,
          "id": "33333333-3333-4333-8333-333333333333",
          "key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
          "key_prefix": "lv_lic_AAAAAAA"
        },
        "properties": {
          "duration_days": {
            "description": "প্রথম সক্রিয়করণ থেকে বৈধ দিন; স্থায়ী লাইসেন্সে null।",
            "type": [
              "integer",
              "null"
            ]
          },
          "expires_at": {
            "anyOf": [
              {
                "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                "type": "null"
              }
            ],
            "description": "লাইসেন্সের চূড়ান্ত মেয়াদ, UTC ISO 8601; প্রথম সক্রিয়করণের আগে ও স্থায়ী লাইসেন্সে null।"
          },
          "first_activated_at": {
            "anyOf": [
              {
                "description": "প্রথম সফল অ্যাক্টিভেশন টাইমস্ট্যাম্প; আগে null এবং নবায়ন বা স্থানান্তরে অপরিবর্তিত।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "প্রথম সফল অ্যাক্টিভেশন টাইমস্ট্যাম্প; আগে null এবং নবায়ন বা স্থানান্তরে অপরিবর্তিত।",
                "type": "null"
              }
            ],
            "description": "প্রথম সফল সক্রিয়করণ, UTC ISO 8601; আগে null। ডিভাইস বদলে নতুন হয় না।"
          },
          "id": {
            "description": "খোঁজ, নবায়ন বা বাতিলের লাইসেন্স UUID। সক্রিয়করণ কী নয়।",
            "format": "uuid",
            "type": "string"
          },
          "key": {
            "description": "lv_lic_ দিয়ে শুরু সম্পূর্ণ কী, ইস্যুর সময় একবার দেখা যায়। বিক্রেতা গোপনে রাখবেন ও গ্রাহককে দেবেন।",
            "type": "string"
          },
          "key_prefix": {
            "description": "ড্যাশবোর্ডে চেনার কী উপসর্গ; সক্রিয় করা যাবে না।",
            "type": "string"
          }
        },
        "required": [
          "id",
          "key",
          "key_prefix"
        ],
        "type": "object"
      },
      "LicenseUpdate": {
        "additionalProperties": false,
        "properties": {
          "customer": {
            "description": "বিক্রেতা নির্ধারিত গ্রাহক লেবেল, গ্রাহক পোর্টাল ইমেইল থেকে আলাদা।",
            "maxLength": 254,
            "type": "string"
          },
          "features": {
            "description": "সর্বাধিক 32 পৃথক ফিচার শনাক্তকারী, প্রতিটি 1–64 ASCII বর্ণ, সংখ্যা, বিন্দু, ড্যাশ বা আন্ডারস্কোর।",
            "items": {
              "pattern": "^[A-Za-z0-9_.-]{1,64}$",
              "type": "string"
            },
            "maxItems": 32,
            "type": "array",
            "uniqueItems": true
          },
          "max_devices": {
            "description": "প্রতি লাইসেন্স সর্বাধিক সমসাময়িক ডিভাইস বা floating সিট।",
            "maximum": 10000,
            "minimum": 1,
            "type": "integer"
          },
          "policy_id": {
            "description": "এই লাইসেন্সকে একই পণ্যের একটি নীতিতে পরিবর্তন করুন। নীতি পরিবর্তনের জন্য বর্তমান preview_token প্রয়োজন; লাইসেন্স কী, মূল মেয়াদ এবং ব্যবহার সংরক্ষিত থাকে।",
            "format": "uuid",
            "type": "string"
          },
          "preview_token": {
            "description": "এই লাইসেন্স এবং লক্ষ্য নীতির জন্য POST /licenses/policy-preview থেকে ফেরত পাওয়া টোকেন।",
            "type": "string"
          },
          "status": {
            "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
            "enum": [
              "active",
              "suspended",
              "revoked"
            ],
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "LicensingWebhook": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
            "format": "date-time",
            "type": "string"
          },
          "enabled": {
            "description": "HTTP অনুমত কি না, শুধু স্থানীয় ডেভেলপমেন্টে।",
            "type": "boolean"
          },
          "events": {
            "description": "অশূন্য, পৃথক সাবস্ক্রাইব করা ইভেন্ট ধরন।",
            "items": {
              "enum": [
                "license.created",
                "license.updated",
                "license.renewed",
                "license.revoked",
                "license.activate",
                "license.deactivate",
                "license.consume",
                "license.expiring",
                "license.expired",
                "license.maintenance_expiring",
                "license.maintenance_expired"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "description": "মানুষের পড়ার উপযোগী নাম; দৈর্ঘ্যের সীমা দেখুন।",
            "type": "string"
          },
          "updated_at": {
            "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
            "format": "date-time",
            "type": "string"
          },
          "url": {
            "description": "ইভেন্ট গ্রহীতার URL; উৎপাদনে প্রকাশ্য HTTPS ব্যবহার করুন।",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "url",
          "events",
          "enabled",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "LicensingWebhookInput": {
        "additionalProperties": false,
        "properties": {
          "enabled": {
            "description": "ওয়েবহুক এন্ডপয়েন্ট সক্ষম কি না।",
            "type": "boolean"
          },
          "events": {
            "description": "অশূন্য, পৃথক সাবস্ক্রাইব করা ইভেন্ট ধরন।",
            "items": {
              "enum": [
                "license.created",
                "license.updated",
                "license.renewed",
                "license.revoked",
                "license.activate",
                "license.deactivate",
                "license.consume",
                "license.expiring",
                "license.expired",
                "license.maintenance_expiring",
                "license.maintenance_expired"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "description": "মানুষের পড়ার উপযোগী নাম; দৈর্ঘ্যের সীমা দেখুন।",
            "maxLength": 120,
            "type": "string"
          },
          "secret": {
            "description": "ওয়েবহুক যাচাই গোপন মান, দিলে 32–200 অক্ষর; আপডেটে বাদ দিলে থাকে। ফাঁকা আউটপুট মানে পুনরায় ইস্যু হয়নি।",
            "maxLength": 200,
            "minLength": 32,
            "type": "string",
            "writeOnly": true
          },
          "url": {
            "description": "ইভেন্ট গ্রহীতার URL; উৎপাদনে প্রকাশ্য HTTPS ব্যবহার করুন।",
            "format": "uri",
            "maxLength": 2000,
            "type": "string"
          }
        },
        "required": [
          "name",
          "url",
          "events",
          "enabled"
        ],
        "type": "object"
      },
      "LicensingWebhookList": {
        "additionalProperties": false,
        "properties": {
          "event_types": {
            "description": "সব সমর্থিত লাইসেন্সিং ইভেন্ট ধরন।",
            "items": {
              "enum": [
                "license.created",
                "license.updated",
                "license.renewed",
                "license.revoked",
                "license.activate",
                "license.deactivate",
                "license.consume",
                "license.expiring",
                "license.expired",
                "license.maintenance_expiring",
                "license.maintenance_expired"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/LicensingWebhook"
            },
            "type": "array"
          }
        },
        "required": [],
        "type": "object"
      },
      "LicensingWebhookSecret": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "secret": {
            "description": "নতুন এন্ডপয়েন্টে একবার ফেরত দেয়; সংরক্ষিত থাকলে ফাঁকা",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "LoggedOut": {
        "additionalProperties": false,
        "properties": {
          "logged_out": {
            "type": "boolean"
          }
        },
        "required": [
          "logged_out"
        ],
        "type": "object"
      },
      "Login": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "format": "email",
            "type": "string"
          },
          "password": {
            "description": "12–128 UTF-8 বাইট, অক্ষর নয়",
            "type": "string",
            "writeOnly": true
          }
        },
        "required": [
          "email",
          "password"
        ],
        "type": "object"
      },
      "LogoutTicket": {
        "additionalProperties": false,
        "properties": {
          "activation_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "expected_generation": {
            "description": "প্রত্যাশিত ডিভাইস বাইন্ডিং জেনারেশন, প্রত্যাহার লেনদেনের মধ্যে তুলনা করা হয়।",
            "minimum": 1,
            "type": "integer"
          },
          "operation_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "product_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "release_token": {
            "description": "শুধু আনলিঙ্ক সক্ষমতা। ফিচার অ্যাক্টিভেট, যাচাই, রিফ্রেশ বা ব্যবহার করতে পারে না। প্রত্যাহার অপেক্ষমাণ থাকলে শুধু SDK লগআউট জার্নালে রাখুন।",
            "pattern": "^lv_out_[A-Za-z0-9_-]{43}$",
            "type": "string"
          }
        },
        "required": [
          "operation_id",
          "product_id",
          "activation_id",
          "expected_generation",
          "release_token"
        ],
        "type": "object"
      },
      "MailConnection": {
        "additionalProperties": false,
        "properties": {
          "check_status": {
            "enum": [
              "verified",
              "limited"
            ],
            "type": "string"
          },
          "delivery_mode": {
            "enum": [
              "file",
              "smtp",
              "resend",
              "brevo",
              "postmark",
              "mailgun"
            ],
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "mode": {
            "enum": [
              "file",
              "smtp",
              "resend",
              "brevo",
              "postmark",
              "mailgun"
            ],
            "type": "string"
          },
          "ok": {
            "description": "সীমিত পরীক্ষায় False: ক্রেডেনশিয়াল ও ডেলিভারি নিশ্চিত নয়।",
            "type": "boolean"
          },
          "status": {
            "enum": [
              "connected"
            ],
            "type": "string"
          }
        },
        "required": [
          "status",
          "mode",
          "delivery_mode",
          "ok",
          "check_status"
        ],
        "type": "object"
      },
      "MailInput": {
        "additionalProperties": false,
        "description": "এনক্রিপ্টেড প্ল্যাটফর্ম মেইল সেটিংয়ের আংশিক আপডেট। বাদ দেওয়া ফিল্ড ও অন্য প্রদানকারীর কনফিগারেশন থাকে; ফাঁকা API কী ও SMTP পাসওয়ার্ড বিদ্যমান গোপন মান রাখে। নির্বাচিত সক্রিয় পরিষেবা সম্পূর্ণ কনফিগার হতে হবে। উৎপাদনে ফাইল মোড অনুপলব্ধ। প্ল্যাটফর্ম-প্রশাসক সেশন ও CSRF টোকেন প্রয়োজন; বিক্রেতা ব্যবস্থাপনা API কী প্ল্যাটফর্ম মেইল সেটিং বদলাতে পারে না।",
        "properties": {
          "from": {
            "type": "string"
          },
          "host": {
            "maxLength": 253,
            "type": "string"
          },
          "mode": {
            "enum": [
              "file",
              "smtp",
              "resend",
              "brevo",
              "postmark",
              "mailgun"
            ],
            "type": "string"
          },
          "password": {
            "description": "বিদ্যমান SMTP পাসওয়ার্ড রাখতে বাদ দিন বা ফাঁকা রাখুন।",
            "maxLength": 1000,
            "type": "string",
            "writeOnly": true
          },
          "port": {
            "maximum": 65535,
            "minimum": 1,
            "type": "integer"
          },
          "providers": {
            "additionalProperties": false,
            "properties": {
              "brevo": {
                "$ref": "#/components/schemas/MailProviderInput"
              },
              "mailgun": {
                "$ref": "#/components/schemas/MailgunInput"
              },
              "postmark": {
                "$ref": "#/components/schemas/MailProviderInput"
              },
              "resend": {
                "$ref": "#/components/schemas/MailProviderInput"
              }
            },
            "required": [],
            "type": "object"
          },
          "tls_mode": {
            "enum": [
              "starttls",
              "implicit"
            ],
            "type": "string"
          },
          "username": {
            "maxLength": 254,
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "MailJob": {
        "additionalProperties": false,
        "properties": {
          "attempts": {
            "type": "integer"
          },
          "cancel_reason": {
            "enum": [
              "",
              "platform_disabled",
              "customer_disabled",
              "coverage_changed",
              "reminder_window_changed",
              "renewal_state_changed",
              "purchase_unavailable",
              "workspace_unavailable",
              "recipient_unavailable",
              "unknown_notification"
            ],
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "delivered_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "kind": {
            "enum": [
              "",
              "purchase_success",
              "expiry_reminder",
              "auto_renewal_success",
              "auto_renewal_problem",
              "billing_test"
            ],
            "type": "string"
          },
          "mode": {
            "enum": [
              "",
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "recipient": {
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running",
              "delivered",
              "failed",
              "cancelled"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "status",
          "attempts"
        ],
        "type": "object"
      },
      "MailJobList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/MailJob"
            },
            "maxItems": 50,
            "type": "array"
          }
        },
        "required": [
          "items"
        ],
        "type": "object"
      },
      "MailProviderInput": {
        "additionalProperties": false,
        "properties": {
          "api_key": {
            "description": "প্রদানকারী API কী; Postmark Server API Token ব্যবহার করে। সংরক্ষিত গোপন মান রাখতে বাদ দিন বা ফাঁকা রাখুন।",
            "maxLength": 4096,
            "type": "string",
            "writeOnly": true
          },
          "from": {
            "description": "যাচাইকৃত প্রেরক ইমেইল; এই প্রদানকারী সক্রিয় নির্বাচন করলে প্রয়োজন।",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "MailProviderSettings": {
        "additionalProperties": false,
        "properties": {
          "api_key_configured": {
            "type": "boolean"
          },
          "domain": {
            "description": "Mailgun পাঠানোর ডোমেইন; অন্য প্রদানকারীতে ফাঁকা।",
            "type": "string"
          },
          "from": {
            "type": "string"
          },
          "region": {
            "description": "Mailgun অঞ্চল; অন্য প্রদানকারীতে ফাঁকা।",
            "enum": [
              "",
              "us",
              "eu"
            ],
            "type": "string"
          }
        },
        "required": [
          "from",
          "domain",
          "region",
          "api_key_configured"
        ],
        "type": "object"
      },
      "MailQueued": {
        "additionalProperties": false,
        "properties": {
          "job_id": {
            "format": "uuid",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending"
            ],
            "type": "string"
          }
        },
        "required": [
          "job_id",
          "status"
        ],
        "type": "object"
      },
      "MailSettings": {
        "additionalProperties": false,
        "properties": {
          "from": {
            "type": "string"
          },
          "host": {
            "type": "string"
          },
          "mode": {
            "enum": [
              "file",
              "smtp",
              "resend",
              "brevo",
              "postmark",
              "mailgun"
            ],
            "type": "string"
          },
          "password_configured": {
            "type": "boolean"
          },
          "port": {
            "type": "integer"
          },
          "providers": {
            "additionalProperties": false,
            "properties": {
              "brevo": {
                "$ref": "#/components/schemas/MailProviderSettings"
              },
              "mailgun": {
                "$ref": "#/components/schemas/MailProviderSettings"
              },
              "postmark": {
                "$ref": "#/components/schemas/MailProviderSettings"
              },
              "resend": {
                "$ref": "#/components/schemas/MailProviderSettings"
              }
            },
            "required": [
              "resend",
              "brevo",
              "postmark",
              "mailgun"
            ],
            "type": "object"
          },
          "tls_mode": {
            "enum": [
              "starttls",
              "implicit"
            ],
            "type": "string"
          },
          "username": {
            "type": "string"
          }
        },
        "required": [
          "mode",
          "port",
          "password_configured",
          "providers"
        ],
        "type": "object"
      },
      "MailgunInput": {
        "additionalProperties": false,
        "properties": {
          "api_key": {
            "description": "Mailgun অ্যাকাউন্ট API কী বা ডোমেইন পাঠানোর কী। সংরক্ষিত গোপন মান রাখতে বাদ দিন বা ফাঁকা রাখুন।",
            "maxLength": 4096,
            "type": "string",
            "writeOnly": true
          },
          "domain": {
            "description": "পাঠানোর ডোমেইন, Mailgun সক্রিয় হলে প্রয়োজন; স্কিম, পাথ বা পোর্ট নেই।",
            "maxLength": 253,
            "type": "string"
          },
          "from": {
            "description": "যাচাইকৃত প্রেরক ইমেইল; Mailgun সক্রিয় হলে প্রয়োজন।",
            "type": "string"
          },
          "region": {
            "default": "us",
            "description": "পাঠানোর ডোমেইনের হোস্টিং অঞ্চল; US ও EU পৃথক নির্দিষ্ট API এন্ডপয়েন্ট ব্যবহার করে।",
            "enum": [
              "us",
              "eu"
            ],
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "ManagementKeyBundle": {
        "additionalProperties": false,
        "properties": {
          "keys": {
            "description": "পণ্যের বর্তমান ও ঐতিহাসিক স্বাক্ষর পাবলিক কী।",
            "items": {
              "$ref": "#/components/schemas/SigningKey"
            },
            "type": "array"
          },
          "product_id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "keys"
        ],
        "type": "object"
      },
      "ManualRefundInput": {
        "additionalProperties": false,
        "properties": {
          "customer_agreement": {
            "maxLength": 3000,
            "type": "string"
          },
          "evidence": {
            "maxLength": 3000,
            "type": "string"
          }
        },
        "required": [
          "customer_agreement",
          "evidence"
        ],
        "type": "object"
      },
      "Me": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "is_platform_admin": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "role": {
            "enum": [
              "owner",
              "read_only"
            ],
            "type": "string"
          },
          "tenant_id": {
            "format": "uuid",
            "type": "string"
          },
          "tenant_name": {
            "type": "string"
          }
        },
        "required": [
          "tenant_id",
          "id",
          "role",
          "is_platform_admin"
        ],
        "type": "object"
      },
      "Member": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "is_platform_admin": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "role": {
            "enum": [
              "owner",
              "read_only"
            ],
            "type": "string"
          },
          "status": {
            "enum": [
              "active",
              "disabled"
            ],
            "type": "string"
          },
          "verified": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "role",
          "status",
          "verified"
        ],
        "type": "object"
      },
      "MemberList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/Member"
            },
            "type": "array"
          },
          "limit": {
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [
          "items"
        ],
        "type": "object"
      },
      "MemberUpdate": {
        "additionalProperties": false,
        "properties": {
          "role": {
            "enum": [
              "owner",
              "read_only"
            ],
            "type": "string"
          },
          "status": {
            "enum": [
              "active",
              "disabled"
            ],
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "MonthInput": {
        "additionalProperties": false,
        "properties": {
          "month": {
            "description": "UTC মাস YYYY-MM; বাদ দেওয়া কোয়েরি মানে বর্তমান মাস ব্যবহৃত হয়। বিলিং কাজে বন্ধ মাস প্রয়োজন।",
            "pattern": "^[0-9]{4}-[0-9]{2}$",
            "type": "string"
          }
        },
        "required": [
          "month"
        ],
        "type": "object"
      },
      "Notice": {
        "additionalProperties": false,
        "properties": {
          "message": {
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "type": "object"
      },
      "OfflineReleaseResult": {
        "additionalProperties": false,
        "example": {
          "activation_id": "44444444-4444-4444-8444-444444444444",
          "deactivated": true
        },
        "properties": {
          "activation_id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "deactivated": {
            "description": "HTTP অনুমত কি না, শুধু স্থানীয় ডেভেলপমেন্টে।",
            "type": "boolean"
          }
        },
        "required": [
          "activation_id",
          "deactivated"
        ],
        "type": "object"
      },
      "OfflineRequest": {
        "additionalProperties": false,
        "properties": {
          "activation_id": {
            "description": "ডিভাইস অ্যাক্টিভেশন বা floating-সেশন রেকর্ড UUID।",
            "format": "uuid",
            "type": "string"
          },
          "app_version": {
            "description": "সাধারণ অ্যাক্টিভেশনে ফাঁকা। সংস্করণ বা রক্ষণাবেক্ষণ বিধিনিষেধ ব্যবহার করলেই শুধু প্রকৃত প্রকাশিত অ্যাপ সংস্করণ দিন।",
            "pattern": "^$|^(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})$",
            "type": "string"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "type": "integer"
          },
          "device_id": {
            "description": "SDK LicenovaDevice/v3 দিয়ে পণ্য-পরিসরের OS ও হার্ডওয়্যার পরিচয় নির্ণয় করে। কনফিগারেশন বর্তমান মেশিন ওভাররাইড করতে পারে না।",
            "pattern": "^[0-9a-f]{64}$",
            "type": "string"
          },
          "device_name": {
            "description": "মানুষের পাঠযোগ্য ডিভাইস লেবেল, নিরাপত্তা পরিচয় নয়।",
            "maxLength": 120,
            "type": "string"
          },
          "device_profile": {
            "$ref": "#/components/schemas/DeviceProfile",
            "description": "SDK-তৈরি ডিভাইস পরিচয়; উপস্থিত থাকলে সব প্রয়োজনীয় চাইল্ড ফিল্ড দিন।"
          },
          "license_key": {
            "description": "মূল লাইসেন্স কী; শুধু activate-এ একবার ব্যবহারযোগ্য lv_tmp_ কোড; তারপর রানটাইম কাজে মেশিনে বাঁধা lv_dev_ ক্রেডেনশিয়াল। SDK লিজ থেকে আলাদা করে ক্রেডেনশিয়াল স্থায়ী রাখে।",
            "pattern": "^lv_(lic|tmp|dev)_[A-Za-z0-9_-]{43}$",
            "type": "string",
            "writeOnly": true
          },
          "operation": {
            "description": "কাজের নাম; ব্যাচ create/renew/revoke/apply_policy এবং অফলাইন অনুরোধ activate/deactivate সমর্থন করে।",
            "enum": [
              "activate",
              "deactivate"
            ],
            "type": "string"
          },
          "product_id": {
            "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
            "format": "uuid",
            "type": "string"
          },
          "request_id": {
            "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
            "format": "uuid",
            "type": "string"
          },
          "session_id": {
            "description": "Floating ইনস্ট্যান্স সেশন শনাক্তকারী; node-locked লাইসেন্সে বাদ দেওয়া যায়।",
            "format": "uuid",
            "type": "string"
          },
          "version": {
            "const": 1,
            "description": "অবজেক্ট অনুযায়ী নীতি সংশোধন, পণ্য major.minor.patch সংস্করণ বা অফলাইন প্রোটোকল সংস্করণ 1।",
            "type": "integer"
          }
        },
        "required": [
          "version",
          "request_id",
          "created_at",
          "operation",
          "product_id",
          "license_key",
          "device_id"
        ],
        "type": "object"
      },
      "OfflineResponse": {
        "additionalProperties": false,
        "example": {
          "operation": "deactivate",
          "request_id": "55555555-5555-4555-8555-555555555555",
          "result": {
            "activation_id": "44444444-4444-4444-8444-444444444444",
            "deactivated": true
          },
          "version": 1
        },
        "properties": {
          "operation": {
            "description": "কাজের নাম; ব্যাচ create/renew/revoke/apply_policy এবং অফলাইন অনুরোধ activate/deactivate সমর্থন করে।",
            "enum": [
              "activate",
              "deactivate"
            ],
            "type": "string"
          },
          "request_id": {
            "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
            "format": "uuid",
            "type": "string"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RuntimeResult",
                "description": "অফলাইন কাজের ফল: অ্যাক্টিভেশন স্বাক্ষরিত লিজ ফেরায়; রিলিজ deactivated ফেরায়।"
              },
              {
                "$ref": "#/components/schemas/OfflineReleaseResult",
                "description": "অফলাইন কাজের ফল: অ্যাক্টিভেশন স্বাক্ষরিত লিজ ফেরায়; রিলিজ deactivated ফেরায়।"
              }
            ],
            "description": "অফলাইন কাজের ফল: অ্যাক্টিভেশন স্বাক্ষরিত লিজ ফেরায়; রিলিজ deactivated ফেরায়।"
          },
          "version": {
            "const": 1,
            "description": "অবজেক্ট অনুযায়ী নীতি সংশোধন, পণ্য major.minor.patch সংস্করণ বা অফলাইন প্রোটোকল সংস্করণ 1।",
            "type": "integer"
          }
        },
        "required": [
          "version",
          "request_id",
          "operation",
          "result"
        ],
        "type": "object"
      },
      "OnboardingInput": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "description": "পণ্যের বিবরণ; ফাঁকা হতে পারে।",
            "maxLength": 1000,
            "type": "string"
          },
          "duration_days": {
            "description": "শুধু তৈরি পরীক্ষামূলক লাইসেন্সের মেয়াদ; timed/trial-এর ডিফল্ট 7। তৈরি নীতিতে সংরক্ষিত নয়।",
            "maximum": 36500,
            "minimum": 1,
            "type": [
              "integer",
              "null"
            ]
          },
          "features": {
            "default": [
              "export"
            ],
            "description": "সর্বাধিক 32 পৃথক ফিচার শনাক্তকারী, প্রতিটি 1–64 ASCII বর্ণ, সংখ্যা, বিন্দু, ড্যাশ বা আন্ডারস্কোর।",
            "items": {
              "pattern": "^[A-Za-z0-9_.-]{1,64}$",
              "type": "string"
            },
            "maxItems": 32,
            "type": "array",
            "uniqueItems": true
          },
          "heartbeat_seconds": {
            "anyOf": [
              {
                "const": 0,
                "description": "হার্টবিট ব্যবধান সেকেন্ডে: 0 নিষ্ক্রিয় করে; অন্যথায় 600–86400। বাদ দিলে সার্ভার ডিফল্ট; অফলাইন ভাতা থেকে স্বাধীন।"
              },
              {
                "description": "হার্টবিট ব্যবধান সেকেন্ডে: 0 নিষ্ক্রিয় করে; অন্যথায় 600–86400। বাদ দিলে সার্ভার ডিফল্ট; অফলাইন ভাতা থেকে স্বাধীন।",
                "maximum": 86400,
                "minimum": 600,
                "type": "integer"
              }
            ],
            "description": "0 স্পষ্টভাবে পর্যায়ক্রমিক হার্টবিট বন্ধ করে; অন্যথায় 600–86400 সেকেন্ড (ন্যূনতম 10 মিনিট)। অফলাইন ভাতা থেকে স্বাধীন।",
            "type": "integer"
          },
          "license_model": {
            "default": "node_locked",
            "description": "node_locked ডিভাইস বাইন্ডিং বা floating সিট।",
            "enum": [
              "node_locked",
              "floating"
            ],
            "type": "string"
          },
          "max_devices": {
            "default": 1,
            "description": "প্রতি লাইসেন্স সর্বাধিক সমসাময়িক ডিভাইস বা floating সিট।",
            "maximum": 10000,
            "minimum": 1,
            "type": "integer"
          },
          "mode": {
            "default": "trial",
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "perpetual",
              "timed",
              "trial"
            ],
            "type": "string"
          },
          "name": {
            "description": "মানুষের পড়ার উপযোগী নাম; দৈর্ঘ্যের সীমা দেখুন।",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "offline_mode": {
            "description": "limited, none বা permanent অফলাইন ভাতা; লাইসেন্সের মেয়াদ এখনও প্রযোজ্য।",
            "enum": [
              "limited",
              "none",
              "permanent"
            ],
            "type": "string"
          },
          "offline_seconds": {
            "description": "Limited: 1–31536000 সেকেন্ড এবং হার্টবিট চালু থাকলে অন্তত 3 × heartbeat_seconds; none/permanent: 0",
            "maximum": 31536000,
            "minimum": 0,
            "type": "integer"
          },
          "request_id": {
            "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "request_id",
          "name"
        ],
        "type": "object"
      },
      "OnboardingResult": {
        "additionalProperties": false,
        "example": {
          "config": {
            "allow_http": false,
            "app_version": "1.0.0",
            "base_url": "https://license.example.com",
            "cache_path": "",
            "device_name": "My application",
            "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
            "product_id": "11111111-1111-4111-8111-111111111111",
            "trusted_keys": {
              "66666666-6666-4666-8666-666666666666": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
            }
          },
          "license_id": "33333333-3333-4333-8333-333333333333",
          "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
          "next": "Choose a language and download the configured SDK bundle.",
          "policy_id": "22222222-2222-4222-8222-222222222222",
          "product_id": "11111111-1111-4111-8111-111111111111"
        },
        "properties": {
          "config": {
            "$ref": "#/components/schemas/SDKConfig",
            "description": "লাইসেন্স গোপন মানসহ ব্যক্তিগত পরীক্ষামূলক SDK কনফিগারেশন।"
          },
          "license_id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "license_key": {
            "description": "অ্যাক্টিভেশনে দেওয়া সম্পূর্ণ গ্রাহক লাইসেন্স কী। পণ্য ইনিশিয়ালাইজেশন কোড ও উদাহরণ ডাউনলোডে এই গোপন মান নেই। অফলাইন অনুরোধ SDK-প্রদত্ত ক্রেডেনশিয়াল ব্যবহার করে।",
            "type": "string"
          },
          "next": {
            "description": "নির্ধারিত পরের মাসের ডিফল্ট প্ল্যান, বা null।",
            "type": "string"
          },
          "policy_id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "product_id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "policy_id",
          "license_id",
          "license_key",
          "config",
          "next"
        ],
        "type": "object"
      },
      "OperatorProfile": {
        "additionalProperties": false,
        "properties": {
          "backup_region": {
            "maxLength": 500,
            "type": "string"
          },
          "contact": {
            "maxLength": 500,
            "type": "string"
          },
          "country": {
            "maxLength": 500,
            "type": "string"
          },
          "financial_retention_years": {
            "description": "শূন্য বা বাদ দিলে অনিশ্চিত এবং প্রকাশ্য নথিতে অন্তর্ভুক্ত নয়।",
            "maximum": 30,
            "minimum": 0,
            "type": "integer"
          },
          "hosting_provider": {
            "maxLength": 500,
            "type": "string"
          },
          "mail_provider": {
            "maxLength": 500,
            "type": "string"
          },
          "markets": {
            "maxLength": 500,
            "type": "string"
          },
          "operator": {
            "maxLength": 500,
            "type": "string"
          },
          "processing_grounds": {
            "maxLength": 500,
            "type": "string"
          },
          "server_region": {
            "maxLength": 500,
            "type": "string"
          },
          "transfer_safeguards": {
            "maxLength": 500,
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "OriginalRefundInput": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "pattern": "^[0-9]+(?:\\.[0-9]{1,2})?$",
            "type": "string"
          },
          "reason": {
            "maxLength": 255,
            "minLength": 1,
            "type": "string"
          },
          "request_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "amount",
          "reason",
          "request_id"
        ],
        "type": "object"
      },
      "OriginalRefundResult": {
        "additionalProperties": false,
        "properties": {
          "case_id": {
            "format": "uuid",
            "type": "string"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/ProviderRefund"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "OveragePlan": {
        "additionalProperties": false,
        "properties": {
          "api_hard_limit": {
            "description": "API ভাতা সীমায় রানটাইম কল থামে কি না।",
            "type": "boolean"
          },
          "api_unit_micros": {
            "description": "প্রতি অতিরিক্ত রানটাইম কলের মূল্য দশ লক্ষ ভাগে।",
            "minimum": 0,
            "type": "integer"
          },
          "base_micros": {
            "description": "মুদ্রা এককের দশ লক্ষ ভাগে ভিত্তি চার্জ।",
            "type": "integer"
          },
          "currency": {
            "description": "তিন অক্ষরের বড় হাতের মুদ্রা কোড, যেমন USD।",
            "type": "string"
          },
          "description": {
            "description": "বিলিং অফারের বিবরণ।",
            "type": "string"
          },
          "enabled": {
            "description": "বিলিং অফার ক্রয়ের জন্য সক্ষম কি না।",
            "type": "boolean"
          },
          "hard_limit": {
            "description": "ভাতা সীমায় নতুন বিলযোগ্য ডিভাইস প্রত্যাখ্যাত হয় কি না।",
            "type": "boolean"
          },
          "included_api_calls": {
            "description": "null = সীমাহীন; 0 = কোনো সফল কল অন্তর্ভুক্ত নয়",
            "maximum": 1000000000000,
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          },
          "included_devices": {
            "description": "অন্তর্ভুক্ত সক্রিয় ডিভাইস ভাতা।",
            "type": "integer"
          },
          "name": {
            "description": "বিলিং অফারের প্রদর্শন নাম।",
            "type": "string"
          },
          "plan": {
            "description": "প্রকাশিত ক্যাটালগের স্থির বিলিং প্ল্যান শনাক্তকারী।",
            "type": "string"
          },
          "price_version": {
            "description": "স্থির করা মূল্য সংশোধন; পুরোনো ইনপুটের কারণে PLAN_VERSION_CONFLICT হতে পারে।",
            "type": "string"
          },
          "public": {
            "description": "বিলিং অফার প্রকাশ্য তালিকায় আছে কি না।",
            "type": "boolean"
          },
          "renewal_only": {
            "description": "বিদ্যমান পরিশোধিত বা উপহারপ্রাপ্ত গ্রাহক একই পরিবেশ ও মুদ্রায় আগাম বা মেয়াদ শেষে নবায়ন করতে পারেন। নতুন প্রকাশ্য ক্রয় থেকে লুকানো।",
            "type": "boolean"
          },
          "sort_order": {
            "description": "বিলিং অফারের প্রদর্শন ক্রম।",
            "type": "integer"
          },
          "terms": {
            "anyOf": [
              {
                "description": "উপলব্ধ ক্রয় মেয়াদ ও তার মূল্য।",
                "items": {
                  "$ref": "#/components/schemas/PlanTermPrice"
                },
                "type": "array"
              },
              {
                "description": "উপলব্ধ ক্রয় মেয়াদ ও তার মূল্য।",
                "type": "null"
              }
            ],
            "description": "উপলব্ধ ক্রয় মেয়াদ ও তার মূল্য।"
          },
          "unit_micros": {
            "description": "প্রতি অতিরিক্ত সক্রিয় ডিভাইসের মূল্য দশ লক্ষ ভাগে।",
            "type": "integer"
          },
          "updated_at": {
            "description": "UTC-তে সর্বশেষ আপডেট টাইমস্ট্যাম্প।",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "OveragePreference": {
        "additionalProperties": false,
        "properties": {
          "block_api_overage": {
            "description": "অন্তর্ভুক্ত ভাতার বেশি রানটাইম API কল আটকানো হয় কি না।",
            "type": "boolean"
          },
          "block_device_overage": {
            "description": "অন্তর্ভুক্ত ভাতার বেশি নতুন বিলযোগ্য ডিভাইস আটকে দেওয়া হয় কি না।",
            "type": "boolean"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "updated_at": {
            "description": "UTC-তে সর্বশেষ আপডেট টাইমস্ট্যাম্প।",
            "format": "date-time",
            "type": "string"
          },
          "version": {
            "description": "অতিরিক্ত ব্যবহার পছন্দ কনফিগারেশন সংশোধন।",
            "type": "string"
          }
        },
        "required": [
          "mode",
          "block_device_overage",
          "block_api_overage",
          "version",
          "updated_at"
        ],
        "type": "object"
      },
      "OverageSettings": {
        "additionalProperties": false,
        "properties": {
          "customer_api_settings_enabled": {
            "description": "গ্রাহক API অতিরিক্ত ব্যবহার ব্লক কনফিগার করতে পারেন কি না।",
            "type": "boolean"
          },
          "customer_device_settings_enabled": {
            "description": "গ্রাহক ডিভাইস অতিরিক্ত ব্যবহার ব্লক কনফিগার করতে পারেন কি না।",
            "type": "boolean"
          },
          "plan": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/OveragePlan",
                "description": "প্রকাশিত ক্যাটালগের স্থির বিলিং প্ল্যান শনাক্তকারী।"
              },
              {
                "description": "প্রকাশিত ক্যাটালগের স্থির বিলিং প্ল্যান শনাক্তকারী।",
                "type": "null"
              }
            ],
            "description": "অতিরিক্ত ব্যবহার নির্ধারণে বর্তমান কেনা/ডিফল্ট ভাতা নিয়ম, অনুপলব্ধ হলে null।"
          },
          "preference": {
            "$ref": "#/components/schemas/OveragePreference",
            "description": "সংরক্ষিত গ্রাহক অতিরিক্ত ব্যবহার পছন্দ।"
          }
        },
        "required": [
          "preference",
          "plan",
          "customer_device_settings_enabled",
          "customer_api_settings_enabled"
        ],
        "type": "object"
      },
      "OverageSettingsInput": {
        "additionalProperties": false,
        "properties": {
          "block_api_overage": {
            "type": "boolean"
          },
          "block_device_overage": {
            "type": "boolean"
          },
          "expected_version": {
            "description": "GET থেকে preference.version ব্যবহার করুন। প্রথম সংরক্ষণে ফাঁকা। অন্য ট্যাবের পরিবর্তনে 409 ফেরত আসে; অন্তত একটি অতিরিক্ত ব্যবহার পছন্দ প্রয়োজন।",
            "type": "string"
          }
        },
        "required": [
          "expected_version"
        ],
        "type": "object"
      },
      "PaddleCheck": {
        "additionalProperties": false,
        "properties": {
          "connected": {
            "description": "এই চ্যানেল নতুন চেকআউট গ্রহণ করে কি না। সংরক্ষিত ক্রেডেনশিয়ালে ঐতিহাসিক মিলন উপলব্ধ থাকে।",
            "type": "boolean"
          },
          "mode": {
            "description": "পেমেন্ট পরিবেশ। Sandbox ও live রেকর্ড বিচ্ছিন্ন।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          }
        },
        "required": [
          "connected",
          "mode"
        ],
        "type": "object"
      },
      "PaddleOrder": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "description": "ক্ষুদ্রতম মুদ্রা এককে স্থির পূর্ণ পরিষেবা মূল্য; ওয়ালেট রিচার্জ বা মিশ্র পেমেন্ট নয়।",
            "type": "integer"
          },
          "applied_at": {
            "anyOf": [
              {
                "description": "স্থানীয় চেকআউট ইন্টেন্ট সংরক্ষণের UTC সময়।",
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "যাচাইকৃত পেমেন্টে পরিষেবা সক্রিয় বা ওয়ালেট টপ-আপ ক্রেডিটের UTC সময়। null purchase_id ও upgrade_id টপ-আপ শনাক্ত করে।"
          },
          "created_at": {
            "description": "স্থানীয় চেকআউট ইন্টেন্ট সংরক্ষণের UTC সময়।",
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
            "type": "string"
          },
          "id": {
            "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
            "format": "uuid",
            "type": "string"
          },
          "mode": {
            "description": "পেমেন্ট পরিবেশ। Sandbox ও live রেকর্ড বিচ্ছিন্ন।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "paid_at": {
            "anyOf": [
              {
                "description": "স্থানীয় চেকআউট ইন্টেন্ট সংরক্ষণের UTC সময়।",
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "ব্যাকএন্ডের সম্পন্ন Paddle লেনদেন যাচাইয়ের UTC সময়।"
          },
          "purchase_id": {
            "anyOf": [
              {
                "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "বিদ্যমান অপেক্ষমাণ পরিষেবা ক্রয় বা নবায়ন; upgrade_id-এর সঙ্গে পারস্পরিকভাবে একচেটিয়া।"
          },
          "refunded_cents": {
            "description": "ক্ষুদ্রতম মুদ্রা এককে স্থির পূর্ণ পরিষেবা মূল্য; ওয়ালেট রিচার্জ বা মিশ্র পেমেন্ট নয়।",
            "type": "integer"
          },
          "request_id": {
            "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
            "type": "string"
          },
          "status": {
            "description": "পেমেন্ট জীবনচক্র, সংগৃহীত অর্থ অপারেটর পর্যালোচনা ও রিফান্ড চাইলে paid_unapplied সহ।",
            "enum": [
              "creating",
              "created",
              "completed",
              "paid_unapplied",
              "partially_refunded",
              "refunded"
            ],
            "type": "string"
          },
          "transaction_id": {
            "anyOf": [
              {
                "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "বাঁধা Paddle Billing লেনদেন শনাক্তকারী, বা মূল তৈরির ফল অপেক্ষমাণ থাকলে null।"
          },
          "upgrade_id": {
            "anyOf": [
              {
                "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "বিদ্যমান অপেক্ষমাণ আপগ্রেড কোট; purchase_id-এর সঙ্গে পারস্পরিকভাবে একচেটিয়া।"
          }
        },
        "required": [
          "id",
          "request_id",
          "mode",
          "transaction_id",
          "purchase_id",
          "upgrade_id",
          "currency",
          "amount_cents",
          "refunded_cents",
          "status",
          "paid_at",
          "applied_at",
          "created_at"
        ],
        "type": "object"
      },
      "PaddleOrderInput": {
        "additionalProperties": false,
        "description": "একটি স্থির ক্রয়/আপগ্রেড পরিশোধ করুন, অথবা পরিষেবা ID ছাড়া অর্থ ও মুদ্রা দিয়ে ওয়ালেট টপ-আপ তৈরি করুন। স্থির request_id মূল পেমেন্ট ফেরত দেয়; উদ্দেশ্য, অর্থ বা মুদ্রা পরিবর্তন প্রত্যাখ্যাত। শুধু স্বাধীনভাবে যাচাইকৃত সম্পন্ন পেমেন্ট ওয়ালেট ক্রেডিট বা পরিষেবা সক্রিয় করে। টপ-আপের রিটার্ন ওয়ালেটে যায়। অনিশ্চিত তৈরির ফল মূল ওয়েবহুক থেকে পুনরুদ্ধার হয় এবং অন্ধভাবে আবার তৈরি হয় না।",
        "oneOf": [
          {
            "not": {
              "anyOf": [
                {
                  "required": [
                    "amount"
                  ]
                },
                {
                  "required": [
                    "currency"
                  ]
                }
              ]
            },
            "properties": {
              "purchase_id": {
                "format": "uuid",
                "type": "string"
              },
              "upgrade_id": {
                "type": "null"
              }
            },
            "required": [
              "purchase_id"
            ]
          },
          {
            "not": {
              "anyOf": [
                {
                  "required": [
                    "amount"
                  ]
                },
                {
                  "required": [
                    "currency"
                  ]
                }
              ]
            },
            "properties": {
              "purchase_id": {
                "type": "null"
              },
              "upgrade_id": {
                "format": "uuid",
                "type": "string"
              }
            },
            "required": [
              "upgrade_id"
            ]
          },
          {
            "properties": {
              "purchase_id": {
                "type": "null"
              },
              "upgrade_id": {
                "type": "null"
              }
            },
            "required": [
              "amount",
              "currency"
            ]
          }
        ],
        "properties": {
          "amount": {
            "description": "শুধু ওয়ালেট টপ-আপে প্রয়োজন। কনফিগার সীমার মধ্যে দশমিক প্রদর্শন অর্থ। পরিষেবা অর্ডার ক্লায়েন্টের অর্থ প্রত্যাখ্যান করে।",
            "pattern": "^\\d+(?:\\.\\d{1,2})?$",
            "type": "string"
          },
          "currency": {
            "description": "শুধু ওয়ালেট টপ-আপে প্রয়োজন এবং এই প্রদানকারীর জন্য সক্ষম হতে হবে।",
            "type": "string"
          },
          "overage_accepted": {
            "description": "প্রদর্শিত চার্জযোগ্য অতিরিক্ত ব্যবহারের পৃথক স্পষ্ট অনুমোদন।",
            "type": "boolean"
          },
          "policy_version": {
            "description": "বর্তমানে প্রকাশিত অপরিবর্তনীয় নীতি সংস্করণ। অপারেটর নীতি প্রকাশের পর উভয় পেমেন্ট পরিবেশে সম্মতি-সুরক্ষিত কাজে প্রয়োজন।",
            "type": "string"
          },
          "purchase_id": {
            "anyOf": [
              {
                "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "বিদ্যমান অপেক্ষমাণ পরিষেবা ক্রয় বা নবায়ন; upgrade_id-এর সঙ্গে পারস্পরিকভাবে একচেটিয়া।"
          },
          "request_id": {
            "description": "স্থির কলার-তৈরি অনুরোধ কী। রিপ্লে মূল চেকআউট ফেরত দেয়।",
            "maxLength": 80,
            "type": "string"
          },
          "terms_accepted": {
            "description": "স্পষ্ট সম্মতি, ডিফল্টে অনির্বাচিত।",
            "type": "boolean"
          },
          "upgrade_id": {
            "anyOf": [
              {
                "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "বিদ্যমান অপেক্ষমাণ আপগ্রেড কোট; purchase_id-এর সঙ্গে পারস্পরিকভাবে একচেটিয়া।"
          }
        },
        "required": [
          "request_id"
        ],
        "type": "object"
      },
      "PaddleOrderList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "এই প্রশাসক বা ওয়ার্কস্পেসের দৃশ্যমান রেকর্ড।",
            "items": {
              "$ref": "#/components/schemas/PaddleOrder"
            },
            "type": "array"
          },
          "total": {
            "description": "ক্ষুদ্রতম মুদ্রা এককে স্থির পূর্ণ পরিষেবা মূল্য; ওয়ালেট রিচার্জ বা মিশ্র পেমেন্ট নয়।",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total"
        ],
        "type": "object"
      },
      "PaddleOrderResult": {
        "additionalProperties": false,
        "properties": {
          "approval_url": {
            "description": "বাঁধা Paddle লেনদেন খোলে এমন স্থানীয় চেকআউট পৃষ্ঠা।",
            "format": "uri",
            "type": "string"
          },
          "client_token": {
            "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
            "type": "string"
          },
          "order": {
            "$ref": "#/components/schemas/PaddleOrder",
            "description": "ওয়ার্কস্পেস-পরিসরের Paddle পরিষেবা-পেমেন্ট রেকর্ড।"
          },
          "return_url": {
            "description": "টপ-আপে ওয়ালেট ড্যাশবোর্ড URL, পরিষেবা পেমেন্টে মূল্য মিলন URL। শুধু রিটার্ন URL কখনো পেমেন্টের প্রমাণ নয়।",
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "order",
          "client_token",
          "approval_url",
          "return_url"
        ],
        "type": "object"
      },
      "PaddleReconcileInput": {
        "additionalProperties": false,
        "properties": {
          "transaction_id": {
            "description": "ঐচ্ছিক মূল txn_ ID, হারানো তৈরি প্রতিক্রিয়া পুনরুদ্ধারে ব্যবহৃত। ব্যাকএন্ড স্থানীয় অর্ডার, টেন্যান্ট, পণ্য, মুদ্রা ও অর্থ স্বাধীনভাবে যাচাই করে। আগে বাঁধা লেনদেন বদলাতে পারে না।",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "PaddleSettings": {
        "additionalProperties": false,
        "properties": {
          "api_key_configured": {
            "description": "এই চ্যানেল নতুন চেকআউট গ্রহণ করে কি না। সংরক্ষিত ক্রেডেনশিয়ালে ঐতিহাসিক মিলন উপলব্ধ থাকে।",
            "type": "boolean"
          },
          "checkout_url": {
            "description": "এই অনুমোদিত ডোমেইনের পৃষ্ঠাকে Paddle ডিফল্ট পেমেন্ট লিঙ্ক হিসেবে ব্যবহার করুন।",
            "format": "uri",
            "type": "string"
          },
          "client_token": {
            "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
            "type": "string"
          },
          "currencies": {
            "description": "এই চ্যানেলের গৃহীত পৃথক মুদ্রা; অর্থে দুই দশমিক স্থান ব্যবহার হয়।",
            "items": {
              "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
              "type": "string"
            },
            "type": "array"
          },
          "enabled": {
            "description": "এই চ্যানেল নতুন চেকআউট গ্রহণ করে কি না। সংরক্ষিত ক্রেডেনশিয়ালে ঐতিহাসিক মিলন উপলব্ধ থাকে।",
            "type": "boolean"
          },
          "maximum_cents": {
            "description": "ক্ষুদ্র মুদ্রা এককে সর্বোচ্চ ওয়ালেট টপ-আপ; ডিফল্ট 100000 এবং minimum_cents-এর কম হবে না।",
            "maximum": 100000000,
            "minimum": 1,
            "type": "integer"
          },
          "minimum_cents": {
            "description": "ক্ষুদ্র মুদ্রা এককে সর্বনিম্ন ওয়ালেট টপ-আপ; ডিফল্ট 100।",
            "maximum": 100000000,
            "minimum": 1,
            "type": "integer"
          },
          "mode": {
            "description": "পেমেন্ট পরিবেশ। Sandbox ও live রেকর্ড বিচ্ছিন্ন।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "product_id": {
            "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
            "type": "string"
          },
          "version": {
            "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
            "type": "string"
          },
          "webhook_secret_configured": {
            "description": "এই চ্যানেল নতুন চেকআউট গ্রহণ করে কি না। সংরক্ষিত ক্রেডেনশিয়ালে ঐতিহাসিক মিলন উপলব্ধ থাকে।",
            "type": "boolean"
          },
          "webhook_url": {
            "description": "এই নির্দিষ্ট URL Paddle বিজ্ঞপ্তির গন্তব্য হিসেবে নিবন্ধন করুন।",
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "enabled",
          "mode",
          "client_token",
          "product_id",
          "currencies",
          "api_key_configured",
          "webhook_secret_configured",
          "version",
          "webhook_url",
          "checkout_url"
        ],
        "type": "object"
      },
      "PaddleSettingsInput": {
        "additionalProperties": false,
        "properties": {
          "api_key": {
            "description": "সংরক্ষণে এনক্রিপ্টেড। clear_api_key true না হলে ফাঁকা মান বিদ্যমান মান রাখে।",
            "maxLength": 1000,
            "type": "string",
            "writeOnly": true
          },
          "clear_api_key": {
            "description": "এই চ্যানেল নতুন চেকআউট গ্রহণ করে কি না। সংরক্ষিত ক্রেডেনশিয়ালে ঐতিহাসিক মিলন উপলব্ধ থাকে।",
            "type": "boolean"
          },
          "clear_webhook_secret": {
            "description": "এই চ্যানেল নতুন চেকআউট গ্রহণ করে কি না। সংরক্ষিত ক্রেডেনশিয়ালে ঐতিহাসিক মিলন উপলব্ধ থাকে।",
            "type": "boolean"
          },
          "client_token": {
            "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
            "type": "string"
          },
          "currencies": {
            "description": "এই চ্যানেলের গৃহীত পৃথক মুদ্রা; অর্থে দুই দশমিক স্থান ব্যবহার হয়।",
            "items": {
              "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
              "type": "string"
            },
            "type": "array"
          },
          "enabled": {
            "description": "এই চ্যানেল নতুন চেকআউট গ্রহণ করে কি না। সংরক্ষিত ক্রেডেনশিয়ালে ঐতিহাসিক মিলন উপলব্ধ থাকে।",
            "type": "boolean"
          },
          "expected_version": {
            "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
            "type": "string"
          },
          "maximum_cents": {
            "description": "ক্ষুদ্র মুদ্রা এককে সর্বোচ্চ ওয়ালেট টপ-আপ; ডিফল্ট 100000 এবং minimum_cents-এর কম হবে না।",
            "maximum": 100000000,
            "minimum": 1,
            "type": "integer"
          },
          "minimum_cents": {
            "description": "ক্ষুদ্র মুদ্রা এককে সর্বনিম্ন ওয়ালেট টপ-আপ; ডিফল্ট 100।",
            "maximum": 100000000,
            "minimum": 1,
            "type": "integer"
          },
          "mode": {
            "description": "পেমেন্ট পরিবেশ। Sandbox ও live রেকর্ড বিচ্ছিন্ন।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "product_id": {
            "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
            "type": "string"
          },
          "webhook_secret": {
            "description": "সঠিক কাঁচা ওয়েবহুক বডি প্রমাণীকরণের ব্যক্তিগত এন্ডপয়েন্ট গোপন মান।",
            "maxLength": 1000,
            "type": "string",
            "writeOnly": true
          }
        },
        "required": [
          "enabled",
          "mode",
          "client_token",
          "product_id",
          "currencies",
          "expected_version"
        ],
        "type": "object"
      },
      "PaddleWebhookEvent": {
        "description": "অপরিবর্তিত Paddle Billing ইভেন্ট, Paddle-Signature দিয়ে প্রমাণীকৃত ও Paddle API দিয়ে স্বাধীনভাবে মিলন করা।",
        "type": "object"
      },
      "PasswordSet": {
        "additionalProperties": false,
        "properties": {
          "password_set": {
            "type": "boolean"
          }
        },
        "required": [
          "password_set"
        ],
        "type": "object"
      },
      "PayPalCheck": {
        "additionalProperties": false,
        "properties": {
          "connected": {
            "type": "boolean"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "PayPalInput": {
        "additionalProperties": false,
        "properties": {
          "clear_secret": {
            "type": "boolean"
          },
          "client_id": {
            "maxLength": 1000,
            "type": "string"
          },
          "client_secret": {
            "description": "clear_secret=true না হলে ফাঁকা মান সংরক্ষিত Secret রাখে",
            "maxLength": 1000,
            "type": "string",
            "writeOnly": true
          },
          "currencies": {
            "items": {
              "pattern": "^[A-Z]{3}$",
              "type": "string"
            },
            "type": "array"
          },
          "enabled": {
            "type": "boolean"
          },
          "expected_version": {
            "type": "string"
          },
          "maximum_cents": {
            "maximum": 100000000,
            "type": "integer"
          },
          "merchant_id": {
            "maxLength": 64,
            "type": "string"
          },
          "minimum_cents": {
            "minimum": 1,
            "type": "integer"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "webhook_id": {
            "maxLength": 1000,
            "type": "string"
          }
        },
        "required": [
          "enabled",
          "mode",
          "client_id",
          "merchant_id",
          "webhook_id",
          "currencies",
          "minimum_cents",
          "maximum_cents",
          "expected_version"
        ],
        "type": "object"
      },
      "PayPalOrder": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "description": "শতভাগে অর্থ; লেজার এন্ট্রি ধনাত্মক ক্রেডিট বা ঋণাত্মক ডেবিট হতে পারে।",
            "type": "integer"
          },
          "approval_url": {
            "description": "PayPal পেমেন্টকারী-অনুমোদন URL; পেমেন্টের প্রমাণ নয়।",
            "format": "uri",
            "type": "string"
          },
          "capture_id": {
            "description": "PayPal ক্যাপচার শনাক্তকারী।",
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "credited_at": {
            "anyOf": [
              {
                "description": "টপ-আপ ক্রেডিটের সময়, বা null।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "টপ-আপ ক্রেডিটের সময়, বা null।",
                "type": "null"
              }
            ],
            "description": "টপ-আপ ক্রেডিটের সময়, বা null।"
          },
          "currency": {
            "description": "তিন অক্ষরের বড় হাতের মুদ্রা কোড, যেমন USD।",
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "paypal_order_id": {
            "description": "PayPal অর্ডার শনাক্তকারী, স্থানীয় রেকর্ড UUID থেকে আলাদা।",
            "type": [
              "string",
              "null"
            ]
          },
          "purchase_id": {
            "description": "সংশ্লিষ্ট প্যাকেজ ক্রয় UUID।",
            "type": [
              "string",
              "null"
            ]
          },
          "refunded_cents": {
            "description": "শতভাগে ক্রমসঞ্চিত রিফান্ড অর্থ।",
            "type": "integer"
          },
          "request_id": {
            "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
            "type": "string"
          },
          "status": {
            "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
            "enum": [
              "creating",
              "created",
              "credited",
              "refunded"
            ],
            "type": "string"
          },
          "upgrade_id": {
            "anyOf": [
              {
                "description": "সংশ্লিষ্ট আপগ্রেড UUID, বা ফাঁকা।",
                "format": "uuid",
                "type": "string"
              },
              {
                "description": "সংশ্লিষ্ট আপগ্রেড UUID, বা ফাঁকা।",
                "type": "null"
              }
            ],
            "description": "সংশ্লিষ্ট আপগ্রেড UUID, বা ফাঁকা।"
          }
        },
        "required": [],
        "type": "object"
      },
      "PayPalOrderList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/PayPalOrder"
            },
            "type": "array"
          },
          "limit": {
            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
            "type": "integer"
          },
          "offset": {
            "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
            "type": "integer"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "PayPalRefund": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "description": "সেন্টে অনুরোধ করা মূল-মাধ্যম নগদ রিফান্ড।",
            "type": "integer"
          },
          "attempts": {
            "type": "integer"
          },
          "case_id": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "order_id": {
            "format": "uuid",
            "type": "string"
          },
          "paypal_refund_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "reason": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          },
          "reserved": {
            "description": "ওয়ালেট অর্থ আটকে থাকলে True। ট্রান্সপোর্ট টাইমআউটে একই অনুরোধ মিলন না হওয়া পর্যন্ত হোল্ড থাকে।",
            "type": "boolean"
          },
          "status": {
            "enum": [
              "pending",
              "completed",
              "failed"
            ],
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "order_id",
          "request_id",
          "mode",
          "currency",
          "amount_cents",
          "reason",
          "status",
          "reserved",
          "attempts",
          "paypal_refund_id",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "PayPalSettings": {
        "additionalProperties": false,
        "properties": {
          "client_id": {
            "maxLength": 1000,
            "type": "string"
          },
          "currencies": {
            "items": {
              "pattern": "^[A-Z]{3}$",
              "type": "string"
            },
            "type": "array"
          },
          "enabled": {
            "type": "boolean"
          },
          "maximum_cents": {
            "maximum": 100000000,
            "type": "integer"
          },
          "merchant_id": {
            "maxLength": 64,
            "type": "string"
          },
          "minimum_cents": {
            "minimum": 1,
            "type": "integer"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "secret_configured": {
            "type": "boolean"
          },
          "version": {
            "type": "string"
          },
          "webhook_id": {
            "maxLength": 1000,
            "type": "string"
          },
          "webhook_url": {
            "format": "uri",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "PaymentChannel": {
        "additionalProperties": false,
        "properties": {
          "currencies": {
            "description": "এই চ্যানেলের গৃহীত পৃথক মুদ্রা; অর্থে দুই দশমিক স্থান ব্যবহার হয়।",
            "items": {
              "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
              "type": "string"
            },
            "type": "array"
          },
          "enabled": {
            "description": "এই চ্যানেল নতুন চেকআউট গ্রহণ করে কি না। সংরক্ষিত ক্রেডেনশিয়ালে ঐতিহাসিক মিলন উপলব্ধ থাকে।",
            "type": "boolean"
          },
          "mode": {
            "description": "পেমেন্ট পরিবেশ। Sandbox ও live রেকর্ড বিচ্ছিন্ন।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "name": {
            "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
            "type": "string"
          },
          "provider": {
            "description": "পেমেন্ট প্রদানকারী: PayPal, Paddle বা Waffo Pancake।",
            "enum": [
              "paypal",
              "paddle",
              "waffo"
            ],
            "type": "string"
          },
          "version": {
            "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
            "type": "string"
          },
          "wallet_topup": {
            "description": "এই চ্যানেল নতুন চেকআউট গ্রহণ করে কি না। সংরক্ষিত ক্রেডেনশিয়ালে ঐতিহাসিক মিলন উপলব্ধ থাকে।",
            "type": "boolean"
          }
        },
        "required": [
          "provider",
          "name",
          "enabled",
          "mode",
          "currencies",
          "wallet_topup"
        ],
        "type": "object"
      },
      "PaymentChannelInput": {
        "additionalProperties": false,
        "properties": {
          "paddle_enabled": {
            "description": "এই চ্যানেল নতুন চেকআউট গ্রহণ করে কি না। সংরক্ষিত ক্রেডেনশিয়ালে ঐতিহাসিক মিলন উপলব্ধ থাকে।",
            "type": "boolean"
          },
          "paddle_version": {
            "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
            "type": "string"
          },
          "paypal_enabled": {
            "description": "এই চ্যানেল নতুন চেকআউট গ্রহণ করে কি না। সংরক্ষিত ক্রেডেনশিয়ালে ঐতিহাসিক মিলন উপলব্ধ থাকে।",
            "type": "boolean"
          },
          "paypal_version": {
            "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
            "type": "string"
          },
          "waffo_enabled": {
            "description": "ঐচ্ছিক Waffo সুইচ; বাদ দেওয়া ফিল্ড বর্তমান অবস্থা রাখে।",
            "type": "boolean"
          },
          "waffo_version": {
            "description": "Waffo সুইচ বদলাতে প্রয়োজনীয় কনফিগারেশন সংস্করণ।",
            "type": "string"
          }
        },
        "required": [
          "paypal_enabled",
          "paddle_enabled",
          "paypal_version",
          "paddle_version"
        ],
        "type": "object"
      },
      "PaymentChannels": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "এই প্রশাসক বা ওয়ার্কস্পেসের দৃশ্যমান রেকর্ড।",
            "items": {
              "$ref": "#/components/schemas/PaymentChannel"
            },
            "type": "array"
          },
          "mode": {
            "description": "পেমেন্ট পরিবেশ। Sandbox ও live রেকর্ড বিচ্ছিন্ন।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          }
        },
        "required": [
          "items",
          "mode"
        ],
        "type": "object"
      },
      "PendingPlan": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "description": "তিন অক্ষরের বড় হাতের মুদ্রা কোড, যেমন USD।",
            "type": "string"
          },
          "effective_month": {
            "description": "সময়সূচি কার্যকর হওয়ার UTC মাস YYYY-MM।",
            "type": "string"
          },
          "plan": {
            "description": "প্রকাশিত ক্যাটালগের স্থির বিলিং প্ল্যান শনাক্তকারী।",
            "type": "string"
          },
          "price_version": {
            "description": "স্থির করা মূল্য সংশোধন; পুরোনো ইনপুটের কারণে PLAN_VERSION_CONFLICT হতে পারে।",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "Period": {
        "additionalProperties": false,
        "properties": {
          "base_covered": {
            "description": "কেনা প্যাকেজ ইতিমধ্যে ভিত্তি চার্জ কভার করে কি না।",
            "type": "boolean"
          },
          "base_micros": {
            "description": "মুদ্রা এককের দশ লক্ষ ভাগে ভিত্তি চার্জ।",
            "type": "integer"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "description": "তিন অক্ষরের বড় হাতের মুদ্রা কোড, যেমন USD।",
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "hard_limit": {
            "description": "ভাতা সীমায় নতুন বিলযোগ্য ডিভাইস প্রত্যাখ্যাত হয় কি না।",
            "type": "boolean"
          },
          "included_devices": {
            "description": "অন্তর্ভুক্ত সক্রিয় ডিভাইস ভাতা।",
            "type": "integer"
          },
          "month": {
            "description": "UTC মাস YYYY-MM; বাদ দেওয়া কোয়েরি মানে বর্তমান মাস ব্যবহৃত হয়। বিলিং কাজে বন্ধ মাস প্রয়োজন।",
            "type": "string"
          },
          "payment_mode": {
            "description": "পেমেন্ট পরিবেশ, sandbox বা live।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "plan": {
            "description": "প্রকাশিত ক্যাটালগের স্থির বিলিং প্ল্যান শনাক্তকারী।",
            "type": "string"
          },
          "plan_name": {
            "description": "প্ল্যানের প্রদর্শন নাম।",
            "type": "string"
          },
          "price_version": {
            "description": "স্থির করা মূল্য সংশোধন; পুরোনো ইনপুটের কারণে PLAN_VERSION_CONFLICT হতে পারে।",
            "type": "string"
          },
          "unit_micros": {
            "description": "প্রতি অতিরিক্ত সক্রিয় ডিভাইসের মূল্য দশ লক্ষ ভাগে।",
            "type": "integer"
          }
        },
        "required": [
          "month",
          "plan",
          "currency",
          "price_version"
        ],
        "type": "object"
      },
      "PlanChange": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "description": "তিন অক্ষরের বড় হাতের মুদ্রা কোড, যেমন USD।",
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "plan": {
            "description": "প্রকাশিত ক্যাটালগের স্থির বিলিং প্ল্যান শনাক্তকারী।",
            "pattern": "^[a-z][a-z0-9_-]{0,63}$",
            "type": "string"
          },
          "price_version": {
            "description": "স্থির করা মূল্য সংশোধন; পুরোনো ইনপুটের কারণে PLAN_VERSION_CONFLICT হতে পারে।",
            "type": "string"
          }
        },
        "required": [
          "plan",
          "currency"
        ],
        "type": "object"
      },
      "PlanGift": {
        "additionalProperties": false,
        "properties": {
          "batch_id": {
            "format": "uuid",
            "type": "string"
          },
          "cancel_reason": {
            "type": "string"
          },
          "cancelled_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "cancelled_by": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "ends_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "purchase_id": {
            "format": "uuid",
            "type": "string"
          },
          "starts_at": {
            "format": "date-time",
            "type": "string"
          },
          "status": {
            "enum": [
              "granted",
              "cancelled"
            ],
            "type": "string"
          },
          "tenant_id": {
            "format": "uuid",
            "type": "string"
          },
          "user_id": {
            "format": "uuid",
            "type": "string"
          },
          "value_cents": {
            "type": "integer"
          }
        },
        "required": [
          "id",
          "batch_id",
          "tenant_id",
          "user_id",
          "purchase_id",
          "value_cents",
          "status",
          "starts_at",
          "ends_at",
          "created_at",
          "cancelled_at"
        ],
        "type": "object"
      },
      "PlanGiftBatch": {
        "additionalProperties": false,
        "properties": {
          "actor_id": {
            "format": "uuid",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "plan": {
            "type": "string"
          },
          "plan_name": {
            "type": "string"
          },
          "price_version": {
            "type": "string"
          },
          "reason": {
            "maxLength": 500,
            "minLength": 1,
            "type": "string"
          },
          "request_id": {
            "type": "string"
          },
          "start_mode": {
            "type": "string"
          },
          "tenant_count": {
            "type": "integer"
          },
          "term_months": {
            "default": 1,
            "enum": [
              1,
              3,
              6,
              12
            ],
            "type": "integer"
          },
          "user_count": {
            "type": "integer"
          }
        },
        "required": [
          "id",
          "actor_id",
          "request_id",
          "plan",
          "plan_name",
          "currency",
          "price_version",
          "term_months",
          "mode",
          "start_mode",
          "reason",
          "user_count",
          "tenant_count",
          "created_at"
        ],
        "type": "object"
      },
      "PlanGiftCancellation": {
        "additionalProperties": false,
        "properties": {
          "cancelled": {
            "type": "boolean"
          }
        },
        "required": [
          "cancelled"
        ],
        "type": "object"
      },
      "PlanGiftInput": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "maxLength": 3,
            "minLength": 3,
            "type": "string"
          },
          "fingerprint": {
            "maxLength": 64,
            "minLength": 64,
            "type": "string"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "plan": {
            "type": "string"
          },
          "price_version": {
            "type": "string"
          },
          "reason": {
            "maxLength": 500,
            "minLength": 1,
            "type": "string"
          },
          "request_id": {
            "maxLength": 80,
            "minLength": 1,
            "type": "string"
          },
          "start_mode": {
            "default": "after_current",
            "enum": [
              "after_current",
              "immediate"
            ],
            "type": "string"
          },
          "term_months": {
            "default": 1,
            "enum": [
              1,
              3,
              6,
              12
            ],
            "type": "integer"
          },
          "user_ids": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "maxItems": 100,
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          }
        },
        "required": [
          "user_ids",
          "term_months",
          "mode",
          "start_mode",
          "reason",
          "request_id",
          "fingerprint"
        ],
        "type": "object"
      },
      "PlanGiftList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/PlanGiftRow"
            },
            "type": "array"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total"
        ],
        "type": "object"
      },
      "PlanGiftPreview": {
        "additionalProperties": false,
        "properties": {
          "fingerprint": {
            "type": "string"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/PlanGiftTarget"
            },
            "type": "array"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "plan_name": {
            "type": "string"
          },
          "start_mode": {
            "default": "after_current",
            "enum": [
              "after_current",
              "immediate"
            ],
            "type": "string"
          },
          "tenant_count": {
            "type": "integer"
          },
          "term_months": {
            "default": 1,
            "enum": [
              1,
              3,
              6,
              12
            ],
            "type": "integer"
          },
          "user_count": {
            "type": "integer"
          },
          "value_cents": {
            "type": "integer"
          }
        },
        "required": [
          "fingerprint",
          "plan_name",
          "value_cents",
          "user_count",
          "tenant_count",
          "mode",
          "term_months",
          "start_mode",
          "items"
        ],
        "type": "object"
      },
      "PlanGiftPreviewInput": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "maxLength": 3,
            "minLength": 3,
            "type": "string"
          },
          "fingerprint": {
            "maxLength": 64,
            "minLength": 64,
            "type": "string"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "plan": {
            "type": "string"
          },
          "price_version": {
            "type": "string"
          },
          "reason": {
            "maxLength": 500,
            "minLength": 1,
            "type": "string"
          },
          "request_id": {
            "maxLength": 80,
            "minLength": 1,
            "type": "string"
          },
          "start_mode": {
            "default": "after_current",
            "enum": [
              "after_current",
              "immediate"
            ],
            "type": "string"
          },
          "term_months": {
            "default": 1,
            "enum": [
              1,
              3,
              6,
              12
            ],
            "type": "integer"
          },
          "user_ids": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "maxItems": 100,
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          }
        },
        "required": [
          "user_ids",
          "mode",
          "reason"
        ],
        "type": "object"
      },
      "PlanGiftResult": {
        "additionalProperties": false,
        "properties": {
          "batch": {
            "$ref": "#/components/schemas/PlanGiftBatch"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/PlanGift"
            },
            "type": "array"
          }
        },
        "required": [
          "batch",
          "items"
        ],
        "type": "object"
      },
      "PlanGiftRow": {
        "additionalProperties": false,
        "properties": {
          "actor_email": {
            "type": "string"
          },
          "batch_id": {
            "format": "uuid",
            "type": "string"
          },
          "cancel_reason": {
            "type": "string"
          },
          "cancelled_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "cancelled_by": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "ends_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "plan": {
            "type": "string"
          },
          "plan_name": {
            "type": "string"
          },
          "purchase_id": {
            "format": "uuid",
            "type": "string"
          },
          "reason": {
            "maxLength": 500,
            "minLength": 1,
            "type": "string"
          },
          "starts_at": {
            "format": "date-time",
            "type": "string"
          },
          "status": {
            "enum": [
              "granted",
              "cancelled"
            ],
            "type": "string"
          },
          "tenant_id": {
            "format": "uuid",
            "type": "string"
          },
          "tenant_name": {
            "type": "string"
          },
          "term_months": {
            "default": 1,
            "enum": [
              1,
              3,
              6,
              12
            ],
            "type": "integer"
          },
          "user_id": {
            "format": "uuid",
            "type": "string"
          },
          "value_cents": {
            "type": "integer"
          }
        },
        "required": [
          "id",
          "batch_id",
          "tenant_id",
          "user_id",
          "purchase_id",
          "value_cents",
          "status",
          "starts_at",
          "ends_at",
          "created_at",
          "cancelled_at"
        ],
        "type": "object"
      },
      "PlanGiftTarget": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "ends_at": {
            "format": "date-time",
            "type": "string"
          },
          "plan": {
            "type": "string"
          },
          "plan_name": {
            "type": "string"
          },
          "previous_end": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "price_version": {
            "type": "string"
          },
          "starts_at": {
            "format": "date-time",
            "type": "string"
          },
          "tenant_id": {
            "format": "uuid",
            "type": "string"
          },
          "tenant_name": {
            "type": "string"
          },
          "user_id": {
            "format": "uuid",
            "type": "string"
          },
          "value_cents": {
            "type": "integer"
          }
        },
        "required": [
          "user_id",
          "email",
          "tenant_id",
          "tenant_name",
          "starts_at",
          "ends_at",
          "previous_end",
          "plan",
          "plan_name",
          "currency",
          "price_version",
          "value_cents"
        ],
        "type": "object"
      },
      "PlanInput": {
        "additionalProperties": false,
        "properties": {
          "api_hard_limit": {
            "type": "boolean"
          },
          "api_unit_amount": {
            "description": "প্রতি সফল API কলে অঋণাত্মক দশমিক, সর্বাধিক ছয় দশমিক স্থান",
            "type": "string"
          },
          "base_amount": {
            "description": "অঋণাত্মক দশমিক; সর্বাধিক দুই দশমিক স্থান",
            "type": "string"
          },
          "currency": {
            "description": "কনফিগার করা আবশ্যক; EUR ক্যাটালগ অফার অক্ষম",
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "description": {
            "maxLength": 1000,
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "expected_version": {
            "description": "বর্তমান সংস্করণ; তৈরির সময় ফাঁকা",
            "type": "string"
          },
          "hard_limit": {
            "type": "boolean"
          },
          "included_api_calls": {
            "description": "null = সীমাহীন; 0 = কোনো সফল কল অন্তর্ভুক্ত নয়",
            "maximum": 1000000000000,
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          },
          "included_devices": {
            "maximum": 1000000000,
            "minimum": 0,
            "type": "integer"
          },
          "name": {
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "plan": {
            "pattern": "^[a-z][a-z0-9_-]{0,63}$",
            "type": "string"
          },
          "public": {
            "type": "boolean"
          },
          "renewal_only": {
            "description": "বিদ্যমান পরিশোধিত বা উপহারপ্রাপ্ত গ্রাহক একই পরিবেশ ও মুদ্রায় আগাম বা মেয়াদ শেষে নবায়ন করতে পারেন। নতুন প্রকাশ্য ক্রয় থেকে লুকানো।",
            "type": "boolean"
          },
          "sort_order": {
            "maximum": 10000,
            "minimum": 0,
            "type": "integer"
          },
          "terms": {
            "description": "1, 3, 6 ও 12 মাসের প্রত্যেকটির জন্য ঠিক একটি এন্ট্রি, প্রতিটির নিজস্ব উপলব্ধতা ও মোট মূল্য।",
            "items": {
              "$ref": "#/components/schemas/PlanTermInput"
            },
            "maxItems": 4,
            "minItems": 4,
            "type": "array"
          },
          "unit_amount": {
            "description": "অঋণাত্মক দশমিক; সর্বাধিক ছয় দশমিক স্থান",
            "type": "string"
          }
        },
        "required": [
          "plan",
          "currency",
          "name",
          "base_amount",
          "unit_amount"
        ],
        "type": "object"
      },
      "PlanList": {
        "additionalProperties": false,
        "properties": {
          "billing_unit": {
            "type": "string"
          },
          "currencies": {
            "items": {
              "pattern": "^[A-Z]{3}$",
              "type": "string"
            },
            "type": "array"
          },
          "default_plan": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Price"
              },
              {
                "type": "null"
              }
            ]
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/Price"
            },
            "type": "array"
          },
          "maximum_cents": {
            "type": "integer"
          },
          "minimum_cents": {
            "type": "integer"
          },
          "payment_channels": {
            "description": "উপলব্ধ পেমেন্ট চ্যানেল কনফিগারেশন। সক্রিয় বিলিং পরিবেশ ও ক্রয় মুদ্রার সঙ্গে মেলে শুধু এমন সক্ষম চ্যানেল দেখান।",
            "items": {
              "$ref": "#/components/schemas/PaymentChannel"
            },
            "type": "array"
          },
          "paypal_enabled": {
            "type": "boolean"
          },
          "sandbox": {
            "type": "boolean"
          },
          "timezone": {
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "PlanPurchase": {
        "additionalProperties": false,
        "properties": {
          "api_calls": {
            "description": "PurchaseList.active-এর জন্য: বর্তমান কোটা মাসের সফল কল। ঐতিহাসিক আইটেমে জীবনকাল মোট থাকে।",
            "type": "integer"
          },
          "api_hard_limit": {
            "description": "API ভাতা সীমায় রানটাইম কল থামে কি না।",
            "type": "boolean"
          },
          "api_overage_cents": {
            "description": "সক্রিয় দৃশ্যে বর্তমান কোটা মাস; ঐতিহাসিক আইটেমে জীবনকাল API অতিরিক্ত চার্জ।",
            "type": "integer"
          },
          "api_unit_micros": {
            "description": "প্রতি অতিরিক্ত রানটাইম কলের মূল্য দশ লক্ষ ভাগে।",
            "minimum": 0,
            "type": "integer"
          },
          "base_cents": {
            "description": "সম্পূর্ণ চুক্তির প্রকৃত প্রাথমিক চার্জ; উপহারে শূন্য। সক্রিয় কার্যকর আপগ্রেড দৃশ্যে একই মেয়াদের সম্পূর্ণ লক্ষ্য মূল্য থাকে।",
            "type": "integer"
          },
          "cancelled_at": {
            "anyOf": [
              {
                "description": "চুক্তি বাতিল টাইমস্ট্যাম্প, বা null।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "চুক্তি বাতিল টাইমস্ট্যাম্প, বা null।",
                "type": "null"
              }
            ],
            "description": "চুক্তি বাতিল টাইমস্ট্যাম্প, বা null।"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "description": "তিন অক্ষরের বড় হাতের মুদ্রা কোড, যেমন USD।",
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "current_cycle_index": {
            "description": "বর্তমান ভাতা চক্রের সূচক।",
            "maximum": 11,
            "minimum": 0,
            "type": "integer"
          },
          "current_upgrade_id": {
            "description": "আপগ্রেডের আগে ফাঁকা। অন্যথায় সর্বশেষ প্রয়োগকৃত PlanUpgrade নির্দেশ করে। সক্রিয় প্রতিক্রিয়ায় তার কার্যকর প্ল্যান স্ন্যাপশট থাকে, ঐতিহাসিক ক্রয়ে মূল বিক্রয় মূল্য থাকে।",
            "type": "string"
          },
          "cycle_ends_at": {
            "description": "বর্তমান ভাতা চক্রের শেষ, UTC।",
            "format": "date-time",
            "type": "string"
          },
          "cycle_starts_at": {
            "description": "বর্তমান ভাতা চক্রের শুরু, UTC।",
            "format": "date-time",
            "type": "string"
          },
          "effective_included_devices": {
            "description": "প্রয়োগকৃত আপগ্রেডের পর ডিভাইস ভাতা। মূল ক্রয় স্ন্যাপশট অপরিবর্তিত থাকে।",
            "minimum": 0,
            "type": "integer"
          },
          "effective_plan": {
            "description": "স্পষ্ট আপগ্রেড ওভারলের পর বর্তমান অধিকার। ক্রয় তালিকা নগদ ইতিহাসে মূল plan/base_cents রাখে; কার্যকর স্তর দেখাতে এই ফিল্ড ব্যবহার করুন।",
            "type": "string"
          },
          "effective_plan_name": {
            "description": "স্পষ্ট আপগ্রেড ওভারলের পর বর্তমান অধিকার। ক্রয় তালিকা নগদ ইতিহাসে মূল plan/base_cents রাখে; কার্যকর স্তর দেখাতে এই ফিল্ড ব্যবহার করুন।",
            "type": "string"
          },
          "ends_at": {
            "anyOf": [
              {
                "description": "প্যাকেজ বা চক্র শেষের টাইমস্ট্যাম্প, UTC; অ্যাক্টিভেশনের আগে null হতে পারে।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "প্যাকেজ বা চক্র শেষের টাইমস্ট্যাম্প, UTC; অ্যাক্টিভেশনের আগে null হতে পারে।",
                "type": "null"
              }
            ],
            "description": "প্যাকেজ বা চক্র শেষের টাইমস্ট্যাম্প, UTC; অ্যাক্টিভেশনের আগে null হতে পারে।"
          },
          "entitlement_cents": {
            "description": "আপগ্রেড ক্রেডিটের জন্য বর্তমান কার্যকর প্যাকেজের সুবিধা মূল্য, মুদ্রার সেন্টে। উপহার 99 USD প্ল্যানে 9900 সুবিধা সেন্ট থাকে যদিও মূল base_cents পেমেন্ট শূন্য। এই মূল্য নগদ রিফান্ডযোগ্য নয়। সক্রিয় প্যাকেজ দৃশ্যে পূরণ হয়।",
            "minimum": 0,
            "type": "integer"
          },
          "gift_batch_id": {
            "description": "উপহার ব্যাচ শনাক্তকারী; সাধারণ ক্রয়ে ফাঁকা।",
            "type": "string"
          },
          "gift_follows_current": {
            "default": false,
            "description": "গ্রাহকের বর্তমান স্তর থেকে ইস্যু করা উপহার বোঝায়। উপহার মূল অধিকার মূল্য ও শূন্য নগদ পেমেন্ট রাখে। স্পষ্ট সম্পূর্ণ-কভারেজ আপগ্রেড প্রতিটি অমেয়াদোত্তীর্ণ উপহারে পৃথক অধিকার ওভারলে প্রয়োগ করে এবং মূল শূন্য-নগদ উপহার রেকর্ড রাখে।",
            "type": "boolean"
          },
          "hard_limit": {
            "description": "ভাতা সীমায় নতুন বিলযোগ্য ডিভাইস প্রত্যাখ্যাত হয় কি না।",
            "type": "boolean"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "included_api_calls": {
            "description": "null = সীমাহীন; 0 = কোনো সফল কল অন্তর্ভুক্ত নয়",
            "maximum": 1000000000000,
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          },
          "included_devices": {
            "description": "অন্তর্ভুক্ত সক্রিয় ডিভাইস ভাতা।",
            "type": "integer"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "overage_cents": {
            "description": "সক্রিয় দৃশ্যে বর্তমান কোটা মাস; ঐতিহাসিক আইটেমে জীবনকাল ডিভাইস অতিরিক্ত চার্জ।",
            "type": "integer"
          },
          "plan": {
            "description": "প্রকাশিত ক্যাটালগের স্থির বিলিং প্ল্যান শনাক্তকারী।",
            "pattern": "^[a-z][a-z0-9_-]{0,63}$",
            "type": "string"
          },
          "plan_name": {
            "description": "প্ল্যানের প্রদর্শন নাম।",
            "type": "string"
          },
          "price_version": {
            "description": "স্থির করা মূল্য সংশোধন; পুরোনো ইনপুটের কারণে PLAN_VERSION_CONFLICT হতে পারে।",
            "type": "string"
          },
          "refunded_cents": {
            "description": "শতভাগে ক্রমসঞ্চিত রিফান্ড অর্থ।",
            "type": "integer"
          },
          "renewal": {
            "description": "এটি নবায়ন চুক্তি কি না।",
            "type": "boolean"
          },
          "renewal_of": {
            "description": "আগের পরিশোধিত বা উপহার প্যাকেজ ID। নবায়ন শৃঙ্খল ও মূল ক্রয় ইতিহাস রাখে।",
            "type": "string"
          },
          "request_id": {
            "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
            "type": "string"
          },
          "service_credit_basis_cents": {
            "description": "পরিষেবা-ক্রেডিট গণনার অর্থের ভিত্তি শতভাগে।",
            "type": "integer"
          },
          "service_credit_basis_seconds": {
            "description": "পরিষেবা-ক্রেডিট গণনার সময় ভিত্তি সেকেন্ডে।",
            "type": "integer"
          },
          "source": {
            "description": "অধিকারের উৎস, যেমন purchase বা gift।",
            "enum": [
              "purchase",
              "gift",
              "auto_renewal"
            ],
            "type": "string"
          },
          "starts_at": {
            "anyOf": [
              {
                "description": "প্যাকেজ বা চক্র শুরুর টাইমস্ট্যাম্প, UTC।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "প্যাকেজ বা চক্র শুরুর টাইমস্ট্যাম্প, UTC।",
                "type": "null"
              }
            ],
            "description": "প্যাকেজ বা চক্র শুরুর টাইমস্ট্যাম্প, UTC।"
          },
          "status": {
            "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
            "enum": [
              "pending",
              "active",
              "cancelled",
              "expired"
            ],
            "type": "string"
          },
          "term_months": {
            "default": 1,
            "description": "কেনা মেয়াদে মাসের সংখ্যা।",
            "enum": [
              1,
              3,
              6,
              12
            ],
            "type": "integer"
          },
          "total_api_calls": {
            "description": "সম্পূর্ণ চুক্তিতে ক্রমসঞ্চিত রানটাইম কল।",
            "type": "integer"
          },
          "total_api_overage_cents": {
            "description": "চুক্তির ক্রমসঞ্চিত API অতিরিক্ত চার্জ শতভাগে।",
            "type": "integer"
          },
          "total_device_overage_cents": {
            "description": "চুক্তির ক্রমসঞ্চিত ডিভাইস অতিরিক্ত চার্জ শতভাগে।",
            "type": "integer"
          },
          "unit_micros": {
            "description": "প্রতি অতিরিক্ত সক্রিয় ডিভাইসের মূল্য দশ লক্ষ ভাগে।",
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "PlanTermInput": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "description": "অঋণাত্মক মেয়াদ মোট; সর্বাধিক দুই দশমিক স্থান। এক মাসের অর্থ base_amount-এর সমান হতে হবে।",
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "months": {
            "default": 1,
            "enum": [
              1,
              3,
              6,
              12
            ],
            "type": "integer"
          }
        },
        "required": [
          "months",
          "enabled",
          "amount"
        ],
        "type": "object"
      },
      "PlanTermPrice": {
        "additionalProperties": false,
        "properties": {
          "base_cents": {
            "description": "নির্বাচিত মেয়াদের মোট চার্জ, মুদ্রার সেন্টে। মাসিক কোটা এই মেয়াদ দিয়ে গুণ করা হয় না।",
            "minimum": 0,
            "type": "integer"
          },
          "enabled": {
            "description": "ওয়েবহুক এন্ডপয়েন্ট সক্ষম কি না।",
            "type": "boolean"
          },
          "months": {
            "default": 1,
            "description": "ক্রয় মেয়াদে মাসের সংখ্যা।",
            "enum": [
              1,
              3,
              6,
              12
            ],
            "type": "integer"
          }
        },
        "required": [
          "months",
          "enabled",
          "base_cents"
        ],
        "type": "object"
      },
      "PlanUpgrade": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "description": "parts-এর প্রতিটি আইটেমের সম্মিলিত পেমেন্ট। একবার পরমাণুভাবে চার্জ হয়। প্যারেন্টের অন্য আনুপাতিক ফিল্ড শুধু বর্তমান সময় বর্ণনা করে; প্রতিটি সময়ের মূল মূল্য, লক্ষ্য মূল্য, অবশিষ্ট সেকেন্ড ও পৃথক পার্থক্য parts-এ দেখুন।",
            "type": "integer"
          },
          "api_hard_limit": {
            "description": "API ভাতা সীমায় রানটাইম কল থামে কি না।",
            "type": "boolean"
          },
          "api_unit_micros": {
            "description": "মুদ্রার দশ লক্ষ ভাগে নতুন API অতিরিক্ত ব্যবহার হার।",
            "type": "integer"
          },
          "applied_at": {
            "anyOf": [
              {
                "description": "আপগ্রেড কার্যকর হওয়ার সময়, বা null।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "আপগ্রেড কার্যকর হওয়ার সময়, বা null।",
                "type": "null"
              }
            ],
            "description": "আপগ্রেড কার্যকর হওয়ার সময়, বা null।"
          },
          "base_cents": {
            "description": "সেন্টে লক্ষ্য মাসিক মূল্য, এখন প্রদেয় অর্থ নয়।",
            "type": "integer"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "description": "বর্তমান প্যাকেজের একই মুদ্রা।",
            "type": "string"
          },
          "cycle_seconds": {
            "description": "মূল কেনা চক্রের দৈর্ঘ্য সেকেন্ডে।",
            "type": "integer"
          },
          "ends_at": {
            "description": "প্যাকেজ বা চক্র শেষের টাইমস্ট্যাম্প, UTC; অ্যাক্টিভেশনের আগে null হতে পারে।",
            "format": "date-time",
            "type": "string"
          },
          "expires_at": {
            "description": "তৈরির 15 মিনিট পরে বা মূল প্ল্যানের মেয়াদ শেষ, যেটি আগে।",
            "format": "date-time",
            "type": "string"
          },
          "hard_limit": {
            "description": "ভাতা সীমায় নতুন বিলযোগ্য ডিভাইস প্রত্যাখ্যাত হয় কি না।",
            "type": "boolean"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "included_api_calls": {
            "anyOf": [
              {
                "description": "বিদ্যমান চক্রের মোট API ভাতা। Null মানে সীমাহীন। আগের কল এখনও গণনায়।",
                "type": "integer"
              },
              {
                "description": "অন্তর্ভুক্ত সফল রানটাইম কল; null মানে সীমাহীন এবং 0 মানে কোনোটি অন্তর্ভুক্ত নয়।",
                "type": "null"
              }
            ],
            "description": "অন্তর্ভুক্ত সফল রানটাইম কল; null মানে সীমাহীন এবং 0 মানে কোনোটি অন্তর্ভুক্ত নয়।"
          },
          "included_devices": {
            "description": "বিদ্যমান চক্রের মোট ভাতা; পূর্বের ডিভাইস ব্যবহার এখনও গণনায়।",
            "type": "integer"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "parent_id": {
            "description": "অভ্যন্তরীণ প্রয়োগকৃত অধিকার ওভারলে একক প্যারেন্ট চার্জ নির্দেশ করে। এই চাইল্ড রেকর্ড গ্রাহক আপগ্রেড ইতিহাস ও বিক্রয় গণনা থেকে বাদ।",
            "format": "uuid",
            "type": "string"
          },
          "parts": {
            "description": "মেয়াদ না শেষ হওয়া বর্তমান ও ভবিষ্যতের সব পরিশোধিত/উপহার সময়, তারিখক্রমে। সম্পূর্ণ-কভারেজ আপগ্রেড বাধ্যতামূলক; সময়ের উপসেট নির্বাচন করা যায় না।",
            "items": {
              "$ref": "#/components/schemas/UpgradePart"
            },
            "type": "array"
          },
          "plan": {
            "description": "প্রকাশিত ক্যাটালগের স্থির বিলিং প্ল্যান শনাক্তকারী।",
            "type": "string"
          },
          "plan_name": {
            "description": "প্ল্যানের প্রদর্শন নাম।",
            "type": "string"
          },
          "previous_base_cents": {
            "description": "সেন্টে কার্যকর বর্তমান মাসিক মূল্য।",
            "type": "integer"
          },
          "previous_plan_name": {
            "description": "আপগ্রেডের আগে প্ল্যানের প্রদর্শন নাম।",
            "type": "string"
          },
          "previous_upgrade_id": {
            "description": "আগের আপগ্রেড ID, বা প্রথম আপগ্রেডে ফাঁকা। পুরোনো কোট প্রত্যাখ্যানে ব্যবহৃত।",
            "type": "string"
          },
          "price_version": {
            "description": "লক্ষ্য মূল্যের স্থির করা সংস্করণ।",
            "type": "string"
          },
          "purchase_id": {
            "description": "সংশ্লিষ্ট প্যাকেজ ক্রয় UUID।",
            "format": "uuid",
            "type": "string"
          },
          "remaining_seconds": {
            "description": "কোট তৈরির সময় অবশিষ্ট সেকেন্ড, ঊর্ধ্বমুখে পূর্ণসংখ্যায়।",
            "type": "integer"
          },
          "request_id": {
            "description": "স্থির ক্লায়েন্ট-তৈরি কী। ভিন্ন কোট প্যারামিটারে পুনর্ব্যবহারে 409 ফেরত আসে।",
            "type": "string"
          },
          "status": {
            "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
            "enum": [
              "pending",
              "applied",
              "expired"
            ],
            "type": "string"
          },
          "unit_micros": {
            "description": "মুদ্রার দশ লক্ষ ভাগে প্রতি ডিভাইস নতুন অতিরিক্ত ব্যবহার হার।",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "request_id",
          "mode",
          "purchase_id",
          "previous_upgrade_id",
          "plan",
          "plan_name",
          "previous_plan_name",
          "currency",
          "price_version",
          "previous_base_cents",
          "base_cents",
          "amount_cents",
          "included_devices",
          "unit_micros",
          "hard_limit",
          "included_api_calls",
          "api_unit_micros",
          "api_hard_limit",
          "remaining_seconds",
          "cycle_seconds",
          "ends_at",
          "expires_at",
          "status",
          "created_at",
          "applied_at"
        ],
        "type": "object"
      },
      "PlatformOperation": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string"
          },
          "actor_email": {
            "type": "string"
          },
          "actor_id": {
            "format": "uuid",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "details": {
            "description": "শুধু স্পষ্ট প্রশাসনিক পরিবর্তনসহ JSON স্ট্রিং; পাসওয়ার্ড, টোকেন বা পেমেন্ট ক্রেডেনশিয়াল কখনো নয়।",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "reason": {
            "maxLength": 500,
            "minLength": 1,
            "type": "string"
          },
          "request_id": {
            "type": "string"
          },
          "resource_id": {
            "type": "string"
          },
          "tenant_id": {
            "type": "string"
          },
          "user_email": {
            "type": "string"
          },
          "user_id": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "actor_id",
          "action",
          "user_id",
          "tenant_id",
          "resource_id",
          "reason",
          "details",
          "request_id",
          "created_at",
          "actor_email",
          "user_email"
        ],
        "type": "object"
      },
      "PlatformOperationList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/PlatformOperation"
            },
            "type": "array"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total"
        ],
        "type": "object"
      },
      "PlatformOverview": {
        "additionalProperties": false,
        "properties": {
          "at": {
            "format": "date-time",
            "type": "string"
          },
          "counts": {
            "additionalProperties": false,
            "properties": {
              "active_packages": {
                "type": "integer"
              },
              "active_workspaces": {
                "type": "integer"
              },
              "disabled_users": {
                "type": "integer"
              },
              "enabled_plans": {
                "type": "integer"
              },
              "expiring_packages": {
                "type": "integer"
              },
              "failed_mail": {
                "type": "integer"
              },
              "gift_packages": {
                "type": "integer"
              },
              "new_users": {
                "type": "integer"
              },
              "suspended_workspaces": {
                "type": "integer"
              },
              "users": {
                "type": "integer"
              },
              "verified_users": {
                "type": "integer"
              }
            },
            "required": [
              "users",
              "verified_users",
              "disabled_users",
              "new_users",
              "active_workspaces",
              "suspended_workspaces",
              "active_packages",
              "expiring_packages",
              "gift_packages",
              "failed_mail",
              "enabled_plans"
            ],
            "type": "object"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "paypal_enabled": {
            "type": "boolean"
          }
        },
        "required": [
          "counts",
          "mode",
          "paypal_enabled",
          "at"
        ],
        "type": "object"
      },
      "PlatformReason": {
        "additionalProperties": false,
        "properties": {
          "reason": {
            "maxLength": 500,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "reason"
        ],
        "type": "object"
      },
      "PlatformRevocation": {
        "additionalProperties": false,
        "properties": {
          "revoked": {
            "type": "boolean"
          }
        },
        "required": [
          "revoked"
        ],
        "type": "object"
      },
      "PlatformUser": {
        "additionalProperties": false,
        "properties": {
          "admin_note": {
            "description": "ব্যক্তিগত প্ল্যাটফর্ম নোট। গ্রাহক প্রোফাইল ফিল্ড অপরিবর্তিত।",
            "maxLength": 2000,
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "email": {
            "format": "email",
            "type": "string"
          },
          "email_verified_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "is_platform_admin": {
            "type": "boolean"
          },
          "last_login_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "type": "string"
          },
          "note_version": {
            "type": "string"
          },
          "role": {
            "enum": [
              "owner",
              "read_only"
            ],
            "type": "string"
          },
          "status": {
            "enum": [
              "active",
              "disabled"
            ],
            "type": "string"
          },
          "tenant_id": {
            "format": "uuid",
            "type": "string"
          },
          "tenant_name": {
            "type": "string"
          },
          "tenant_status": {
            "enum": [
              "active",
              "suspended"
            ],
            "type": "string"
          },
          "tenant_updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "tenant_id",
          "tenant_name",
          "tenant_status",
          "tenant_updated_at",
          "email",
          "name",
          "role",
          "status",
          "is_platform_admin",
          "email_verified_at",
          "created_at",
          "updated_at",
          "last_login_at",
          "admin_note",
          "note_version"
        ],
        "type": "object"
      },
      "PlatformUserDetail": {
        "additionalProperties": false,
        "properties": {
          "counts": {
            "additionalProperties": false,
            "properties": {
              "licenses": {
                "type": "integer"
              },
              "products": {
                "type": "integer"
              },
              "users": {
                "type": "integer"
              }
            },
            "required": [
              "users",
              "products",
              "licenses"
            ],
            "type": "object"
          },
          "payments": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "currency": {
                  "type": "string"
                },
                "mode": {
                  "enum": [
                    "sandbox",
                    "live"
                  ],
                  "type": "string"
                },
                "paid_cents": {
                  "type": "integer"
                },
                "refunded_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "mode",
                "currency",
                "paid_cents",
                "refunded_cents"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "purchases": {
            "items": {
              "$ref": "#/components/schemas/PlanPurchase"
            },
            "type": "array"
          },
          "user": {
            "$ref": "#/components/schemas/PlatformUser"
          },
          "wallets": {
            "items": {
              "$ref": "#/components/schemas/Wallet"
            },
            "type": "array"
          }
        },
        "required": [
          "user",
          "counts",
          "wallets",
          "purchases",
          "payments"
        ],
        "type": "object"
      },
      "PlatformUserList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/PlatformUser"
            },
            "type": "array"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total"
        ],
        "type": "object"
      },
      "PlatformUserUpdate": {
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "status",
              "expected_updated_at"
            ]
          },
          {
            "required": [
              "admin_note",
              "expected_note_version"
            ]
          }
        ],
        "properties": {
          "admin_note": {
            "maxLength": 2000,
            "type": "string"
          },
          "expected_note_version": {
            "type": "string"
          },
          "expected_updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "reason": {
            "maxLength": 500,
            "minLength": 1,
            "type": "string"
          },
          "status": {
            "enum": [
              "active",
              "disabled"
            ],
            "type": "string"
          }
        },
        "required": [
          "reason"
        ],
        "type": "object"
      },
      "PlatformWorkspaceStatus": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "status": {
            "enum": [
              "active",
              "suspended"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "status"
        ],
        "type": "object"
      },
      "PlatformWorkspaceUpdate": {
        "additionalProperties": false,
        "properties": {
          "expected_updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "reason": {
            "maxLength": 500,
            "minLength": 1,
            "type": "string"
          },
          "status": {
            "enum": [
              "active",
              "suspended"
            ],
            "type": "string"
          }
        },
        "required": [
          "status",
          "reason",
          "expected_updated_at"
        ],
        "type": "object"
      },
      "Policy": {
        "additionalProperties": false,
        "example": {
          "created_at": "2026-10-18T00:00:00Z",
          "features": [
            "export"
          ],
          "heartbeat_seconds": 600,
          "id": "22222222-2222-4222-8222-222222222222",
          "max_devices": 1,
          "mode": "timed",
          "name": "One device",
          "offline_mode": "limited",
          "offline_seconds": 86400,
          "product_id": "11111111-1111-4111-8111-111111111111",
          "updated_at": "2026-10-18T00:00:00Z",
          "version": 1
        },
        "properties": {
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "features": {
            "description": "সর্বাধিক 32 পৃথক ফিচার শনাক্তকারী, প্রতিটি 1–64 ASCII বর্ণ, সংখ্যা, বিন্দু, ড্যাশ বা আন্ডারস্কোর।",
            "items": {
              "pattern": "^[A-Za-z0-9_.-]{1,64}$",
              "type": "string"
            },
            "maxItems": 32,
            "type": "array",
            "uniqueItems": true
          },
          "heartbeat_seconds": {
            "anyOf": [
              {
                "const": 0,
                "description": "হার্টবিট ব্যবধান সেকেন্ডে: 0 নিষ্ক্রিয় করে; অন্যথায় 600–86400। বাদ দিলে সার্ভার ডিফল্ট; অফলাইন ভাতা থেকে স্বাধীন।"
              },
              {
                "description": "হার্টবিট ব্যবধান সেকেন্ডে: 0 নিষ্ক্রিয় করে; অন্যথায় 600–86400। বাদ দিলে সার্ভার ডিফল্ট; অফলাইন ভাতা থেকে স্বাধীন।",
                "maximum": 86400,
                "minimum": 600,
                "type": "integer"
              }
            ],
            "description": "অনলাইনে হার্টবিটের ব্যবধান, সেকেন্ডে। 0 নিয়মিত হার্টবিট বন্ধ করে। অফলাইন সময় আলাদা।",
            "type": "integer"
          },
          "id": {
            "description": "নীতি UUID, লাইসেন্সে policy_id হিসেবে ব্যবহৃত।",
            "format": "uuid",
            "type": "string"
          },
          "max_devices": {
            "description": "প্রতি লাইসেন্স সর্বাধিক সমসাময়িক ডিভাইস বা floating সিট।",
            "type": "integer"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "perpetual",
              "timed",
              "trial"
            ],
            "type": "string"
          },
          "name": {
            "description": "মানুষের পড়ার উপযোগী নাম; দৈর্ঘ্যের সীমা দেখুন।",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "offline_mode": {
            "description": "limited সীমিত অফলাইন; none নিষিদ্ধ; permanent বাড়তি সীমা নেই, তবে লাইসেন্স মেয়াদ প্রযোজ্য।",
            "enum": [
              "limited",
              "none",
              "permanent"
            ],
            "type": "string"
          },
          "offline_seconds": {
            "description": "অনুমোদিত অফলাইন সেকেন্ড: limited-এর জন্য 1–31536000, none/permanent-এর জন্য 0। এটি হার্টবিটের ব্যবধান নয়। হার্টবিট চালু থাকলে নতুন সীমিত অফলাইন নীতিতে offline_seconds \u003e= 3 × heartbeat_seconds হতে হবে; ফ্লোটিং আসনের লিজেও অন্তত তিনটি হার্টবিট ব্যবধান থাকতে হবে।",
            "maximum": 31536000,
            "minimum": 0,
            "type": "integer"
          },
          "product_id": {
            "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
            "format": "uuid",
            "type": "string"
          },
          "updated_at": {
            "description": "UTC-তে সর্বশেষ আপডেট টাইমস্ট্যাম্প।",
            "format": "date-time",
            "type": "string"
          },
          "version": {
            "description": "প্রতি পরিবর্তনে নীতি সংস্করণ বাড়ে। পুরোনো লাইসেন্সে প্রয়োগে প্রিভিউ এখনও বর্তমান কি না দেখে।",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "product_id",
          "mode",
          "version"
        ],
        "type": "object"
      },
      "PolicyCapabilities": {
        "additionalProperties": false,
        "properties": {
          "allow_vm": {
            "description": "ভার্চুয়াল মেশিন অনুমোদিত কি না।",
            "type": "boolean"
          },
          "device_match": {
            "description": "system পরিচয় মিল বা হার্ডওয়্যার পরিচয় মিল।",
            "enum": [
              "system",
              "hardware"
            ],
            "type": "string"
          },
          "license_model": {
            "description": "node_locked ডিভাইস বাইন্ডিং বা floating সিট।",
            "enum": [
              "node_locked",
              "floating"
            ],
            "type": "string"
          },
          "maintenance_days": {
            "description": "প্রথম অ্যাক্টিভেশন থেকে রক্ষণাবেক্ষণ দিন; 0 মানে রক্ষণাবেক্ষণ কাটঅফ নেই।",
            "maximum": 36500,
            "minimum": 0,
            "type": "integer"
          },
          "max_version": {
            "description": "সর্বোচ্চ অনুমোদিত অ্যাপ সংস্করণ; ফাঁকা মানে ঊর্ধ্বসীমা নেই।",
            "type": "string"
          },
          "meter_rules": {
            "description": "ফিচার মিটারিং নিয়ম; ফাঁকা মানে কনফিগার করা নেই।",
            "items": {
              "additionalProperties": false,
              "properties": {
                "allow_overage": {
                  "description": "অতিরিক্ত ফিচার ব্যবহার অনুমোদিত কি না।",
                  "type": "boolean"
                },
                "feature": {
                  "description": "মিটার করা ফিচার শনাক্তকারী, নীতির ফিচারে থাকতে হবে।",
                  "pattern": "^[A-Za-z0-9_.-]{1,64}$",
                  "type": "string"
                },
                "limit": {
                  "description": "প্রতি মিটারিং সময়ে অন্তর্ভুক্ত ফিচার ব্যবহার (পৃষ্ঠাবিন্যাস সীমা নয়)।",
                  "maximum": 1000000000000,
                  "minimum": 0,
                  "type": "integer"
                },
                "max_overage": {
                  "description": "সর্বাধিক অনুমোদিত অতিরিক্ত ব্যবহার; allow_overage false হলে নিষ্ক্রিয়।",
                  "maximum": 1000000000000,
                  "minimum": 0,
                  "type": "integer"
                },
                "period": {
                  "description": "ডিফল্ট UTC মাসিক বিলিং স্ন্যাপশট; মিটার নিয়ম month/day/lifetime এবং ব্যবহার সারি নির্দিষ্ট সময়কাল কী ব্যবহার করে।",
                  "enum": [
                    "month",
                    "day",
                    "lifetime"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "feature",
                "limit",
                "period"
              ],
              "type": "object"
            },
            "maxItems": 32,
            "type": "array"
          },
          "min_version": {
            "description": "সর্বনিম্ন অনুমোদিত অ্যাপ সংস্করণ; ফাঁকা মানে নিম্নসীমা নেই।",
            "type": "string"
          },
          "policy_id": {
            "description": "নীতি UUID; ইস্যুর সময় পণ্যের অন্তর্ভুক্ত হতে হবে।",
            "format": "uuid",
            "type": "string"
          },
          "policy_version": {
            "description": "নীতি সংশোধন; পুরোনো লেখা ঠেকাতে সম্পূর্ণ সক্ষমতা সম্পাদনায় বর্তমান মান পাঠান।",
            "type": "integer"
          },
          "product_id": {
            "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
            "format": "uuid",
            "type": "string"
          },
          "require_hardware": {
            "description": "ব্যবহারযোগ্য হার্ডওয়্যার পরিচয় প্রয়োজন কি না।",
            "type": "boolean"
          },
          "self_release_limit": {
            "description": "চলমান 30 দিনে অনুমোদিত স্ব-পরিষেবা রিলিজ, 0–100; 0 নিষ্ক্রিয় করে।",
            "maximum": 100,
            "minimum": 0,
            "type": "integer"
          },
          "session_seconds": {
            "description": "হার্টবিট ছাড়া floating সিট লিজ সেকেন্ড, 20–86400; নীতির রানটাইম সীমা পূরণ করতে হবে।",
            "maximum": 86400,
            "minimum": 20,
            "type": "integer"
          },
          "updated_at": {
            "description": "UTC-তে সর্বশেষ আপডেট টাইমস্ট্যাম্প।",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "PolicyCapabilitiesInput": {
        "additionalProperties": false,
        "description": "ইস্যু মোড, ডিভাইস/সিট সীমা, ফিচার ও রানটাইম নিয়ম সংজ্ঞায়িত করে। নীতিতে বৈধতা মেয়াদ সংরক্ষিত হয় না। পুরোনো সম্পাদনা আটকাতে policy_version প্রয়োজন।",
        "properties": {
          "allow_vm": {
            "description": "ভার্চুয়াল মেশিন অনুমোদিত কি না।",
            "type": "boolean"
          },
          "device_match": {
            "description": "system পরিচয় মিল বা হার্ডওয়্যার পরিচয় মিল।",
            "enum": [
              "system",
              "hardware"
            ],
            "type": "string"
          },
          "features": {
            "description": "সর্বাধিক 32 পৃথক ফিচার শনাক্তকারী, প্রতিটি 1–64 ASCII বর্ণ, সংখ্যা, বিন্দু, ড্যাশ বা আন্ডারস্কোর।",
            "items": {
              "pattern": "^[A-Za-z0-9_.-]{1,64}$",
              "type": "string"
            },
            "maxItems": 32,
            "type": "array",
            "uniqueItems": true
          },
          "heartbeat_seconds": {
            "anyOf": [
              {
                "const": 0,
                "description": "হার্টবিট ব্যবধান সেকেন্ডে: 0 নিষ্ক্রিয় করে; অন্যথায় 600–86400। বাদ দিলে সার্ভার ডিফল্ট; অফলাইন ভাতা থেকে স্বাধীন।"
              },
              {
                "description": "হার্টবিট ব্যবধান সেকেন্ডে: 0 নিষ্ক্রিয় করে; অন্যথায় 600–86400। বাদ দিলে সার্ভার ডিফল্ট; অফলাইন ভাতা থেকে স্বাধীন।",
                "maximum": 86400,
                "minimum": 600,
                "type": "integer"
              }
            ],
            "description": "0 স্পষ্টভাবে পর্যায়ক্রমিক হার্টবিট বন্ধ করে; অন্যথায় 600–86400 সেকেন্ড (ন্যূনতম 10 মিনিট)। অফলাইন ভাতা থেকে স্বাধীন।",
            "type": "integer"
          },
          "license_model": {
            "description": "node_locked ডিভাইস বাইন্ডিং বা floating সিট।",
            "enum": [
              "node_locked",
              "floating"
            ],
            "type": "string"
          },
          "maintenance_days": {
            "description": "প্রথম অ্যাক্টিভেশন থেকে রক্ষণাবেক্ষণ দিন; 0 মানে রক্ষণাবেক্ষণ কাটঅফ নেই।",
            "maximum": 36500,
            "minimum": 0,
            "type": "integer"
          },
          "max_devices": {
            "description": "প্রতি লাইসেন্স সর্বাধিক সমসাময়িক ডিভাইস বা floating সিট।",
            "maximum": 10000,
            "minimum": 1,
            "type": "integer"
          },
          "max_version": {
            "description": "সর্বোচ্চ অনুমোদিত অ্যাপ সংস্করণ; ফাঁকা মানে ঊর্ধ্বসীমা নেই।",
            "type": "string"
          },
          "meter_rules": {
            "description": "ফিচার মিটারিং নিয়ম; ফাঁকা মানে কনফিগার করা নেই।",
            "items": {
              "additionalProperties": false,
              "properties": {
                "allow_overage": {
                  "description": "অতিরিক্ত ফিচার ব্যবহার অনুমোদিত কি না।",
                  "type": "boolean"
                },
                "feature": {
                  "description": "মিটার করা ফিচার শনাক্তকারী, নীতির ফিচারে থাকতে হবে।",
                  "pattern": "^[A-Za-z0-9_.-]{1,64}$",
                  "type": "string"
                },
                "limit": {
                  "description": "প্রতি মিটারিং সময়ে অন্তর্ভুক্ত ফিচার ব্যবহার (পৃষ্ঠাবিন্যাস সীমা নয়)।",
                  "maximum": 1000000000000,
                  "minimum": 0,
                  "type": "integer"
                },
                "max_overage": {
                  "description": "সর্বাধিক অনুমোদিত অতিরিক্ত ব্যবহার; allow_overage false হলে নিষ্ক্রিয়।",
                  "maximum": 1000000000000,
                  "minimum": 0,
                  "type": "integer"
                },
                "period": {
                  "description": "ডিফল্ট UTC মাসিক বিলিং স্ন্যাপশট; মিটার নিয়ম month/day/lifetime এবং ব্যবহার সারি নির্দিষ্ট সময়কাল কী ব্যবহার করে।",
                  "enum": [
                    "month",
                    "day",
                    "lifetime"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "feature",
                "limit",
                "period"
              ],
              "type": "object"
            },
            "maxItems": 32,
            "type": "array"
          },
          "min_version": {
            "description": "সর্বনিম্ন অনুমোদিত অ্যাপ সংস্করণ; ফাঁকা মানে নিম্নসীমা নেই।",
            "type": "string"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "perpetual",
              "timed",
              "trial"
            ],
            "type": "string"
          },
          "name": {
            "description": "মানুষের পড়ার উপযোগী নাম; দৈর্ঘ্যের সীমা দেখুন।",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "offline_mode": {
            "description": "limited, none বা permanent অফলাইন ভাতা; লাইসেন্সের মেয়াদ এখনও প্রযোজ্য।",
            "enum": [
              "limited",
              "none",
              "permanent"
            ],
            "type": "string"
          },
          "offline_seconds": {
            "description": "Limited: 1–31536000 সেকেন্ড এবং হার্টবিট চালু থাকলে অন্তত 3 × heartbeat_seconds; none/permanent: 0",
            "maximum": 31536000,
            "minimum": 0,
            "type": "integer"
          },
          "policy_version": {
            "description": "নীতি সংশোধন; পুরোনো লেখা ঠেকাতে সম্পূর্ণ সক্ষমতা সম্পাদনায় বর্তমান মান পাঠান।",
            "minimum": 1,
            "type": "integer"
          },
          "require_hardware": {
            "description": "ব্যবহারযোগ্য হার্ডওয়্যার পরিচয় প্রয়োজন কি না।",
            "type": "boolean"
          },
          "self_release_limit": {
            "description": "চলমান 30 দিনে অনুমোদিত স্ব-পরিষেবা রিলিজ, 0–100; 0 নিষ্ক্রিয় করে।",
            "maximum": 100,
            "minimum": 0,
            "type": "integer"
          },
          "session_seconds": {
            "description": "হার্টবিট ছাড়া floating সিট লিজ সেকেন্ড, 20–86400; নীতির রানটাইম সীমা পূরণ করতে হবে।",
            "maximum": 86400,
            "minimum": 20,
            "type": "integer"
          }
        },
        "required": [
          "policy_version"
        ],
        "type": "object"
      },
      "PolicyCreate": {
        "additionalProperties": false,
        "description": "ইস্যু মোড, ডিভাইস/সিট সীমা, ফিচার ও রানটাইম নিয়ম সংজ্ঞায়িত করে। নীতিতে বৈধতার মেয়াদ সংরক্ষিত হয় না।",
        "properties": {
          "allow_vm": {
            "description": "ভার্চুয়াল মেশিন অনুমোদিত কি না।",
            "type": "boolean"
          },
          "device_match": {
            "description": "system পরিচয় মিল বা হার্ডওয়্যার পরিচয় মিল।",
            "enum": [
              "system",
              "hardware"
            ],
            "type": "string"
          },
          "features": {
            "description": "অনুমোদিত ফিচার, যেমন [\"export\"]। অ্যাপের CheckFeature মানের সঙ্গে মিলবে।",
            "items": {
              "pattern": "^[A-Za-z0-9_.-]{1,64}$",
              "type": "string"
            },
            "maxItems": 32,
            "type": "array",
            "uniqueItems": true
          },
          "heartbeat_seconds": {
            "anyOf": [
              {
                "const": 0,
                "description": "হার্টবিট ব্যবধান সেকেন্ডে: 0 নিষ্ক্রিয় করে; অন্যথায় 600–86400। বাদ দিলে সার্ভার ডিফল্ট; অফলাইন ভাতা থেকে স্বাধীন।"
              },
              {
                "description": "হার্টবিট ব্যবধান সেকেন্ডে: 0 নিষ্ক্রিয় করে; অন্যথায় 600–86400। বাদ দিলে সার্ভার ডিফল্ট; অফলাইন ভাতা থেকে স্বাধীন।",
                "maximum": 86400,
                "minimum": 600,
                "type": "integer"
              }
            ],
            "description": "অনলাইনে হার্টবিটের ব্যবধান, সেকেন্ডে। 0 নিয়মিত হার্টবিট বন্ধ করে। অফলাইন সময় আলাদা।",
            "type": "integer"
          },
          "license_model": {
            "description": "node_locked ডিভাইস বাইন্ডিং বা floating সিট।",
            "enum": [
              "node_locked",
              "floating"
            ],
            "type": "string"
          },
          "maintenance_days": {
            "description": "প্রথম অ্যাক্টিভেশন থেকে রক্ষণাবেক্ষণ দিন; 0 মানে রক্ষণাবেক্ষণ কাটঅফ নেই।",
            "maximum": 36500,
            "minimum": 0,
            "type": "integer"
          },
          "max_devices": {
            "description": "প্রতি লাইসেন্সে 1–10000 ডিভাইস; ফ্লোটিং-এ একযোগে সিট সীমা।",
            "maximum": 10000,
            "minimum": 1,
            "type": "integer"
          },
          "max_version": {
            "description": "সর্বোচ্চ অনুমোদিত অ্যাপ সংস্করণ; ফাঁকা মানে ঊর্ধ্বসীমা নেই।",
            "type": "string"
          },
          "meter_rules": {
            "description": "ফিচার মিটারিং নিয়ম; ফাঁকা মানে কনফিগার করা নেই।",
            "items": {
              "additionalProperties": false,
              "properties": {
                "allow_overage": {
                  "description": "অতিরিক্ত ফিচার ব্যবহার অনুমোদিত কি না।",
                  "type": "boolean"
                },
                "feature": {
                  "description": "মিটার করা ফিচার শনাক্তকারী, নীতির ফিচারে থাকতে হবে।",
                  "pattern": "^[A-Za-z0-9_.-]{1,64}$",
                  "type": "string"
                },
                "limit": {
                  "description": "প্রতি মিটারিং সময়ে অন্তর্ভুক্ত ফিচার ব্যবহার (পৃষ্ঠাবিন্যাস সীমা নয়)।",
                  "maximum": 1000000000000,
                  "minimum": 0,
                  "type": "integer"
                },
                "max_overage": {
                  "description": "সর্বাধিক অনুমোদিত অতিরিক্ত ব্যবহার; allow_overage false হলে নিষ্ক্রিয়।",
                  "maximum": 1000000000000,
                  "minimum": 0,
                  "type": "integer"
                },
                "period": {
                  "description": "ডিফল্ট UTC মাসিক বিলিং স্ন্যাপশট; মিটার নিয়ম month/day/lifetime এবং ব্যবহার সারি নির্দিষ্ট সময়কাল কী ব্যবহার করে।",
                  "enum": [
                    "month",
                    "day",
                    "lifetime"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "feature",
                "limit",
                "period"
              ],
              "type": "object"
            },
            "maxItems": 32,
            "type": "array"
          },
          "min_version": {
            "description": "সর্বনিম্ন অনুমোদিত অ্যাপ সংস্করণ; ফাঁকা মানে নিম্নসীমা নেই।",
            "type": "string"
          },
          "mode": {
            "description": "লাইসেন্স ধরন: perpetual স্থায়ী, timed সীমিত, trial পরীক্ষা। বিলিং প্ল্যান সাবস্ক্রিপশন নয়।",
            "enum": [
              "perpetual",
              "timed",
              "trial"
            ],
            "type": "string"
          },
          "name": {
            "description": "নীতির নাম, যেমন 30 দিনের Pro।",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "offline_mode": {
            "description": "limited সীমিত অফলাইন; none নিষিদ্ধ; permanent বাড়তি সীমা নেই, তবে লাইসেন্স মেয়াদ প্রযোজ্য।",
            "enum": [
              "limited",
              "none",
              "permanent"
            ],
            "type": "string"
          },
          "offline_seconds": {
            "description": "অনুমোদিত অফলাইন সেকেন্ড: limited-এর জন্য 1–31536000, none/permanent-এর জন্য 0। এটি হার্টবিটের ব্যবধান নয়। হার্টবিট চালু থাকলে নতুন সীমিত অফলাইন নীতিতে offline_seconds \u003e= 3 × heartbeat_seconds হতে হবে; ফ্লোটিং আসনের লিজেও অন্তত তিনটি হার্টবিট ব্যবধান থাকতে হবে।",
            "maximum": 31536000,
            "minimum": 0,
            "type": "integer"
          },
          "product_id": {
            "description": "পণ্য ID (UUID).",
            "format": "uuid",
            "type": "string"
          },
          "require_hardware": {
            "description": "ব্যবহারযোগ্য হার্ডওয়্যার পরিচয় প্রয়োজন কি না।",
            "type": "boolean"
          },
          "self_release_limit": {
            "description": "চলমান 30 দিনে অনুমোদিত স্ব-পরিষেবা রিলিজ, 0–100; 0 নিষ্ক্রিয় করে।",
            "maximum": 100,
            "minimum": 0,
            "type": "integer"
          },
          "session_seconds": {
            "description": "হার্টবিট ছাড়া floating সিট লিজ সেকেন্ড, 20–86400; নীতির রানটাইম সীমা পূরণ করতে হবে।",
            "maximum": 86400,
            "minimum": 20,
            "type": "integer"
          }
        },
        "required": [
          "product_id",
          "name",
          "mode",
          "max_devices"
        ],
        "type": "object"
      },
      "PolicyList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/Policy"
            },
            "type": "array"
          },
          "limit": {
            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
            "type": "integer"
          },
          "offset": {
            "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
            "type": "integer"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total",
          "limit",
          "offset"
        ],
        "type": "object"
      },
      "PolicyPreview": {
        "additionalProperties": false,
        "properties": {
          "changes": {
            "description": "প্রতি লাইসেন্স আগে/পরের তুলনা ও বাধার কারণ।",
            "items": {
              "additionalProperties": false,
              "properties": {
                "active": {
                  "description": "বর্তমান স্বাক্ষর কী ফ্ল্যাগ; নীতি প্রিভিউতে সক্রিয় ডিভাইস/সেশন সংখ্যা।",
                  "type": "integer"
                },
                "after": {
                  "additionalProperties": false,
                  "description": "লক্ষ্য নীতি প্রয়োগের পর অধিকার; জীবনকাল অপরিবর্তিত।",
                  "properties": {
                    "duration_days": {
                      "description": "প্রথম অ্যাক্টিভেশন থেকে প্রতি লাইসেন্সের দিন। timed/trial ইস্যুতে 1–36500 প্রয়োজন; perpetual-এ অনুপস্থিত/null। নীতিতে কখনো সংরক্ষিত হয় না।",
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "expires_at": {
                      "anyOf": [
                        {
                          "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                          "format": "date-time",
                          "type": "string"
                        },
                        {
                          "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                          "type": "null"
                        }
                      ],
                      "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।"
                    },
                    "features": {
                      "description": "সর্বাধিক 32 পৃথক ফিচার শনাক্তকারী, প্রতিটি 1–64 ASCII বর্ণ, সংখ্যা, বিন্দু, ড্যাশ বা আন্ডারস্কোর।",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "license_model": {
                      "description": "node_locked ডিভাইস বাইন্ডিং বা floating সিট।",
                      "enum": [
                        "node_locked",
                        "floating"
                      ],
                      "type": "string"
                    },
                    "maintenance_until": {
                      "anyOf": [
                        {
                          "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                          "format": "date-time",
                          "type": "string"
                        },
                        {
                          "description": "নতুন রিলিজের রক্ষণাবেক্ষণ কাটঅফ; অ্যাক্টিভেশনের আগে বা সীমাহীন হলে null হতে পারে।",
                          "type": "null"
                        }
                      ],
                      "description": "নতুন রিলিজের রক্ষণাবেক্ষণ কাটঅফ; অ্যাক্টিভেশনের আগে বা সীমাহীন হলে null হতে পারে।"
                    },
                    "max_devices": {
                      "description": "প্রতি লাইসেন্স সর্বাধিক সমসাময়িক ডিভাইস বা floating সিট।",
                      "type": "integer"
                    },
                    "max_version": {
                      "description": "সর্বোচ্চ অনুমোদিত অ্যাপ সংস্করণ; ফাঁকা মানে ঊর্ধ্বসীমা নেই।",
                      "type": "string"
                    },
                    "meter_rules": {
                      "description": "ফিচার মিটারিং নিয়ম; ফাঁকা মানে কনফিগার করা নেই।",
                      "items": {
                        "additionalProperties": false,
                        "properties": {
                          "allow_overage": {
                            "description": "অতিরিক্ত ফিচার ব্যবহার অনুমোদিত কি না।",
                            "type": "boolean"
                          },
                          "feature": {
                            "description": "মিটার করা ফিচার শনাক্তকারী, নীতির ফিচারে থাকতে হবে।",
                            "pattern": "^[A-Za-z0-9_.-]{1,64}$",
                            "type": "string"
                          },
                          "limit": {
                            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
                            "maximum": 1000000000000,
                            "minimum": 0,
                            "type": "integer"
                          },
                          "max_overage": {
                            "description": "সর্বাধিক অনুমোদিত অতিরিক্ত ব্যবহার; allow_overage false হলে নিষ্ক্রিয়।",
                            "maximum": 1000000000000,
                            "minimum": 0,
                            "type": "integer"
                          },
                          "period": {
                            "description": "ডিফল্ট UTC মাসিক বিলিং স্ন্যাপশট; মিটার নিয়ম month/day/lifetime এবং ব্যবহার সারি নির্দিষ্ট সময়কাল কী ব্যবহার করে।",
                            "enum": [
                              "month",
                              "day",
                              "lifetime"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "feature",
                          "limit",
                          "period"
                        ],
                        "type": "object"
                      },
                      "maxItems": 32,
                      "type": "array"
                    },
                    "min_version": {
                      "description": "সর্বনিম্ন অনুমোদিত অ্যাপ সংস্করণ; ফাঁকা মানে নিম্নসীমা নেই।",
                      "type": "string"
                    },
                    "mode": {
                      "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
                      "enum": [
                        "perpetual",
                        "timed",
                        "trial"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "mode",
                    "max_devices",
                    "features",
                    "expires_at",
                    "duration_days",
                    "license_model",
                    "meter_rules",
                    "maintenance_until",
                    "min_version",
                    "max_version"
                  ],
                  "type": "object"
                },
                "before": {
                  "additionalProperties": false,
                  "description": "বর্তমানে ইস্যু করা অধিকার ও লাইসেন্স জীবনকাল।",
                  "properties": {
                    "capabilities": {
                      "$ref": "#/components/schemas/LicenseCapabilities",
                      "description": "লাইসেন্স সক্ষমতা স্ন্যাপশট।"
                    },
                    "duration_days": {
                      "description": "প্রথম অ্যাক্টিভেশন থেকে প্রতি লাইসেন্সের দিন। timed/trial ইস্যুতে 1–36500 প্রয়োজন; perpetual-এ অনুপস্থিত/null। নীতিতে কখনো সংরক্ষিত হয় না।",
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "expires_at": {
                      "anyOf": [
                        {
                          "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                          "format": "date-time",
                          "type": "string"
                        },
                        {
                          "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                          "type": "null"
                        }
                      ],
                      "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।"
                    },
                    "features": {
                      "description": "সর্বাধিক 32 পৃথক ফিচার শনাক্তকারী, প্রতিটি 1–64 ASCII বর্ণ, সংখ্যা, বিন্দু, ড্যাশ বা আন্ডারস্কোর।",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "max_devices": {
                      "description": "প্রতি লাইসেন্স সর্বাধিক সমসাময়িক ডিভাইস বা floating সিট।",
                      "type": "integer"
                    },
                    "meter_rules": {
                      "description": "ফিচার মিটারিং নিয়ম; ফাঁকা মানে কনফিগার করা নেই।",
                      "items": {
                        "additionalProperties": false,
                        "properties": {
                          "allow_overage": {
                            "description": "অতিরিক্ত ফিচার ব্যবহার অনুমোদিত কি না।",
                            "type": "boolean"
                          },
                          "feature": {
                            "description": "মিটার করা ফিচার শনাক্তকারী, নীতির ফিচারে থাকতে হবে।",
                            "pattern": "^[A-Za-z0-9_.-]{1,64}$",
                            "type": "string"
                          },
                          "limit": {
                            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
                            "maximum": 1000000000000,
                            "minimum": 0,
                            "type": "integer"
                          },
                          "max_overage": {
                            "description": "সর্বাধিক অনুমোদিত অতিরিক্ত ব্যবহার; allow_overage false হলে নিষ্ক্রিয়।",
                            "maximum": 1000000000000,
                            "minimum": 0,
                            "type": "integer"
                          },
                          "period": {
                            "description": "ডিফল্ট UTC মাসিক বিলিং স্ন্যাপশট; মিটার নিয়ম month/day/lifetime এবং ব্যবহার সারি নির্দিষ্ট সময়কাল কী ব্যবহার করে।",
                            "enum": [
                              "month",
                              "day",
                              "lifetime"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "feature",
                          "limit",
                          "period"
                        ],
                        "type": "object"
                      },
                      "maxItems": 32,
                      "type": "array"
                    },
                    "mode": {
                      "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
                      "enum": [
                        "perpetual",
                        "timed",
                        "trial"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "mode",
                    "max_devices",
                    "features",
                    "expires_at",
                    "duration_days",
                    "capabilities",
                    "meter_rules"
                  ],
                  "type": "object"
                },
                "blocked_reason": {
                  "description": "পরিবর্তন আটকে থাকার কারণ; ফাঁকা মানে বর্তমানে বাধা নেই।",
                  "type": "string"
                },
                "customer": {
                  "description": "বিক্রেতা নির্ধারিত গ্রাহক লেবেল, গ্রাহক পোর্টাল ইমেইল থেকে আলাদা।",
                  "type": "string"
                },
                "id": {
                  "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
                  "format": "uuid",
                  "type": "string"
                }
              },
              "required": [
                "id",
                "customer",
                "before",
                "after",
                "blocked_reason",
                "active"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "expires_in": {
            "const": 600,
            "description": "প্রিভিউ টোকেন জীবনকাল সেকেন্ডে, বর্তমানে 600।",
            "type": "integer"
          },
          "note": {
            "description": "ডেভেলপারের অতিরিক্ত নির্দেশনা।",
            "type": "string"
          },
          "policy_version": {
            "description": "নীতি সংশোধন; পুরোনো লেখা ঠেকাতে সম্পূর্ণ সক্ষমতা সম্পাদনায় বর্তমান মান পাঠান।",
            "type": "integer"
          },
          "preview_token": {
            "description": "apply_policy-র জন্য এনক্রিপ্টেড প্রিভিউ নিশ্চিতকরণ টোকেন প্রয়োজন; 600 সেকেন্ড বৈধ এবং রিসোর্স বদলালে অবৈধ।",
            "type": "string"
          }
        },
        "required": [
          "changes",
          "policy_version",
          "preview_token",
          "expires_in",
          "note"
        ],
        "type": "object"
      },
      "PolicySyncResult": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "synced_licenses": {
            "description": "একই লেনদেনে সিঙ্ক করা সংযুক্ত অপ্রত্যাহৃত লাইসেন্স সংখ্যা।",
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "id",
          "synced_licenses"
        ],
        "type": "object"
      },
      "PolicyUpdate": {
        "additionalProperties": false,
        "description": "ইস্যু মোড, ডিভাইস/সিট সীমা, ফিচার ও রানটাইম নিয়ম সংজ্ঞায়িত করে। নীতিতে বৈধতার মেয়াদ সংরক্ষিত হয় না।",
        "properties": {
          "features": {
            "description": "সর্বাধিক 32 পৃথক ফিচার শনাক্তকারী, প্রতিটি 1–64 ASCII বর্ণ, সংখ্যা, বিন্দু, ড্যাশ বা আন্ডারস্কোর।",
            "items": {
              "pattern": "^[A-Za-z0-9_.-]{1,64}$",
              "type": "string"
            },
            "maxItems": 32,
            "type": "array",
            "uniqueItems": true
          },
          "heartbeat_seconds": {
            "anyOf": [
              {
                "const": 0,
                "description": "হার্টবিট ব্যবধান সেকেন্ডে: 0 নিষ্ক্রিয় করে; অন্যথায় 600–86400। বাদ দিলে সার্ভার ডিফল্ট; অফলাইন ভাতা থেকে স্বাধীন।"
              },
              {
                "description": "হার্টবিট ব্যবধান সেকেন্ডে: 0 নিষ্ক্রিয় করে; অন্যথায় 600–86400। বাদ দিলে সার্ভার ডিফল্ট; অফলাইন ভাতা থেকে স্বাধীন।",
                "maximum": 86400,
                "minimum": 600,
                "type": "integer"
              }
            ],
            "description": "0 স্পষ্টভাবে পর্যায়ক্রমিক হার্টবিট বন্ধ করে; অন্যথায় 600–86400 সেকেন্ড (ন্যূনতম 10 মিনিট)। অফলাইন ভাতা থেকে স্বাধীন।",
            "type": "integer"
          },
          "max_devices": {
            "description": "প্রতি লাইসেন্স সর্বাধিক সমসাময়িক ডিভাইস বা floating সিট।",
            "maximum": 10000,
            "minimum": 1,
            "type": "integer"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "perpetual",
              "timed",
              "trial"
            ],
            "type": "string"
          },
          "name": {
            "description": "মানুষের পড়ার উপযোগী নাম; দৈর্ঘ্যের সীমা দেখুন।",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "offline_mode": {
            "description": "limited, none বা permanent অফলাইন ভাতা; লাইসেন্সের মেয়াদ এখনও প্রযোজ্য।",
            "enum": [
              "limited",
              "none",
              "permanent"
            ],
            "type": "string"
          },
          "offline_seconds": {
            "description": "Limited: 1–31536000 সেকেন্ড এবং হার্টবিট চালু থাকলে অন্তত 3 × heartbeat_seconds; none/permanent: 0",
            "maximum": 31536000,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "PreviewInput": {
        "additionalProperties": false,
        "properties": {
          "ids": {
            "description": "প্রক্রিয়াকরণের পৃথক লাইসেন্স UUID, 1–100।",
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "maxItems": 100,
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "policy_id": {
            "description": "নীতি UUID; ইস্যুর সময় পণ্যের অন্তর্ভুক্ত হতে হবে।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "policy_id",
          "ids"
        ],
        "type": "object"
      },
      "Price": {
        "additionalProperties": false,
        "properties": {
          "api_hard_limit": {
            "description": "API ভাতা সীমায় রানটাইম কল থামে কি না।",
            "type": "boolean"
          },
          "api_unit_micros": {
            "description": "প্রতি অতিরিক্ত রানটাইম কলের মূল্য দশ লক্ষ ভাগে।",
            "minimum": 0,
            "type": "integer"
          },
          "base_micros": {
            "description": "মুদ্রা এককের দশ লক্ষ ভাগে ভিত্তি চার্জ।",
            "type": "integer"
          },
          "currency": {
            "description": "তিন অক্ষরের বড় হাতের মুদ্রা কোড, যেমন USD।",
            "type": "string"
          },
          "description": {
            "description": "বিলিং অফারের বিবরণ।",
            "type": "string"
          },
          "enabled": {
            "description": "বিলিং অফার ক্রয়ের জন্য সক্ষম কি না।",
            "type": "boolean"
          },
          "hard_limit": {
            "description": "ভাতা সীমায় নতুন বিলযোগ্য ডিভাইস প্রত্যাখ্যাত হয় কি না।",
            "type": "boolean"
          },
          "included_api_calls": {
            "description": "null = সীমাহীন; 0 = কোনো সফল কল অন্তর্ভুক্ত নয়",
            "maximum": 1000000000000,
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          },
          "included_devices": {
            "description": "অন্তর্ভুক্ত সক্রিয় ডিভাইস ভাতা।",
            "type": "integer"
          },
          "name": {
            "description": "বিলিং অফারের প্রদর্শন নাম।",
            "type": "string"
          },
          "plan": {
            "description": "প্রকাশিত ক্যাটালগের স্থির বিলিং প্ল্যান শনাক্তকারী।",
            "type": "string"
          },
          "price_version": {
            "description": "স্থির করা মূল্য সংশোধন; পুরোনো ইনপুটের কারণে PLAN_VERSION_CONFLICT হতে পারে।",
            "type": "string"
          },
          "public": {
            "description": "বিলিং অফার প্রকাশ্য তালিকায় আছে কি না।",
            "type": "boolean"
          },
          "renewal_only": {
            "description": "বিদ্যমান পরিশোধিত বা উপহারপ্রাপ্ত গ্রাহক একই পরিবেশ ও মুদ্রায় আগাম বা মেয়াদ শেষে নবায়ন করতে পারেন। নতুন প্রকাশ্য ক্রয় থেকে লুকানো।",
            "type": "boolean"
          },
          "sort_order": {
            "description": "বিলিং অফারের প্রদর্শন ক্রম।",
            "type": "integer"
          },
          "terms": {
            "description": "উপলব্ধ ক্রয় মেয়াদ ও তার মূল্য।",
            "items": {
              "$ref": "#/components/schemas/PlanTermPrice"
            },
            "type": "array"
          },
          "unit_micros": {
            "description": "প্রতি অতিরিক্ত সক্রিয় ডিভাইসের মূল্য দশ লক্ষ ভাগে।",
            "type": "integer"
          },
          "updated_at": {
            "description": "UTC-তে সর্বশেষ আপডেট টাইমস্ট্যাম্প।",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "Product": {
        "additionalProperties": false,
        "example": {
          "created_at": "2026-10-18T00:00:00Z",
          "description": "Desktop reporting software",
          "id": "11111111-1111-4111-8111-111111111111",
          "name": "Report app",
          "status": "active",
          "updated_at": "2026-10-18T00:00:00Z"
        },
        "properties": {
          "created_at": {
            "description": "তৈরির সময়, UTC ISO 8601।",
            "format": "date-time",
            "type": "string"
          },
          "description": {
            "description": "পণ্যের বিবরণ.",
            "type": "string"
          },
          "id": {
            "description": "SDK কনফিগ ও নীতি তৈরির পণ্য UUID।",
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "description": "পণ্যের নাম.",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "status": {
            "description": "active সক্রিয় হতে দেয়; disabled চলাকালীন লাইসেন্স অনুরোধ ফিরিয়ে দেয়।",
            "enum": [
              "active",
              "disabled"
            ],
            "type": "string"
          },
          "updated_at": {
            "description": "শেষ পরিবর্তনের সময়, UTC ISO 8601।",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "status"
        ],
        "type": "object"
      },
      "ProductCreate": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "description": "ঐচ্ছিক সফটওয়্যার বিবরণ, সর্বোচ্চ 1000 অক্ষর।",
            "maxLength": 1000,
            "type": "string"
          },
          "name": {
            "description": "সফটওয়্যারের নাম, 1–120 অক্ষর।",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "ProductList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/Product"
            },
            "type": "array"
          },
          "limit": {
            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
            "type": "integer"
          },
          "offset": {
            "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
            "type": "integer"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total",
          "limit",
          "offset"
        ],
        "type": "object"
      },
      "ProductUpdate": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "description": "পণ্যের বিবরণ; ফাঁকা হতে পারে।",
            "maxLength": 1000,
            "type": "string"
          },
          "name": {
            "description": "মানুষের পড়ার উপযোগী নাম; দৈর্ঘ্যের সীমা দেখুন।",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "status": {
            "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
            "enum": [
              "active",
              "disabled"
            ],
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "ProviderRefund": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "minimum": 0,
            "type": "integer"
          },
          "attempted_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "attempts": {
            "minimum": 0,
            "type": "integer"
          },
          "case_id": {
            "format": "uuid",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "last_error": {
            "type": "string"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "order_id": {
            "format": "uuid",
            "type": "string"
          },
          "provider": {
            "enum": [
              "waffo",
              "paddle"
            ],
            "type": "string"
          },
          "provider_refund_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "reason": {
            "type": "string"
          },
          "reserved": {
            "type": "boolean"
          },
          "settled_cents": {
            "minimum": 0,
            "type": "integer"
          },
          "status": {
            "enum": [
              "created",
              "submitting",
              "pending",
              "unknown",
              "completed",
              "failed"
            ],
            "type": "string"
          },
          "submitted_cents": {
            "minimum": 0,
            "type": "integer"
          },
          "unapplied": {
            "type": "boolean"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "type": "object"
      },
      "PurchaseList": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlanPurchase",
                "description": "বর্তমান স্বাক্ষর কী ফ্ল্যাগ; নীতি প্রিভিউতে সক্রিয় ডিভাইস/সেশন সংখ্যা।"
              },
              {
                "description": "বর্তমান স্বাক্ষর কী ফ্ল্যাগ; নীতি প্রিভিউতে সক্রিয় ডিভাইস/সেশন সংখ্যা।",
                "type": "null"
              }
            ],
            "description": "বর্তমান কার্যকর কেনা প্যাকেজ চুক্তি, বা null।"
          },
          "active_devices": {
            "description": "বর্তমান নিবন্ধিত পণ্য/ডিভাইস দখল, মাসিক ডিভাইস ব্যবহার ইতিহাস থেকে স্বাধীন। সাধারণ নিবন্ধন রিলিজ না হওয়া পর্যন্ত অফলাইনে গণনায় থাকে। Floating সেশন শুধু বৈধ লিজে গণনা হয় ও হার্ডওয়্যার দিয়ে ডুপ্লিকেট বাদ দেয়, না থাকলে ডিভাইস পরিচয় ব্যবহার করে। রিলিজ বা শেষ floating সেশনের মেয়াদ শেষ হলে ক্ষমতা ফেরে; বৈধ নিবন্ধন কোটা-মাসের সীমা পেরিয়ে থাকে। বিচ্ছিন্ন SDK ট্রায়াল নিবন্ধন বাদ।",
            "type": "integer"
          },
          "coverage_ends_at": {
            "anyOf": [
              {
                "description": "ধারাবাহিক পরিশোধিত প্যাকেজ কভারেজের শেষ, বা null।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "ধারাবাহিক পরিশোধিত প্যাকেজ কভারেজের শেষ, বা null।",
                "type": "null"
              }
            ],
            "description": "পরিশোধিত আগাম নবায়ন ও নির্ধারিত উপহারসহ মোট প্রিপেইড কভারেজের শেষ। সক্রিয় প্যাকেজ এখনও নিজের বর্তমান কোটা সময় জানায়।"
          },
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/PlanPurchase"
            },
            "type": "array"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "renewal_package": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlanPurchase",
                "description": "নবায়নের যোগ্য সর্বশেষ পরিশোধিত চুক্তি, বা null।"
              },
              {
                "description": "নবায়নের যোগ্য সর্বশেষ পরিশোধিত চুক্তি, বা null।",
                "type": "null"
              }
            ],
            "description": "প্রয়োগকৃত আপগ্রেডসহ সর্বশেষ পরিশোধিত বা উপহার কভারেজ। ম্যানুয়াল বা স্বয়ংক্রিয় নবায়ন বাছতে এই কার্যকর প্ল্যান ও মুদ্রা ব্যবহার করুন। প্যাকেজ খোলা না হওয়া পর্যন্ত null।"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "RechargeInput": {
        "additionalProperties": false,
        "description": "purchase_id OR upgrade_id যুক্ত করুন, উভয় কখনো নয়। নিশ্চিত পেমেন্ট ওয়ালেটে ক্রেডিট হয় এবং কোট বৈধ থাকলে সেই ক্রয়/আপগ্রেড নিষ্পত্তি করে। দেরিতে আসা আপগ্রেড পেমেন্ট ওয়ালেটে থাকে।",
        "properties": {
          "amount": {
            "description": "দশমিক রিচার্জ মান, সর্বাধিক দুই দশমিক স্থান",
            "type": "string"
          },
          "currency": {
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "overage_accepted": {
            "description": "প্রদর্শিত চার্জযোগ্য অতিরিক্ত ব্যবহারের পৃথক স্পষ্ট অনুমোদন।",
            "type": "boolean"
          },
          "policy_version": {
            "description": "বর্তমানে প্রকাশিত অপরিবর্তনীয় নীতি সংস্করণ। অপারেটর নীতি প্রকাশের পর উভয় পেমেন্ট পরিবেশে সম্মতি-সুরক্ষিত কাজে প্রয়োজন।",
            "type": "string"
          },
          "purchase_id": {
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          },
          "request_id": {
            "maxLength": 80,
            "type": "string"
          },
          "terms_accepted": {
            "description": "স্পষ্ট সম্মতি, ডিফল্টে অনির্বাচিত।",
            "type": "boolean"
          },
          "upgrade_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "currency",
          "amount",
          "request_id"
        ],
        "type": "object"
      },
      "RecoverOriginalRefund": {
        "additionalProperties": false,
        "properties": {
          "confirm_unpaid_manual": {
            "const": true,
            "type": "boolean"
          },
          "expected_updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "confirm_unpaid_manual"
        ],
        "type": "object"
      },
      "RefundHistory": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/RefundHistoryItem"
            },
            "type": "array"
          },
          "limit": {
            "minimum": 0,
            "type": "integer"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "offset": {
            "minimum": 0,
            "type": "integer"
          },
          "total": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "RefundHistoryItem": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "minimum": 0,
            "type": "integer"
          },
          "case_id": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "order_id": {
            "type": "string"
          },
          "provider": {
            "enum": [
              "paypal",
              "waffo",
              "paddle"
            ],
            "type": "string"
          },
          "provider_refund_id": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "settled_cents": {
            "minimum": 0,
            "type": "integer"
          },
          "status": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "RefundInboxItem": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "minimum": 0,
            "type": "integer"
          },
          "cancellation_scope": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "customer_email": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "manual_refund_pending": {
            "type": "boolean"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "order_id": {
            "type": "string"
          },
          "pending_review": {
            "type": "boolean"
          },
          "purchase_id": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "refund_totals": {
            "description": "পরিসরযুক্ত বাতিলের প্রতি মুদ্রার অর্থ JSON-এ এনকোড করা।",
            "type": "string"
          },
          "reviewed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "scope": {
            "enum": [
              "wallet",
              "service"
            ],
            "type": "string"
          },
          "source": {
            "enum": [
              "wallet_request",
              "support_case"
            ],
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "tenant_name": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "type": "object"
      },
      "RefundInboxList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/RefundInboxItem"
            },
            "type": "array"
          },
          "limit": {
            "minimum": 0,
            "type": "integer"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "offset": {
            "minimum": 0,
            "type": "integer"
          },
          "summary": {
            "additionalProperties": false,
            "properties": {
              "pending_review": {
                "minimum": 0,
                "type": "integer"
              },
              "service_pending_review": {
                "minimum": 0,
                "type": "integer"
              },
              "wallet_pending_review": {
                "minimum": 0,
                "type": "integer"
              }
            },
            "type": "object"
          },
          "total": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "RefundInput": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "description": "ক্যাপচার মুদ্রায় ধনাত্মক রিফান্ড অর্থ; অবশিষ্ট ক্যাপচার অর্থ বা উপলব্ধ অব্যবহৃত ওয়ালেট ক্রেডিট অতিক্রম করতে পারে না।",
            "pattern": "^[0-9]+(?:\\.[0-9]{1,2})?$",
            "type": "string"
          },
          "reason": {
            "maxLength": 255,
            "minLength": 1,
            "type": "string"
          },
          "request_id": {
            "maxLength": 80,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "amount",
          "reason",
          "request_id"
        ],
        "type": "object"
      },
      "RefundList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/PayPalRefund"
            },
            "type": "array"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total"
        ],
        "type": "object"
      },
      "RefundQuote": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "type": "integer"
          },
          "automatic_entitlement_cancellation": {
            "type": "boolean"
          },
          "currency": {
            "type": "string"
          },
          "purchase_id": {
            "format": "uuid",
            "type": "string"
          },
          "quoted_at": {
            "format": "date-time",
            "type": "string"
          },
          "requires_confirmation": {
            "type": "boolean"
          }
        },
        "required": [],
        "type": "object"
      },
      "RefundReview": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "type": "string"
          },
          "amounts": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "amount": {
                  "type": "string"
                },
                "purchase_id": {
                  "format": "uuid",
                  "type": "string"
                }
              },
              "required": [
                "purchase_id",
                "amount"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "approve": {
            "type": "boolean"
          },
          "decision": {
            "maxLength": 3000,
            "type": "string"
          },
          "expected_updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "quote_hash": {
            "type": "string"
          },
          "quoted_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "approve",
          "decision"
        ],
        "type": "object"
      },
      "Register": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "format": "email",
            "type": "string"
          },
          "name": {
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "overage_accepted": {
            "description": "প্রদর্শিত চার্জযোগ্য অতিরিক্ত ব্যবহারের পৃথক স্পষ্ট অনুমোদন।",
            "type": "boolean"
          },
          "password": {
            "description": "12–128 UTF-8 বাইট, অক্ষর নয়",
            "type": "string",
            "writeOnly": true
          },
          "password_confirmation": {
            "description": "আবশ্যক এবং পাসওয়ার্ডের সঙ্গে হুবহু মিলতে হবে",
            "type": "string",
            "writeOnly": true
          },
          "policy_version": {
            "description": "বর্তমানে প্রকাশিত অপরিবর্তনীয় নীতি সংস্করণ। অপারেটর নীতি প্রকাশের পর উভয় পেমেন্ট পরিবেশে সম্মতি-সুরক্ষিত কাজে প্রয়োজন।",
            "type": "string"
          },
          "tenant_name": {
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "terms_accepted": {
            "description": "স্পষ্ট সম্মতি, ডিফল্টে অনির্বাচিত।",
            "type": "boolean"
          }
        },
        "required": [
          "email",
          "password",
          "password_confirmation",
          "name",
          "tenant_name"
        ],
        "type": "object"
      },
      "Release": {
        "additionalProperties": false,
        "example": {
          "channel": "stable",
          "created_at": "2026-10-18T00:00:00Z",
          "download_url": "",
          "id": "33333333-3333-4333-8333-333333333333",
          "notes": "Initial release",
          "product_id": "11111111-1111-4111-8111-111111111111",
          "published_at": "2026-10-18T00:00:00Z",
          "sha256": "",
          "version": "1.0.0"
        },
        "properties": {
          "channel": {
            "description": "রিলিজ চ্যানেল, stable বা preview; ডিফল্ট stable।",
            "type": "string"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "download_url": {
            "description": "HTTPS ডাউনলোড URL; URL দিলে sha256 প্রয়োজন।",
            "type": "string"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "notes": {
            "description": "সংস্করণের বিবরণ",
            "type": "string"
          },
          "product_id": {
            "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
            "format": "uuid",
            "type": "string"
          },
          "published_at": {
            "description": "রিলিজ প্রকাশ টাইমস্ট্যাম্প, UTC; ডিফল্ট সার্ভার সময়।",
            "format": "date-time",
            "type": "string"
          },
          "sha256": {
            "description": "ডাউনলোড ফাইল SHA-256, 64 ছোট হাতের hex অক্ষর, স্বাক্ষর অ্যালগরিদম থেকে আলাদা।",
            "type": "string"
          },
          "version": {
            "description": "অবজেক্ট অনুযায়ী নীতি সংশোধন, পণ্য major.minor.patch সংস্করণ বা অফলাইন প্রোটোকল সংস্করণ 1।",
            "type": "string"
          }
        },
        "required": [
          "id",
          "product_id",
          "version",
          "channel",
          "notes",
          "download_url",
          "sha256",
          "published_at",
          "created_at"
        ],
        "type": "object"
      },
      "ReleaseInput": {
        "additionalProperties": false,
        "properties": {
          "channel": {
            "description": "রিলিজ চ্যানেল, stable বা preview; ডিফল্ট stable।",
            "enum": [
              "stable",
              "preview"
            ],
            "type": "string"
          },
          "download_url": {
            "description": "HTTPS ডাউনলোড URL; URL দিলে sha256 প্রয়োজন।",
            "format": "uri",
            "maxLength": 2000,
            "type": "string"
          },
          "notes": {
            "description": "সংস্করণের বিবরণ",
            "maxLength": 10000,
            "type": "string"
          },
          "published_at": {
            "description": "রিলিজ প্রকাশ টাইমস্ট্যাম্প, UTC; ডিফল্ট সার্ভার সময়।",
            "format": "date-time",
            "type": "string"
          },
          "sha256": {
            "description": "ডাউনলোড ফাইল SHA-256, 64 ছোট হাতের hex অক্ষর, স্বাক্ষর অ্যালগরিদম থেকে আলাদা।",
            "pattern": "^[0-9a-f]{64}$",
            "type": "string"
          },
          "version": {
            "description": "অবজেক্ট অনুযায়ী নীতি সংশোধন, পণ্য major.minor.patch সংস্করণ বা অফলাইন প্রোটোকল সংস্করণ 1।",
            "pattern": "^(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})$",
            "type": "string"
          }
        },
        "required": [
          "version"
        ],
        "type": "object"
      },
      "ReleaseList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/Release"
            },
            "type": "array"
          },
          "limit": {
            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
            "type": "integer"
          },
          "offset": {
            "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
            "type": "integer"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total",
          "limit",
          "offset"
        ],
        "type": "object"
      },
      "Renew": {
        "additionalProperties": false,
        "properties": {
          "days": {
            "description": "অতিরিক্ত দিন, 1–36500; লাইসেন্স ও রক্ষণাবেক্ষণ নবায়ন ভিন্ন মেয়াদ প্রভাবিত করে।",
            "maximum": 36500,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "days"
        ],
        "type": "object"
      },
      "RenewalPlans": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/Price"
            },
            "type": "array"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          }
        },
        "required": [
          "items",
          "mode"
        ],
        "type": "object"
      },
      "Renewed": {
        "additionalProperties": false,
        "example": {
          "duration_days": 60,
          "expires_at": null,
          "id": "33333333-3333-4333-8333-333333333333"
        },
        "properties": {
          "duration_days": {
            "description": "প্রথম অ্যাক্টিভেশনের আগে নবায়ন এই মান বাড়ায়। পরে মূল মেয়াদ থাকে; প্রকৃত সময়সীমায় expires_at ব্যবহার করুন।",
            "maximum": 36500,
            "minimum": 1,
            "type": [
              "integer",
              "null"
            ]
          },
          "expires_at": {
            "anyOf": [
              {
                "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।",
                "type": "null"
              }
            ],
            "description": "লাইসেন্স মেয়াদ; অ্যাক্টিভেট না হওয়া timed/trial বা perpetual লাইসেন্সে null। কী অবজেক্টে ক্রেডেনশিয়াল মেয়াদ।"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "id",
          "expires_at",
          "duration_days"
        ],
        "type": "object"
      },
      "ReservationResult": {
        "additionalProperties": false,
        "properties": {
          "activation_id": {
            "description": "ডিভাইস বাঁধন বা রানটাইম সেশন UUID। পরের অনুরোধে রাখুন; লাইসেন্স কী নয়।",
            "format": "uuid",
            "type": "string"
          },
          "heartbeat_seconds": {
            "anyOf": [
              {
                "const": 0
              },
              {
                "maximum": 86400,
                "minimum": 600,
                "type": "integer"
              }
            ],
            "description": "বর্তমান heartbeat ব্যবধান সেকেন্ডে; মিটারিং স্বাক্ষর বা টাইমার নবায়ন করে না।",
            "type": "integer"
          },
          "reservation": {
            "$ref": "#/components/schemas/FeatureReservation"
          }
        },
        "required": [
          "activation_id",
          "reservation"
        ],
        "type": "object"
      },
      "Revenue": {
        "additionalProperties": false,
        "properties": {
          "invoices": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "currency": {
                  "pattern": "^[A-Z]{3}$",
                  "type": "string"
                },
                "email": {
                  "type": "string"
                },
                "id": {
                  "format": "uuid",
                  "type": "string"
                },
                "month": {
                  "type": "string"
                },
                "paid_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "plan": {
                  "type": "string"
                },
                "plan_name": {
                  "type": "string"
                },
                "refunded_at": {
                  "anyOf": [
                    {
                      "format": "date-time",
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "status": {
                  "type": "string"
                },
                "tenant_name": {
                  "type": "string"
                },
                "total_cents": {
                  "type": "integer"
                }
              },
              "required": [],
              "type": "object"
            },
            "type": "array"
          },
          "limit": {
            "type": "integer"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "month": {
            "type": "string"
          },
          "offset": {
            "type": "integer"
          },
          "paddle_totals": {
            "description": "পরিষেবা ক্রয় ও ওয়ালেট টপ-আপ উভয়ের মোট পেমেন্ট ও ক্রমসঞ্চিত রিফান্ড, মূল পেমেন্ট মাস ও মুদ্রা অনুসারে গোষ্ঠীবদ্ধ; ব্যাংক নিষ্পত্তি নয়।",
            "items": {
              "additionalProperties": false,
              "properties": {
                "currency": {
                  "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
                  "type": "string"
                },
                "paid_cents": {
                  "description": "ক্ষুদ্রতম মুদ্রা এককে স্থির পূর্ণ পরিষেবা মূল্য; ওয়ালেট রিচার্জ বা মিশ্র পেমেন্ট নয়।",
                  "type": "integer"
                },
                "refunded_cents": {
                  "description": "ক্ষুদ্রতম মুদ্রা এককে স্থির পূর্ণ পরিষেবা মূল্য; ওয়ালেট রিচার্জ বা মিশ্র পেমেন্ট নয়।",
                  "type": "integer"
                }
              },
              "required": [
                "currency",
                "paid_cents",
                "refunded_cents"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "paid_users": {
            "type": "integer"
          },
          "purchase_total": {
            "type": "integer"
          },
          "purchases": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "api_calls": {
                  "type": "integer"
                },
                "api_overage_cents": {
                  "type": "integer"
                },
                "base_cents": {
                  "type": "integer"
                },
                "currency": {
                  "pattern": "^[A-Z]{3}$",
                  "type": "string"
                },
                "email": {
                  "type": "string"
                },
                "ends_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "id": {
                  "format": "uuid",
                  "type": "string"
                },
                "overage_cents": {
                  "type": "integer"
                },
                "plan": {
                  "pattern": "^[a-z][a-z0-9_-]{0,63}$",
                  "type": "string"
                },
                "plan_name": {
                  "type": "string"
                },
                "source": {
                  "enum": [
                    "purchase",
                    "gift"
                  ],
                  "type": "string"
                },
                "starts_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "status": {
                  "enum": [
                    "pending",
                    "active",
                    "cancelled"
                  ],
                  "type": "string"
                },
                "tenant_name": {
                  "type": "string"
                },
                "term_months": {
                  "default": 1,
                  "enum": [
                    1,
                    3,
                    6,
                    12
                  ],
                  "type": "integer"
                }
              },
              "required": [],
              "type": "object"
            },
            "type": "array"
          },
          "recharged_users": {
            "type": "integer"
          },
          "registered_users": {
            "type": "integer"
          },
          "sales": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "currency": {
                  "pattern": "^[A-Z]{3}$",
                  "type": "string"
                },
                "plan": {
                  "type": "string"
                },
                "plan_name": {
                  "type": "string"
                },
                "quantity": {
                  "type": "integer"
                },
                "total_cents": {
                  "type": "integer"
                }
              },
              "required": [],
              "type": "object"
            },
            "type": "array"
          },
          "sold_subscriptions": {
            "type": "integer"
          },
          "timezone": {
            "type": "string"
          },
          "topup_total": {
            "type": "integer"
          },
          "topups": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "amount_cents": {
                  "type": "integer"
                },
                "credited_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "currency": {
                  "pattern": "^[A-Z]{3}$",
                  "type": "string"
                },
                "email": {
                  "type": "string"
                },
                "id": {
                  "format": "uuid",
                  "type": "string"
                },
                "provider": {
                  "description": "ওয়ালেট টপ-আপের মূল প্রদানকারী; রিফান্ড এই প্রদানকারীর সঙ্গে বাঁধা থাকে।",
                  "enum": [
                    "paypal",
                    "paddle",
                    "waffo"
                  ],
                  "type": "string"
                },
                "refunded_cents": {
                  "type": "integer"
                },
                "status": {
                  "type": "string"
                },
                "tenant_name": {
                  "type": "string"
                }
              },
              "required": [],
              "type": "object"
            },
            "type": "array"
          },
          "total": {
            "type": "integer"
          },
          "totals": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "consumption_cents": {
                  "type": "integer"
                },
                "consumption_refund_cents": {
                  "type": "integer"
                },
                "currency": {
                  "pattern": "^[A-Z]{3}$",
                  "type": "string"
                },
                "paypal_refund_cents": {
                  "type": "integer"
                },
                "recharge_cents": {
                  "type": "integer"
                },
                "wallet_refund_cents": {
                  "description": "PayPal, Paddle ও Waffo জুড়ে সম্পাদিত ওয়ালেট রিফান্ড/রিভার্সাল; অস্থায়ী রিফান্ড হোল্ড বাদ।",
                  "type": "integer"
                }
              },
              "required": [],
              "type": "object"
            },
            "type": "array"
          },
          "upgrade_total": {
            "description": "নির্বাচিত পরিবেশ ও রিপোর্ট সময়ে প্রয়োগকৃত আপগ্রেড সংখ্যা, বিনামূল্যের আপগ্রেডসহ। প্রাথমিক প্যাকেজ বিক্রয় থেকে আলাদা গণনা।",
            "type": "integer"
          },
          "upgrades": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "amount_cents": {
                  "description": "প্রকৃত পরিশোধিত আনুপাতিক অর্থ; নতুন পূর্ণ মাসিক মূল্য নয়।",
                  "type": "integer"
                },
                "applied_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "currency": {
                  "type": "string"
                },
                "email": {
                  "type": "string"
                },
                "ends_at": {
                  "description": "মূল প্যাকেজ মেয়াদ, আপগ্রেডে অপরিবর্তিত।",
                  "format": "date-time",
                  "type": "string"
                },
                "id": {
                  "format": "uuid",
                  "type": "string"
                },
                "plan_name": {
                  "description": "লক্ষ্য প্যাকেজের নাম।",
                  "type": "string"
                },
                "previous_plan_name": {
                  "description": "এই আপগ্রেডের আগে কার্যকর প্যাকেজ।",
                  "type": "string"
                },
                "tenant_name": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "email",
                "tenant_name",
                "plan_name",
                "previous_plan_name",
                "currency",
                "amount_cents",
                "applied_at",
                "ends_at"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "waffo_totals": {
            "description": "পরিষেবা ক্রয় ও ওয়ালেট টপ-আপ উভয়ের মোট পেমেন্ট ও ক্রমসঞ্চিত রিফান্ড, মূল পেমেন্ট মাস ও মুদ্রা অনুসারে গোষ্ঠীবদ্ধ; ব্যাংক নিষ্পত্তি নয়।",
            "items": {
              "additionalProperties": false,
              "properties": {
                "currency": {
                  "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
                  "type": "string"
                },
                "paid_cents": {
                  "description": "ক্ষুদ্রতম মুদ্রা এককে স্থির পূর্ণ পরিষেবা মূল্য; ওয়ালেট রিচার্জ বা মিশ্র পেমেন্ট নয়।",
                  "type": "integer"
                },
                "refunded_cents": {
                  "description": "ক্ষুদ্রতম মুদ্রা এককে স্থির পূর্ণ পরিষেবা মূল্য; ওয়ালেট রিচার্জ বা মিশ্র পেমেন্ট নয়।",
                  "type": "integer"
                }
              },
              "required": [
                "currency",
                "paid_cents",
                "refunded_cents"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [],
        "type": "object"
      },
      "RuntimeAPIPeriod": {
        "additionalProperties": false,
        "properties": {
          "api_calls": {
            "description": "পরিসরে সফল মিটার করা রানটাইম API কল; ব্যবস্থাপনা অনুরোধ বাদ।",
            "type": "integer"
          },
          "api_hard_limit": {
            "description": "API ভাতা সীমায় রানটাইম কল থামে কি না।",
            "type": "boolean"
          },
          "api_overage_cents": {
            "description": "এই চক্রে API অতিরিক্ত ব্যবহার চার্জ শতভাগে।",
            "type": "integer"
          },
          "api_unit_micros": {
            "description": "প্রতি অতিরিক্ত রানটাইম কলের মূল্য দশ লক্ষ ভাগে।",
            "minimum": 0,
            "type": "integer"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "description": "তিন অক্ষরের বড় হাতের মুদ্রা কোড, যেমন USD।",
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "included_api_calls": {
            "description": "null = সীমাহীন; 0 = কোনো সফল কল অন্তর্ভুক্ত নয়",
            "maximum": 1000000000000,
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "month": {
            "description": "UTC মাস YYYY-MM; বাদ দেওয়া কোয়েরি মানে বর্তমান মাস ব্যবহৃত হয়। বিলিং কাজে বন্ধ মাস প্রয়োজন।",
            "type": "string"
          },
          "plan": {
            "description": "প্রকাশিত ক্যাটালগের স্থির বিলিং প্ল্যান শনাক্তকারী।",
            "pattern": "^[a-z][a-z0-9_-]{0,63}$",
            "type": "string"
          },
          "price_version": {
            "description": "স্থির করা মূল্য সংশোধন; পুরোনো ইনপুটের কারণে PLAN_VERSION_CONFLICT হতে পারে।",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "RuntimeInput": {
        "additionalProperties": false,
        "properties": {
          "activation_id": {
            "description": "শেষ সফল সক্রিয়করণের data.activation_id। প্রথম activate ছাড়া যাচাই, হার্টবিট, consume ও আনবাইন্ডে আবশ্যক।",
            "format": "uuid",
            "type": "string"
          },
          "app_version": {
            "description": "বর্তমান সংস্করণ major.minor.patch, যেমন 1.0.0। রক্ষণাবেক্ষণ বা সংস্করণ সীমায় আবশ্যক। পুরোনো সংস্করণ বলে ভুল দেবেন না।",
            "pattern": "^$|^(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})$",
            "type": "string"
          },
          "device_id": {
            "description": "পণ্য, সিস্টেম ও হার্ডওয়্যার থেকে SDK গণিত 64 ছোট হাতের হেক্স SHA-256। ইচ্ছামতো স্থির মান দেবেন না।",
            "pattern": "^[0-9a-f]{64}$",
            "type": "string"
          },
          "device_name": {
            "description": "ড্যাশবোর্ডের নাম, সর্বোচ্চ 120 অক্ষর। ডিভাইস পরিচয় নির্ধারণ করে না।",
            "maxLength": 120,
            "type": "string"
          },
          "device_profile": {
            "$ref": "#/components/schemas/DeviceProfile",
            "description": "SDK-তৈরি মেশিন প্রোফাইল। হার্ডওয়্যার, VM প্রত্যাখ্যান বা হার্ডওয়্যার স্থানান্তর নীতি চাইলে দিন।"
          },
          "environment": {
            "description": "বাণিজ্য পরিবেশ, সংযোগ ও স্বাক্ষরিত গ্রান্ট উভয়ে পিন করা।",
            "enum": [
              "live",
              "sandbox"
            ],
            "type": "string"
          },
          "feature": {
            "description": "খরচ করা ফিচারের পরিচয়।",
            "maxLength": 64,
            "type": "string"
          },
          "identity_token": {
            "description": "একবার ব্যবহারযোগ্য নির্দিষ্ট ধরনযুক্ত Ed25519 Launch পরিচয় JWT; কোনো অধিকার দাবি ক্রয় অধিকার হিসেবে বিশ্বাস করা হয় না।",
            "maxLength": 12288,
            "type": "string",
            "writeOnly": true
          },
          "launch_connection_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "license_key": {
            "description": "সম্পূর্ণ গ্রাহক কী: lv_lic_ সাধারণ; lv_tmp_ প্রথম বদল সক্রিয়করণে। পরে SDK মেশিনে বাঁধা lv_dev_ ব্যবহার করে। ম্যানেজমেন্ট API Key নয়।",
            "pattern": "^(?:lv_(?:lic|tmp|dev)_[A-Za-z0-9_-]{43})?$",
            "type": "string",
            "writeOnly": true
          },
          "product_id": {
            "description": "পণ্য UUID; লাইসেন্সের পণ্যের সঙ্গে মিলবে।",
            "format": "uuid",
            "type": "string"
          },
          "quantity": {
            "description": "এই কাজের চাওয়া ইউনিট, পূর্ণসংখ্যা 1–1000000000।",
            "maximum": 1000000000,
            "minimum": 1,
            "type": "integer"
          },
          "request_logout_ticket": {
            "description": "SDK সক্ষমতা সমঝোতা। বর্তমান বাইন্ডিংয়ের টিকিট সংরক্ষিত না থাকলে শুধু আনলিঙ্ক লগআউট টিকিট অনুরোধ করুন। বৈধ টিকিট আগে থেকে থাকলে বাদ দিন; স্থিতিশীল হার্টবিট অতিরিক্ত টিকিট খোঁজা এড়ায়।",
            "type": "boolean"
          },
          "reservation_id": {
            "description": "সংরক্ষণের আইডি; নিশ্চিত বা বাতিল করার সময় এটি পাঠান।",
            "format": "uuid",
            "type": "string"
          },
          "reservation_seconds": {
            "default": 900,
            "description": "সংরক্ষণের ঐচ্ছিক মেয়াদ 30–3600 সেকেন্ড, ডিফল্ট 900। সময়কাল রিসেট হলে আগে শেষ হয়।",
            "maximum": 3600,
            "minimum": 30,
            "type": "integer"
          },
          "session_id": {
            "description": "ফ্লোটিং-এ আবশ্যক: প্রতি চলন্ত ইনস্ট্যান্সে নতুন UUID, তার সব অনুরোধে একই। ডিভাইসে বাঁধা ধরনে ঐচ্ছিক।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "license_key",
          "device_id"
        ],
        "type": "object"
      },
      "RuntimePolicy": {
        "additionalProperties": false,
        "properties": {
          "heartbeat_seconds": {
            "anyOf": [
              {
                "const": 0
              },
              {
                "maximum": 86400,
                "minimum": 600,
                "type": "integer"
              }
            ],
            "description": "অনলাইনে হার্টবিটের ব্যবধান, সেকেন্ডে। 0 নিয়মিত হার্টবিট বন্ধ করে। অফলাইন সময় আলাদা।",
            "type": "integer"
          },
          "offline_mode": {
            "description": "limited সীমিত অফলাইন; none নিষিদ্ধ; permanent বাড়তি সীমা নেই, তবে লাইসেন্স মেয়াদ প্রযোজ্য।",
            "enum": [
              "limited",
              "none",
              "permanent"
            ],
            "type": "string"
          },
          "offline_seconds": {
            "description": "অনুমোদিত অফলাইন সেকেন্ড: limited-এর জন্য 1–31536000, none/permanent-এর জন্য 0। এটি হার্টবিটের ব্যবধান নয়। হার্টবিট চালু থাকলে নতুন সীমিত অফলাইন নীতিতে offline_seconds \u003e= 3 × heartbeat_seconds হতে হবে; ফ্লোটিং আসনের লিজেও অন্তত তিনটি হার্টবিট ব্যবধান থাকতে হবে।",
            "maximum": 31536000,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "heartbeat_seconds",
          "offline_mode",
          "offline_seconds"
        ],
        "type": "object"
      },
      "RuntimeResult": {
        "additionalProperties": false,
        "properties": {
          "activation_id": {
            "description": "ডিভাইস বাঁধন বা রানটাইম সেশন UUID। পরের অনুরোধে রাখুন; লাইসেন্স কী নয়।",
            "format": "uuid",
            "type": "string"
          },
          "deactivated": {
            "description": "সফল আনবাইন্ডে true। বাঁধন বা সেশন ছাড়ে; লাইসেন্স মুছে বা মেয়াদ বদলায় না।",
            "type": "boolean"
          },
          "device_key": {
            "description": "ডিভাইস ও বাইন্ডিং সংস্করণে পিন করা সীমিত ডিভাইস ক্রেডেনশিয়াল। অ্যাকাউন্ট-মোড ক্রেডেনশিয়ালে সক্রিয় অনুমোদন সেশন ও অধিকারও প্রয়োজন; রিলিজ করা বাইন্ডিং পুনরায় সক্রিয় করতে পারে না।",
            "pattern": "^lv_dev_[A-Za-z0-9_-]{43}$",
            "type": "string"
          },
          "heartbeat_seconds": {
            "anyOf": [
              {
                "const": 0,
                "description": "হার্টবিট ব্যবধান সেকেন্ডে: 0 নিষ্ক্রিয় করে; অন্যথায় 600–86400। বাদ দিলে সার্ভার ডিফল্ট; অফলাইন ভাতা থেকে স্বাধীন।"
              },
              {
                "description": "হার্টবিট ব্যবধান সেকেন্ডে: 0 নিষ্ক্রিয় করে; অন্যথায় 600–86400। বাদ দিলে সার্ভার ডিফল্ট; অফলাইন ভাতা থেকে স্বাধীন।",
                "maximum": 86400,
                "minimum": 600,
                "type": "integer"
              }
            ],
            "description": "প্রস্তাবিত হার্টবিট সেকেন্ড। 0 হলে ওপরের ফিল্ড বাদ হতে পারে; স্বাক্ষরের runtime_policy.heartbeat_seconds আসল নীতি মান।",
            "type": "integer"
          },
          "lease": {
            "$ref": "#/components/schemas/Lease",
            "description": "সার্ভার-স্বাক্ষরিত ক্যাশ। নির্দিষ্ট বিশ্বস্ত পাবলিক কী ও পণ্য/ডিভাইস যাচাই করে নিন। আনবাইন্ড বা consume-এ নেই।"
          },
          "logout_ticket": {
            "$ref": "#/components/schemas/LogoutTicket",
            "description": "এই নির্দিষ্ট বাইন্ডিং অবতারের শুধু আনলিঙ্ক সক্ষমতা; রানটাইম অনুরোধ লগের বাইরে রাখুন।"
          }
        },
        "required": [
          "activation_id"
        ],
        "type": "object"
      },
      "SDKConfig": {
        "additionalProperties": false,
        "example": {
          "allow_http": false,
          "app_version": "",
          "base_url": "https://www.licentivo.com",
          "cache_path": "",
          "device_name": "My application",
          "license_key": "",
          "product_id": "11111111-1111-4111-8111-111111111111",
          "trusted_keys": {
            "66666666-6666-4666-8666-666666666666": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
          }
        },
        "properties": {
          "allow_http": {
            "description": "HTTP অনুমত কি না, শুধু স্থানীয় ডেভেলপমেন্টে।",
            "type": "boolean"
          },
          "app_version": {
            "description": "বর্তমান সফটওয়্যারের major.minor.patch সংস্করণ।",
            "type": "string"
          },
          "base_url": {
            "description": "লাইসেন্স সার্ভার উৎস, সাধারণত HTTPS, /api/v1 ছাড়া।",
            "type": "string"
          },
          "cache_path": {
            "description": "স্থানীয় ক্যাশ পাথ; ফাঁকা হলে SDK ব্যক্তিগত ব্যবহারকারী ডিরেক্টরি বেছে নেয়।",
            "type": "string"
          },
          "device_name": {
            "description": "মানুষের পাঠযোগ্য ডিভাইস লেবেল, নিরাপত্তা পরিচয় নয়।",
            "type": "string"
          },
          "license_key": {
            "description": "অ্যাক্টিভেশনে দেওয়া সম্পূর্ণ গ্রাহক লাইসেন্স কী। পণ্য ইনিশিয়ালাইজেশন কোড ও উদাহরণ ডাউনলোডে এই গোপন মান নেই। অফলাইন অনুরোধ SDK-প্রদত্ত ক্রেডেনশিয়াল ব্যবহার করে।",
            "type": "string"
          },
          "product_id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "trusted_keys": {
            "additionalProperties": {
              "type": "string"
            },
            "description": "পিন করা যাচাইয়ের জন্য পাবলিক-কী UUID থেকে Base64URL পাবলিক কী ম্যাপ।",
            "type": "object"
          }
        },
        "required": [
          "base_url",
          "product_id",
          "license_key",
          "app_version",
          "device_name",
          "trusted_keys",
          "cache_path",
          "allow_http"
        ],
        "type": "object"
      },
      "SDKExampleInfo": {
        "additionalProperties": false,
        "properties": {
          "available": {
            "type": "boolean"
          },
          "can_configure": {
            "type": "boolean"
          },
          "duration_days": {
            "const": 3,
            "type": "integer"
          },
          "starts_at_first_activation": {
            "type": "boolean"
          }
        },
        "required": [],
        "type": "object"
      },
      "SDKExampleSetting": {
        "additionalProperties": false,
        "properties": {
          "available": {
            "type": "boolean"
          },
          "duration_days": {
            "const": 3,
            "type": "integer"
          },
          "policy_id": {
            "description": "নির্দিষ্ট নীতি UUID; প্রাথমিক সেটআপের আগে ফাঁকা।",
            "type": "string"
          },
          "product_id": {
            "description": "নির্দিষ্ট পণ্য UUID; প্রাথমিক সেটআপের আগে ফাঁকা।",
            "type": "string"
          }
        },
        "required": [
          "available",
          "duration_days",
          "product_id",
          "policy_id"
        ],
        "type": "object"
      },
      "SDKExampleSetup": {
        "additionalProperties": false,
        "properties": {
          "enabled": {
            "type": "boolean"
          }
        },
        "required": [],
        "type": "object"
      },
      "SDKExampleTrial": {
        "additionalProperties": false,
        "properties": {
          "duration_days": {
            "const": 3,
            "type": "integer"
          },
          "expires_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "first_activated_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "license_key": {
            "type": "string"
          },
          "starts_at_first_activation": {
            "type": "boolean"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "SDKInitializer": {
        "additionalProperties": false,
        "example": {
          "language": "go",
          "product_id": "11111111-1111-4111-8111-111111111111",
          "source": "const productID = \"11111111-1111-4111-8111-111111111111\"\nvar trustedKeys = map[string]string{\"66666666-6666-4666-8666-666666666666\": \"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\"}\n",
          "trusted_keys": {
            "66666666-6666-4666-8666-666666666666": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
          }
        },
        "properties": {
          "language": {
            "description": "ডাউনলোড বান্ডলের SDK ভাষা শনাক্তকারী।",
            "type": "string"
          },
          "product_id": {
            "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
            "format": "uuid",
            "type": "string"
          },
          "source": {
            "description": "কোডে পেস্ট করার প্রকাশ্য পণ্য ধ্রুবক; গ্রাহক অ্যাক্টিভেশন গোপন মান নেই।",
            "type": "string"
          },
          "trusted_keys": {
            "additionalProperties": {
              "type": "string"
            },
            "description": "পিন করা যাচাইয়ের জন্য পাবলিক-কী UUID থেকে Base64URL পাবলিক কী ম্যাপ।",
            "type": "object"
          }
        },
        "required": [
          "product_id",
          "trusted_keys",
          "language",
          "source"
        ],
        "type": "object"
      },
      "ScheduledPlan": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "description": "তিন অক্ষরের বড় হাতের মুদ্রা কোড, যেমন USD।",
            "type": "string"
          },
          "effective_month": {
            "description": "সময়সূচি কার্যকর হওয়ার UTC মাস YYYY-MM।",
            "type": "string"
          },
          "plan": {
            "description": "প্রকাশিত ক্যাটালগের স্থির বিলিং প্ল্যান শনাক্তকারী।",
            "type": "string"
          },
          "sandbox": {
            "description": "পরীক্ষার পরিবেশ",
            "type": "boolean"
          }
        },
        "required": [],
        "type": "object"
      },
      "ScopedRefundPreview": {
        "additionalProperties": false,
        "properties": {
          "affected_purchases": {
            "items": {
              "$ref": "#/components/schemas/ScopedRefundPurchase"
            },
            "type": "array"
          },
          "auto_renewal_disabled": {
            "type": "boolean"
          },
          "auto_renewal_enabled": {
            "type": "boolean"
          },
          "cancellation_at": {
            "const": "approval",
            "type": "string"
          },
          "pending_purchase_ids": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "type": "array"
          },
          "pending_upgrade_ids": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "type": "array"
          },
          "quote_hash": {
            "type": "string"
          },
          "quoted_at": {
            "format": "date-time",
            "type": "string"
          },
          "remaining_purchases": {
            "items": {
              "$ref": "#/components/schemas/ScopedRefundPurchase"
            },
            "type": "array"
          },
          "request": {
            "$ref": "#/components/schemas/CustomerRefundInput"
          },
          "scope": {
            "enum": [
              "purchase",
              "service"
            ],
            "type": "string"
          },
          "totals": {
            "items": {
              "$ref": "#/components/schemas/ScopedRefundTotal"
            },
            "type": "array"
          }
        },
        "required": [],
        "type": "object"
      },
      "ScopedRefundPurchase": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "type": "integer"
          },
          "approved_cents": {
            "type": "integer"
          },
          "currency": {
            "type": "string"
          },
          "ends_at": {
            "format": "date-time",
            "type": "string"
          },
          "maximum_cents": {
            "type": "integer"
          },
          "plan_name": {
            "type": "string"
          },
          "purchase_id": {
            "format": "uuid",
            "type": "string"
          },
          "requires_review": {
            "type": "boolean"
          },
          "source": {
            "type": "string"
          },
          "starts_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "ScopedRefundTotal": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "type": "integer"
          },
          "approved_cents": {
            "type": "integer"
          },
          "currency": {
            "type": "string"
          },
          "held_cents": {
            "type": "integer"
          },
          "manual_cents": {
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "ServiceCompensation": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "incident_id": {
            "description": "সংশ্লিষ্ট পরিষেবা ঘটনা UUID।",
            "format": "uuid",
            "type": "string"
          },
          "intervals": {
            "description": "ক্ষতিপূরণ দেওয়া সময়ের ব্যবধান JSON স্ট্রিং হিসেবে ফেরত আসে।",
            "type": "string"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "type": "string"
          },
          "purchase_id": {
            "description": "সংশ্লিষ্ট প্যাকেজ ক্রয় UUID।",
            "format": "uuid",
            "type": "string"
          },
          "seconds": {
            "description": "পরিষেবা ক্ষতিপূরণ হিসেবে যোগ করা সেকেন্ড।",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "incident_id",
          "mode",
          "seconds",
          "purchase_id",
          "created_at"
        ],
        "type": "object"
      },
      "ServiceCompensationList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/ServiceCompensation"
            },
            "type": "array"
          }
        },
        "required": [
          "items"
        ],
        "type": "object"
      },
      "ServiceIncident": {
        "additionalProperties": false,
        "properties": {
          "affected_tenants": {
            "description": "ওয়ার্কস্পেস ID-এর JSON-এ এনকোড করা অ্যারে; [] বৈশ্বিক।",
            "type": "string"
          },
          "body": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "emergency": {
            "type": "boolean"
          },
          "ends_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "starts_at": {
            "format": "date-time",
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "version": {
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "ServiceIncidentInput": {
        "additionalProperties": false,
        "properties": {
          "affected_tenants": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "type": "array"
          },
          "body": {
            "type": "string"
          },
          "emergency": {
            "type": "boolean"
          },
          "ends_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "expected_version": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "kind": {
            "enum": [
              "maintenance",
              "incident"
            ],
            "type": "string"
          },
          "starts_at": {
            "format": "date-time",
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "kind",
          "title",
          "body",
          "starts_at"
        ],
        "type": "object"
      },
      "ServiceIncidentList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/ServiceIncident"
            },
            "type": "array"
          },
          "now": {
            "format": "date-time",
            "type": "string"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "SignedCapabilities": {
        "additionalProperties": false,
        "properties": {
          "app_version": {
            "description": "এই Launch অনুমোদন কাজের app version।",
            "pattern": "^(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})\\.(0|[1-9][0-9]{0,8})$",
            "type": "string"
          },
          "binding_version": {
            "description": "অনুমোদন সেশনের সঙ্গে যুক্ত স্বাক্ষরিত ডিভাইস বাইন্ডিং জেনারেশন।",
            "minimum": 1,
            "type": "integer"
          },
          "environment": {
            "description": "বাণিজ্য পরিবেশ, সংযোগ ও স্বাক্ষরিত গ্রান্ট উভয়ে পিন করা।",
            "enum": [
              "live",
              "sandbox"
            ],
            "type": "string"
          },
          "launch_connection_id": {
            "description": "Licentivo রিসোর্স UUID।",
            "format": "uuid",
            "type": "string"
          },
          "license_model": {
            "description": "এই Launch অনুমোদন কাজের license model।",
            "enum": [
              "node_locked",
              "floating"
            ],
            "type": "string"
          },
          "maintenance_until": {
            "description": "এই Launch অনুমোদন কাজের maintenance until।",
            "type": "integer"
          },
          "session_expires_at": {
            "description": "এই Launch অনুমোদন কাজের session expires at।",
            "maximum": 253402300799,
            "type": "integer"
          },
          "session_id": {
            "description": "এই Launch অনুমোদন কাজের session id।",
            "format": "uuid",
            "type": "string"
          },
          "version_released_at": {
            "description": "এই Launch অনুমোদন কাজের version released at।",
            "type": "integer"
          }
        },
        "required": [
          "license_model"
        ],
        "type": "object"
      },
      "SigningKey": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "description": "বর্তমান স্বাক্ষর কী ফ্ল্যাগ; নীতি প্রিভিউতে সক্রিয় ডিভাইস/সেশন সংখ্যা।",
            "type": "boolean"
          },
          "algorithm": {
            "const": "Ed25519",
            "description": "স্বাক্ষর অ্যালগরিদম, বর্তমানে Ed25519।",
            "type": "string"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "key_id": {
            "description": "যাচাই কী নির্বাচনের পণ্য স্বাক্ষর কী UUID।",
            "format": "uuid",
            "type": "string"
          },
          "public_key": {
            "description": "Base64URL-এ এনকোড করা Ed25519 পাবলিক কী; ব্যক্তিগত উপাদান নেই।",
            "type": "string"
          },
          "retired_at": {
            "anyOf": [
              {
                "description": "কী অবসর টাইমস্ট্যাম্প; বর্তমান কী-তে null। অবসরপ্রাপ্ত পাবলিক কী যাচাইয়ের জন্য উপলব্ধ থাকে।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "কী অবসর টাইমস্ট্যাম্প; বর্তমান কী-তে null। অবসরপ্রাপ্ত পাবলিক কী যাচাইয়ের জন্য উপলব্ধ থাকে।",
                "type": "null"
              }
            ],
            "description": "কী অবসর টাইমস্ট্যাম্প; বর্তমান কী-তে null। অবসরপ্রাপ্ত পাবলিক কী যাচাইয়ের জন্য উপলব্ধ থাকে।"
          }
        },
        "required": [
          "key_id",
          "public_key",
          "active"
        ],
        "type": "object"
      },
      "StateResult": {
        "additionalProperties": false,
        "example": {
          "id": "33333333-3333-4333-8333-333333333333",
          "status": "pending"
        },
        "properties": {
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "status": {
            "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
            "type": "string"
          }
        },
        "required": [
          "id",
          "status"
        ],
        "type": "object"
      },
      "Subscription": {
        "additionalProperties": false,
        "properties": {
          "current": {
            "$ref": "#/components/schemas/Period",
            "description": "বর্তমান UTC মাসের ডিফল্ট বিলিং স্ন্যাপশট।"
          },
          "next": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PendingPlan",
                "description": "নির্ধারিত পরের মাসের ডিফল্ট প্ল্যান, বা null।"
              },
              {
                "description": "নির্ধারিত পরের মাসের ডিফল্ট প্ল্যান, বা null।",
                "type": "null"
              }
            ],
            "description": "নির্ধারিত পরের মাসের ডিফল্ট প্ল্যান, বা null।"
          },
          "sandbox": {
            "description": "এই সাবস্ক্রিপশন প্রিভিউ true ফেরত দেয়। প্রকৃত পেমেন্ট পরিবেশ এই প্রিভিউ ফ্ল্যাগ থেকে নয়, বিলিং/পেমেন্ট সেটিংস থেকে নির্ধারণ করুন।",
            "type": "boolean"
          }
        },
        "required": [],
        "type": "object"
      },
      "Summary": {
        "additionalProperties": false,
        "properties": {
          "active_licenses": {
            "description": "সক্রিয়, মেয়াদ শেষ নয় এমন লাইসেন্স সংখ্যা, প্রথম অ্যাক্টিভেশন অপেক্ষমাণসহ।",
            "type": "integer"
          },
          "licenses": {
            "description": "আর্কাইভ নয় এমন লাইসেন্সের সংখ্যা।",
            "type": "integer"
          },
          "policies": {
            "description": "আর্কাইভ নয় এমন নীতির সংখ্যা।",
            "type": "integer"
          },
          "products": {
            "description": "সারাংশে পণ্য সংখ্যা; ব্যবহার প্রতিক্রিয়ায় প্রতি পণ্যের ডিভাইস ব্যবহার গোষ্ঠী।",
            "type": "integer"
          }
        },
        "required": [
          "products",
          "policies",
          "licenses",
          "active_licenses"
        ],
        "type": "object"
      },
      "SupportCase": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "type": "integer"
          },
          "approved_cents": {
            "type": "integer"
          },
          "cancellation_preview": {
            "description": "JSON-এ এনকোড করা বাতিল প্রিভিউ।",
            "type": "string"
          },
          "cancellation_scope": {
            "type": "string"
          },
          "change_id": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "decision": {
            "type": "string"
          },
          "first_response_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "held_cents": {
            "type": "integer"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "incident_id": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "manual_cents": {
            "type": "integer"
          },
          "manual_refund_pending": {
            "type": "boolean"
          },
          "mode": {
            "type": "string"
          },
          "order_id": {
            "type": "string"
          },
          "purchase_id": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "refund_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "refund_totals": {
            "description": "প্রতি মুদ্রার মোট JSON-এ এনকোড; ভিন্ন মুদ্রা কখনো যোগ করবেন না।",
            "type": "string"
          },
          "request_id": {
            "type": "string"
          },
          "response_due_at": {
            "format": "date-time",
            "type": "string"
          },
          "review_due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "reviewed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "scope_ids": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "subject": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "SupportCaseDetail": {
        "additionalProperties": false,
        "properties": {
          "case": {
            "$ref": "#/components/schemas/SupportCase"
          },
          "messages": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "body": {
                  "type": "string"
                },
                "case_id": {
                  "format": "uuid",
                  "type": "string"
                },
                "created_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "id": {
                  "format": "uuid",
                  "type": "string"
                },
                "staff": {
                  "type": "boolean"
                },
                "user_id": {
                  "format": "uuid",
                  "type": "string"
                }
              },
              "required": [],
              "type": "object"
            },
            "type": "array"
          },
          "original_refund_receipts": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "amount_cents": {
                  "minimum": 0,
                  "type": "integer"
                },
                "currency": {
                  "type": "string"
                },
                "intent_id": {
                  "format": "uuid",
                  "type": "string"
                },
                "refund_id": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "original_refunds": {
            "items": {
              "$ref": "#/components/schemas/ProviderRefund"
            },
            "type": "array"
          },
          "refund_payments": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "amount_cents": {
                  "minimum": 0,
                  "type": "integer"
                },
                "currency": {
                  "type": "string"
                },
                "id": {
                  "format": "uuid",
                  "type": "string"
                },
                "provider": {
                  "type": "string"
                },
                "provider_order_id": {
                  "type": "string"
                },
                "refunded_cents": {
                  "minimum": 0,
                  "type": "integer"
                },
                "status": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "refund_provider": {
            "type": "string"
          },
          "refund_unverified": {
            "type": "boolean"
          },
          "refunds": {
            "items": {
              "$ref": "#/components/schemas/PayPalRefund"
            },
            "type": "array"
          }
        },
        "required": [],
        "type": "object"
      },
      "SupportCaseInput": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "maxLength": 10000,
            "type": "string"
          },
          "kind": {
            "enum": [
              "support",
              "privacy",
              "appeal"
            ],
            "type": "string"
          },
          "request_id": {
            "maxLength": 80,
            "type": "string"
          },
          "subject": {
            "maxLength": 200,
            "type": "string"
          }
        },
        "required": [
          "subject",
          "body",
          "request_id"
        ],
        "type": "object"
      },
      "SupportCaseList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/SupportCase"
            },
            "type": "array"
          },
          "now": {
            "format": "date-time",
            "type": "string"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "SupportContact": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "description": "বিলিং মেইলের প্রকাশ্য সহায়তা ইমেইল ও Reply-To। ফাঁকা হলে যোগাযোগ লুকানো। এটি বিদ্যমান SMTP From ঠিকানা বদলায় না বা ইনবক্স তৈরি করে না।",
            "maxLength": 254,
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "type": "object"
      },
      "SupportReadInput": {
        "additionalProperties": false,
        "properties": {
          "last_message_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "last_message_id"
        ],
        "type": "object"
      },
      "SupportReply": {
        "additionalProperties": false,
        "properties": {
          "body": {
            "maxLength": 10000,
            "type": "string"
          },
          "expected_updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "status": {
            "enum": [
              "",
              "reviewing",
              "awaiting_info",
              "resolved"
            ],
            "type": "string"
          }
        },
        "required": [
          "body"
        ],
        "type": "object"
      },
      "SupportUnread": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "case_id": {
                  "format": "uuid",
                  "type": "string"
                },
                "unread_messages": {
                  "type": "integer"
                }
              },
              "required": [],
              "type": "object"
            },
            "type": "array"
          },
          "unread_cases": {
            "type": "integer"
          },
          "unread_messages": {
            "type": "integer"
          },
          "unread_notices": {
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "SystemSettings": {
        "additionalProperties": false,
        "properties": {
          "database": {
            "$ref": "#/components/schemas/DatabaseStatus"
          },
          "environment": {
            "type": "string"
          },
          "mail": {
            "$ref": "#/components/schemas/MailSettings"
          },
          "public_url": {
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "mail",
          "database"
        ],
        "type": "object"
      },
      "TLSCertificateInfo": {
        "additionalProperties": false,
        "properties": {
          "algorithm": {
            "type": "string"
          },
          "chain_length": {
            "maximum": 10,
            "minimum": 1,
            "type": "integer"
          },
          "domains": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "fingerprint_sha256": {
            "pattern": "^[0-9a-f]{64}$",
            "type": "string"
          },
          "issuer": {
            "type": "string"
          },
          "not_after": {
            "format": "date-time",
            "type": "string"
          },
          "not_before": {
            "format": "date-time",
            "type": "string"
          },
          "self_signed": {
            "type": "boolean"
          },
          "serial_number": {
            "type": "string"
          },
          "subject": {
            "type": "string"
          }
        },
        "required": [
          "domains",
          "subject",
          "issuer",
          "not_before",
          "not_after",
          "fingerprint_sha256",
          "serial_number",
          "algorithm",
          "chain_length",
          "self_signed"
        ],
        "type": "object"
      },
      "TLSCertificateInput": {
        "additionalProperties": false,
        "properties": {
          "certificate_pem": {
            "description": "PEM লিফ সার্টিফিকেটের পরে তার মধ্যবর্তী সার্টিফিকেট ক্রমানুসারে। public_url-এর সঙ্গে মিলতে হবে। স্ব-স্বাক্ষরিত সার্টিফিকেট শুধু স্থানীয় ডেভেলপমেন্টে অনুমোদিত।",
            "maxLength": 32768,
            "type": "string",
            "writeOnly": true
          },
          "expected_version": {
            "description": "GET /system/tls থেকে version ব্যবহার করুন। আপডেটে প্রয়োজন; সমবর্তী প্রতিস্থাপনে 409 ফেরত আসে।",
            "type": "string"
          },
          "private_key_pem": {
            "description": "মিল থাকা এনক্রিপ্ট নয় এমন PEM কী (PKCS#8, RSA বা EC)। কোনো প্রতিক্রিয়ায় কখনো ফেরত দেয় না।",
            "maxLength": 16384,
            "type": "string",
            "writeOnly": true
          }
        },
        "required": [
          "certificate_pem",
          "private_key_pem"
        ],
        "type": "object"
      },
      "TLSCertificateResult": {
        "additionalProperties": false,
        "properties": {
          "certificate": {
            "$ref": "#/components/schemas/TLSCertificateInfo"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "version": {
            "type": "string"
          }
        },
        "required": [
          "certificate",
          "version",
          "updated_at"
        ],
        "type": "object"
      },
      "TLSCertificateUpdateInput": {
        "additionalProperties": false,
        "properties": {
          "certificate_pem": {
            "description": "PEM লিফ সার্টিফিকেটের পরে তার মধ্যবর্তী সার্টিফিকেট ক্রমানুসারে। public_url-এর সঙ্গে মিলতে হবে। স্ব-স্বাক্ষরিত সার্টিফিকেট শুধু স্থানীয় ডেভেলপমেন্টে অনুমোদিত।",
            "maxLength": 32768,
            "type": "string",
            "writeOnly": true
          },
          "expected_version": {
            "description": "GET /system/tls থেকে version ব্যবহার করুন। আপডেটে প্রয়োজন; সমবর্তী প্রতিস্থাপনে 409 ফেরত আসে।",
            "type": "string"
          },
          "private_key_pem": {
            "description": "মিল থাকা এনক্রিপ্ট নয় এমন PEM কী (PKCS#8, RSA বা EC)। কোনো প্রতিক্রিয়ায় কখনো ফেরত দেয় না।",
            "maxLength": 16384,
            "type": "string",
            "writeOnly": true
          }
        },
        "required": [
          "certificate_pem",
          "private_key_pem",
          "expected_version"
        ],
        "type": "object"
      },
      "TLSStatus": {
        "additionalProperties": false,
        "properties": {
          "address": {
            "type": "string"
          },
          "certificate": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TLSCertificateInfo"
              },
              {
                "type": "null"
              }
            ]
          },
          "enabled": {
            "type": "boolean"
          },
          "http_redirect_address": {
            "type": "string"
          },
          "public_url": {
            "type": "string"
          },
          "updated_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "version": {
            "type": "string"
          }
        },
        "required": [
          "enabled",
          "public_url",
          "address",
          "http_redirect_address",
          "certificate",
          "version",
          "updated_at"
        ],
        "type": "object"
      },
      "TestMail": {
        "additionalProperties": false,
        "properties": {
          "to": {
            "format": "email",
            "type": "string"
          }
        },
        "required": [
          "to"
        ],
        "type": "object"
      },
      "Token": {
        "additionalProperties": false,
        "properties": {
          "token": {
            "maxLength": 100,
            "minLength": 32,
            "type": "string",
            "writeOnly": true
          }
        },
        "required": [
          "token"
        ],
        "type": "object"
      },
      "TokenPassword": {
        "additionalProperties": false,
        "properties": {
          "password": {
            "description": "12–128 UTF-8 বাইট, অক্ষর নয়",
            "type": "string",
            "writeOnly": true
          },
          "password_confirmation": {
            "description": "আবশ্যক এবং পাসওয়ার্ডের সঙ্গে হুবহু মিলতে হবে",
            "type": "string",
            "writeOnly": true
          },
          "token": {
            "maxLength": 100,
            "minLength": 32,
            "type": "string",
            "writeOnly": true
          }
        },
        "required": [
          "token",
          "password",
          "password_confirmation"
        ],
        "type": "object"
      },
      "TransferCode": {
        "additionalProperties": false,
        "properties": {
          "activation_code": {
            "pattern": "^lv_tmp_[A-Za-z0-9_-]{43}$",
            "type": "string"
          },
          "activation_id": {
            "format": "uuid",
            "type": "string"
          },
          "expires_at": {
            "format": "date-time",
            "type": "string"
          },
          "license_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "activation_id",
          "activation_code",
          "expires_at",
          "license_id"
        ],
        "type": "object"
      },
      "TranslationCheck": {
        "additionalProperties": false,
        "properties": {
          "connected": {
            "type": "boolean"
          },
          "languages": {
            "items": {
              "$ref": "#/components/schemas/TranslationLanguage"
            },
            "type": "array"
          },
          "provider_usage": {
            "additionalProperties": false,
            "properties": {
              "character_count": {
                "type": "integer"
              },
              "character_limit": {
                "type": "integer"
              }
            },
            "required": [
              "character_count",
              "character_limit"
            ],
            "type": "object"
          }
        },
        "required": [
          "connected",
          "languages",
          "provider_usage"
        ],
        "type": "object"
      },
      "TranslationLanguage": {
        "additionalProperties": false,
        "properties": {
          "lang": {
            "description": "DeepL v3 ফেরত BCP 47 লক্ষ্য কোড, যেমন en-US বা zh-Hant।",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "usable_as_target": {
            "type": "boolean"
          }
        },
        "required": [
          "lang",
          "name",
          "usable_as_target"
        ],
        "type": "object"
      },
      "TranslationOptions": {
        "additionalProperties": false,
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "languages": {
            "items": {
              "$ref": "#/components/schemas/TranslationLanguage"
            },
            "type": "array"
          },
          "provider": {
            "type": "string"
          }
        },
        "required": [
          "enabled",
          "languages",
          "provider"
        ],
        "type": "object"
      },
      "TranslationSettings": {
        "additionalProperties": false,
        "properties": {
          "checked_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "enabled": {
            "type": "boolean"
          },
          "key_configured": {
            "type": "boolean"
          },
          "languages": {
            "items": {
              "$ref": "#/components/schemas/TranslationLanguage"
            },
            "type": "array"
          },
          "local_usage": {
            "$ref": "#/components/schemas/TranslationUsage"
          },
          "monthly_limit": {
            "description": "স্থানীয় মাসিক অক্ষর বাজেট, DeepL অ্যাকাউন্ট কোটা ও বিলিং তারিখ থেকে স্বাধীন।",
            "type": "integer"
          },
          "requests_per_minute": {
            "type": "integer"
          },
          "tier": {
            "enum": [
              "free",
              "pro"
            ],
            "type": "string"
          },
          "version": {
            "type": "string"
          }
        },
        "required": [
          "enabled",
          "tier",
          "key_configured",
          "monthly_limit",
          "requests_per_minute",
          "languages",
          "checked_at",
          "version",
          "local_usage"
        ],
        "type": "object"
      },
      "TranslationSettingsInput": {
        "additionalProperties": false,
        "properties": {
          "api_key": {
            "description": "এনক্রিপ্টেড সংরক্ষিত। clear_key true না হলে ফাঁকা মান সংরক্ষিত কী রাখে। কী/স্তর বদলালে আরেকটি সফল সংযোগ পরীক্ষা প্রয়োজন।",
            "maxLength": 1000,
            "type": "string",
            "writeOnly": true
          },
          "clear_key": {
            "type": "boolean"
          },
          "enabled": {
            "type": "boolean"
          },
          "expected_version": {
            "type": "string"
          },
          "monthly_limit": {
            "maximum": 1000000000,
            "minimum": 1,
            "type": "integer"
          },
          "requests_per_minute": {
            "maximum": 60,
            "minimum": 1,
            "type": "integer"
          },
          "tier": {
            "enum": [
              "free",
              "pro"
            ],
            "type": "string"
          }
        },
        "required": [
          "enabled",
          "tier",
          "monthly_limit",
          "requests_per_minute",
          "expected_version"
        ],
        "type": "object"
      },
      "TranslationUsage": {
        "additionalProperties": false,
        "properties": {
          "characters": {
            "description": "সফল বিল করা অক্ষর এবং অজানা ফলের অনুরোধের সতর্ক সংরক্ষণ। ক্যাশ হিট ব্যবহার বাড়ায় না।",
            "type": "integer"
          },
          "month": {
            "description": "UTC ক্যালেন্ডার মাস YYYY-MM।",
            "type": "string"
          }
        },
        "required": [
          "month",
          "characters"
        ],
        "type": "object"
      },
      "Trial": {
        "additionalProperties": false,
        "properties": {
          "base_url": {
            "type": "string"
          },
          "duration_days": {
            "const": 7,
            "type": "integer"
          },
          "expires_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "isolated": {
            "type": "boolean"
          },
          "key": {
            "type": "string",
            "writeOnly": true
          },
          "license_id": {
            "format": "uuid",
            "type": "string"
          },
          "product_id": {
            "format": "uuid",
            "type": "string"
          },
          "trusted_keys": {
            "items": {
              "$ref": "#/components/schemas/SigningKey"
            },
            "type": "array"
          }
        },
        "required": [
          "product_id",
          "license_id",
          "key",
          "trusted_keys"
        ],
        "type": "object"
      },
      "UpgradeList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/PlanUpgrade"
            },
            "type": "array"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total"
        ],
        "type": "object"
      },
      "UpgradePart": {
        "additionalProperties": false,
        "description": "একটি বর্তমান বা ভবিষ্যৎ প্রিপেইড সময়ের স্থির আপগ্রেড গণনা। change.amount_cents এই সময়ের পার্থক্য; শুধু প্যারেন্ট কোট সম্মিলিত অর্থ চার্জ করে।",
        "properties": {
          "change": {
            "$ref": "#/components/schemas/PlanUpgrade",
            "description": "এই আপগ্রেড অংশের মূল্য ও অধিকারের পরিবর্তন।"
          },
          "ends_at": {
            "description": "প্যাকেজ বা চক্র শেষের টাইমস্ট্যাম্প, UTC; অ্যাক্টিভেশনের আগে null হতে পারে।",
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "source": {
            "description": "অধিকারের উৎস, যেমন purchase বা gift।",
            "enum": [
              "purchase",
              "gift",
              "auto_renewal"
            ],
            "type": "string"
          },
          "starts_at": {
            "description": "প্যাকেজ বা চক্র শুরুর টাইমস্ট্যাম্প, UTC।",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "source",
          "starts_at",
          "ends_at",
          "change"
        ],
        "type": "object"
      },
      "UpgradeQuoteInput": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "plan": {
            "pattern": "^[a-z][a-z0-9_-]{0,63}$",
            "type": "string"
          },
          "price_version": {
            "type": "string"
          },
          "request_id": {
            "maxLength": 80,
            "type": "string"
          }
        },
        "required": [
          "plan",
          "currency",
          "price_version",
          "request_id"
        ],
        "type": "object"
      },
      "Usage": {
        "additionalProperties": false,
        "properties": {
          "active_devices": {
            "description": "বর্তমান UTC মাসে: বর্তমান নিবন্ধিত পণ্য/ডিভাইস দখল, মাসিক ডিভাইস ব্যবহার ইতিহাস থেকে স্বাধীন। সাধারণ নিবন্ধন রিলিজ না হওয়া পর্যন্ত অফলাইনে গণনায় থাকে। Floating সেশন শুধু বৈধ লিজে গণনা হয় ও হার্ডওয়্যার দিয়ে ডুপ্লিকেট বাদ দেয়, না থাকলে ডিভাইস পরিচয় ব্যবহার করে। রিলিজ বা শেষ floating সেশনের মেয়াদ শেষ হলে ক্ষমতা ফেরে; বৈধ নিবন্ধন কোটা-মাসের সীমা পেরিয়ে থাকে। বিচ্ছিন্ন SDK ট্রায়াল নিবন্ধন বাদ। অন্য UTC মাসে: সেই মাসে রেকর্ড করা পৃথক ডিভাইস ব্যবহার ইতিহাস।",
            "type": "integer"
          },
          "api_calls": {
            "description": "নির্বাচিত UTC মাস ও পেমেন্ট পরিবেশে সফল activate, validate, heartbeat ও deactivate কল। ব্যর্থতা, বৈধ idempotent রিপ্লে, স্থানীয় পরীক্ষা ও সফটওয়্যার ফিচার ব্যবহার বাদ। কেনা প্যাকেজ ভাতার তুলনায় purchased.api_calls ব্যবহার করুন, যা প্যাকেজ কোটা মাস অনুসরণ করে।",
            "type": "integer"
          },
          "api_period": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RuntimeAPIPeriod",
                "description": "এই UTC মাসের ডিফল্ট API ভাতা স্ন্যাপশট; নিষ্ক্রিয় হলে null হতে পারে।"
              },
              {
                "description": "এই UTC মাসের ডিফল্ট API ভাতা স্ন্যাপশট; নিষ্ক্রিয় হলে null হতে পারে।",
                "type": "null"
              }
            ],
            "description": "ডিফল্ট UTC-মাস API ভাতা; অনুপলব্ধ হলে null। কেনা প্যাকেজে বর্তমান কোটা মাসের জন্য purchased.api_calls ও purchased.included_api_calls ব্যবহার করুন।"
          },
          "billable_devices": {
            "description": "বর্তমান UTC মাসে সক্রিয় ক্রয় না থাকলে ডিফল্ট ভাতার অধীনে বর্তমান ডিভাইস দখল। বন্ধ মাস বা প্রিপেইড কভারেজে সংরক্ষিত ডিফল্ট সময়ের বিলিং শীর্ষ। অনুমানে অন্তত রেকর্ড করা শীর্ষ ব্যবহৃত হয়; ডিভাইস রিলিজে ইতিমধ্যে ধার্য চার্জ ফেরত হয় না।",
            "type": "integer"
          },
          "estimated_total_cents": {
            "description": "আনুমানিক ডিফল্ট মাসিক ডিভাইস চার্জ মুদ্রা এককের শতভাগে।",
            "type": "integer"
          },
          "estimated_total_micros": {
            "description": "আনুমানিক ডিফল্ট মাসিক ডিভাইস চার্জ দশ লক্ষ ভাগে; সব প্যাকেজ চার্জের সমষ্টি নয়।",
            "type": "integer"
          },
          "month": {
            "description": "UTC মাস YYYY-MM; বাদ দেওয়া কোয়েরি মানে বর্তমান মাস ব্যবহৃত হয়। বিলিং কাজে বন্ধ মাস প্রয়োজন।",
            "type": "string"
          },
          "operations": {
            "description": "activate, validate, heartbeat ও deactivate অনুযায়ী গোষ্ঠীবদ্ধ সফল মিটার করা কল সংখ্যা।",
            "items": {
              "additionalProperties": false,
              "properties": {
                "count": {
                  "description": "বর্তমান গোষ্ঠীর সংখ্যা, বা ব্যাচে প্রক্রিয়াকৃত রেকর্ড সংখ্যা।",
                  "type": "integer"
                },
                "operation": {
                  "description": "কাজের নাম; ব্যাচ create/renew/revoke/apply_policy এবং অফলাইন অনুরোধ activate/deactivate সমর্থন করে।",
                  "type": "string"
                }
              },
              "required": [],
              "type": "object"
            },
            "type": "array"
          },
          "overage_devices": {
            "description": "অন্তর্ভুক্ত ভাতা অতিক্রম করা ডিভাইস।",
            "type": "integer"
          },
          "period": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Period",
                "description": "ডিফল্ট UTC মাসিক বিলিং স্ন্যাপশট; মিটার নিয়ম month/day/lifetime এবং ব্যবহার সারি নির্দিষ্ট সময়কাল কী ব্যবহার করে।"
              },
              {
                "description": "ডিফল্ট UTC মাসিক বিলিং স্ন্যাপশট; মিটার নিয়ম month/day/lifetime এবং ব্যবহার সারি নির্দিষ্ট সময়কাল কী ব্যবহার করে।",
                "type": "null"
              }
            ],
            "description": "স্থির ডিফল্ট/ইতিহাস UTC বিলিং ভাতা। এমন সময় না থাকলে এবং ডিফল্ট অফার অক্ষম হলে null; সক্রিয় ক্রয় ব্যবহারযোগ্য থাকে।"
          },
          "products": {
            "description": "সারাংশে পণ্য সংখ্যা; ব্যবহার প্রতিক্রিয়ায় প্রতি পণ্যের ডিভাইস ব্যবহার গোষ্ঠী।",
            "items": {
              "additionalProperties": false,
              "properties": {
                "active_devices": {
                  "description": "বর্তমান UTC মাসে প্রতি পণ্যের বর্তমান দখল; পূর্ববর্তী UTC মাসে ঐতিহাসিক পৃথক ডিভাইস ব্যবহার।",
                  "type": "integer"
                },
                "product_id": {
                  "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
                  "format": "uuid",
                  "type": "string"
                }
              },
              "required": [],
              "type": "object"
            },
            "type": "array"
          },
          "purchased": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlanPurchase",
                "description": "বর্তমান সক্রিয় রোলিং-মাস প্যাকেজ, বা null।"
              },
              {
                "description": "বর্তমান সক্রিয় রোলিং-মাস প্যাকেজ, বা null।",
                "type": "null"
              }
            ],
            "description": "বর্তমান পেমেন্ট পরিবেশের সক্রিয় প্যাকেজ, শুধু বর্তমান UTC মাসে ফেরত আসে। প্রধান ডিভাইস কোটা purchased.included_devices ব্যবহার করবে, period.included_devices নয়।"
          },
          "purchased_active_devices": {
            "description": "purchased থাকলে: বর্তমান নিবন্ধিত পণ্য/ডিভাইস দখল, মাসিক ডিভাইস ব্যবহার ইতিহাস থেকে স্বাধীন। সাধারণ নিবন্ধন রিলিজ না হওয়া পর্যন্ত অফলাইনে গণনায় থাকে। Floating সেশন শুধু বৈধ লিজে গণনা হয় ও হার্ডওয়্যার দিয়ে ডুপ্লিকেট বাদ দেয়, না থাকলে ডিভাইস পরিচয় ব্যবহার করে। রিলিজ বা শেষ floating সেশনের মেয়াদ শেষ হলে ক্ষমতা ফেরে; বৈধ নিবন্ধন কোটা-মাসের সীমা পেরিয়ে থাকে। বিচ্ছিন্ন SDK ট্রায়াল নিবন্ধন বাদ।",
            "type": "integer"
          },
          "sandbox": {
            "description": "পরীক্ষার পরিবেশ",
            "type": "boolean"
          },
          "timezone": {
            "description": "ব্যবহার সমষ্টির টাইমজোন, UTC।",
            "type": "string"
          },
          "warning": {
            "description": "ডিফল্ট ডিভাইস ভাতার জন্য normal, near_quota বা quota_reached।",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "UsageDevice": {
        "additionalProperties": false,
        "properties": {
          "device_id": {
            "description": "পণ্য-পরিসরের ডিভাইস ফিঙ্গারপ্রিন্ট, সাধারণত 64 ছোট হাতের hex অক্ষর, SDK তৈরি করে।",
            "type": "string"
          },
          "first_seen_at": {
            "description": "এই UTC মাসে প্রথম ডিভাইস কার্যকলাপের টাইমস্ট্যাম্প।",
            "format": "date-time",
            "type": "string"
          },
          "last_seen_at": {
            "description": "সার্ভারের দেখা সর্বশেষ ডিভাইস কার্যকলাপ টাইমস্ট্যাম্প, UTC।",
            "format": "date-time",
            "type": "string"
          },
          "month": {
            "description": "UTC মাস YYYY-MM; বাদ দেওয়া কোয়েরি মানে বর্তমান মাস ব্যবহৃত হয়। বিলিং কাজে বন্ধ মাস প্রয়োজন।",
            "type": "string"
          },
          "product_id": {
            "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "UsageDeviceList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/UsageDevice"
            },
            "type": "array"
          },
          "limit": {
            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
            "type": "integer"
          },
          "offset": {
            "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
            "type": "integer"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total"
        ],
        "type": "object"
      },
      "Verified": {
        "additionalProperties": false,
        "properties": {
          "verified": {
            "type": "boolean"
          }
        },
        "required": [
          "verified"
        ],
        "type": "object"
      },
      "VersionedActivationReleaseInput": {
        "additionalProperties": false,
        "properties": {
          "expected_generation": {
            "description": "বর্তমান ডিভাইস তালিকায় প্রদর্শিত বাইন্ডিং জেনারেশন। Launch অ্যাকাউন্ট বাইন্ডিংয়ে প্রয়োজন; পুরোনো সংস্করণ নতুন বাইন্ডিং রিলিজ করে না।",
            "minimum": 1,
            "type": "integer"
          },
          "operation_id": {
            "description": "পুনঃপ্রচেষ্টা পুনরুদ্ধারের স্থির কাজ UUID। Launch অ্যাকাউন্ট বাইন্ডিংয়ে প্রয়োজন।",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "WaffoCheck": {
        "additionalProperties": false,
        "properties": {
          "connected": {
            "description": "চালু",
            "type": "boolean"
          },
          "mode": {
            "description": "পেমেন্ট পরিবেশ। Sandbox ও live রেকর্ড বিচ্ছিন্ন।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          }
        },
        "required": [
          "connected",
          "mode"
        ],
        "type": "object"
      },
      "WaffoOrder": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "description": "ক্ষুদ্রতম মুদ্রা এককে স্থির পূর্ণ পরিষেবা মূল্য; ওয়ালেট রিচার্জ বা মিশ্র পেমেন্ট নয়।",
            "type": "integer"
          },
          "applied_at": {
            "anyOf": [
              {
                "description": "মূল চেকআউট তৈরির সময়সীমার UTC শেষ সময়।",
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "যাচাইকৃত পেমেন্টে পরিষেবা সক্রিয় বা ওয়ালেট টপ-আপ ক্রেডিটের UTC সময়। null purchase_id ও upgrade_id টপ-আপ শনাক্ত করে।"
          },
          "checkout_expires_at": {
            "description": "মূল চেকআউট তৈরির সময়সীমার UTC শেষ সময়।",
            "format": "date-time",
            "type": "string"
          },
          "created_at": {
            "description": "মূল চেকআউট তৈরির সময়সীমার UTC শেষ সময়।",
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
            "type": "string"
          },
          "id": {
            "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
            "format": "uuid",
            "type": "string"
          },
          "mode": {
            "description": "পেমেন্ট পরিবেশ। Sandbox ও live রেকর্ড বিচ্ছিন্ন।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "paid_at": {
            "anyOf": [
              {
                "description": "মূল চেকআউট তৈরির সময়সীমার UTC শেষ সময়।",
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "ব্যাকএন্ডের সম্পন্ন Waffo লেনদেন যাচাইয়ের UTC সময়।"
          },
          "provider_order_id": {
            "anyOf": [
              {
                "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "যাচাইকৃত API প্রতিক্রিয়া থেকে পুনরুদ্ধার মূল ORD_ শনাক্তকারী।"
          },
          "purchase_id": {
            "anyOf": [
              {
                "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "বিদ্যমান অপেক্ষমাণ পরিষেবা ক্রয় বা নবায়ন; upgrade_id-এর সঙ্গে পারস্পরিকভাবে একচেটিয়া।"
          },
          "refunded_cents": {
            "description": "ক্ষুদ্রতম মুদ্রা এককে স্থির পূর্ণ পরিষেবা মূল্য; ওয়ালেট রিচার্জ বা মিশ্র পেমেন্ট নয়।",
            "type": "integer"
          },
          "request_id": {
            "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
            "type": "string"
          },
          "status": {
            "description": "পেমেন্ট জীবনচক্র, সংগৃহীত অর্থ অপারেটর পর্যালোচনা ও রিফান্ড চাইলে paid_unapplied সহ।",
            "enum": [
              "creating",
              "created",
              "completed",
              "paid_unapplied",
              "partially_refunded",
              "refunded"
            ],
            "type": "string"
          },
          "upgrade_id": {
            "anyOf": [
              {
                "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "বিদ্যমান অপেক্ষমাণ আপগ্রেড কোট; purchase_id-এর সঙ্গে পারস্পরিকভাবে একচেটিয়া।"
          }
        },
        "required": [
          "id",
          "request_id",
          "mode",
          "provider_order_id",
          "purchase_id",
          "upgrade_id",
          "currency",
          "amount_cents",
          "refunded_cents",
          "status",
          "checkout_expires_at",
          "paid_at",
          "applied_at",
          "created_at"
        ],
        "type": "object"
      },
      "WaffoOrderInput": {
        "additionalProperties": false,
        "description": "একটি স্থির ক্রয়/আপগ্রেড পরিশোধ করুন, অথবা পরিষেবা ID ছাড়া অর্থ ও মুদ্রা দিয়ে ওয়ালেট টপ-আপ তৈরি করুন। স্থির request_id মূল পেমেন্ট ফেরত দেয়; উদ্দেশ্য, অর্থ বা মুদ্রা পরিবর্তন প্রত্যাখ্যাত। শুধু স্বাধীনভাবে যাচাইকৃত সম্পন্ন পেমেন্ট ওয়ালেট ক্রেডিট বা পরিষেবা সক্রিয় করে। টপ-আপের রিটার্ন ওয়ালেটে যায়। পুনঃপ্রচেষ্টা মূল প্রদানকারীর idempotency কী শুধু তার মূল চেকআউট তৈরির সময়সীমার মধ্যে পুনর্ব্যবহার করে।",
        "oneOf": [
          {
            "not": {
              "anyOf": [
                {
                  "required": [
                    "amount"
                  ]
                },
                {
                  "required": [
                    "currency"
                  ]
                }
              ]
            },
            "properties": {
              "purchase_id": {
                "format": "uuid",
                "type": "string"
              },
              "upgrade_id": {
                "type": "null"
              }
            },
            "required": [
              "purchase_id"
            ]
          },
          {
            "not": {
              "anyOf": [
                {
                  "required": [
                    "amount"
                  ]
                },
                {
                  "required": [
                    "currency"
                  ]
                }
              ]
            },
            "properties": {
              "purchase_id": {
                "type": "null"
              },
              "upgrade_id": {
                "format": "uuid",
                "type": "string"
              }
            },
            "required": [
              "upgrade_id"
            ]
          },
          {
            "properties": {
              "purchase_id": {
                "type": "null"
              },
              "upgrade_id": {
                "type": "null"
              }
            },
            "required": [
              "amount",
              "currency"
            ]
          }
        ],
        "properties": {
          "amount": {
            "description": "শুধু ওয়ালেট টপ-আপে প্রয়োজন। কনফিগার সীমার মধ্যে দশমিক প্রদর্শন অর্থ। পরিষেবা অর্ডার ক্লায়েন্টের অর্থ প্রত্যাখ্যান করে।",
            "pattern": "^\\d+(?:\\.\\d{1,2})?$",
            "type": "string"
          },
          "currency": {
            "description": "শুধু ওয়ালেট টপ-আপে প্রয়োজন এবং এই প্রদানকারীর জন্য সক্ষম হতে হবে।",
            "type": "string"
          },
          "overage_accepted": {
            "description": "প্রদর্শিত চার্জযোগ্য অতিরিক্ত ব্যবহারের পৃথক স্পষ্ট অনুমোদন।",
            "type": "boolean"
          },
          "policy_version": {
            "description": "বর্তমানে প্রকাশিত অপরিবর্তনীয় নীতি সংস্করণ। অপারেটর নীতি প্রকাশের পর উভয় পেমেন্ট পরিবেশে সম্মতি-সুরক্ষিত কাজে প্রয়োজন।",
            "type": "string"
          },
          "purchase_id": {
            "anyOf": [
              {
                "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "বিদ্যমান অপেক্ষমাণ পরিষেবা ক্রয় বা নবায়ন; upgrade_id-এর সঙ্গে পারস্পরিকভাবে একচেটিয়া।"
          },
          "request_id": {
            "description": "স্থির কলার-তৈরি অনুরোধ কী। রিপ্লে মূল চেকআউট ফেরত দেয়।",
            "maxLength": 80,
            "type": "string"
          },
          "terms_accepted": {
            "description": "স্পষ্ট সম্মতি, ডিফল্টে অনির্বাচিত।",
            "type": "boolean"
          },
          "upgrade_id": {
            "anyOf": [
              {
                "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "বিদ্যমান অপেক্ষমাণ আপগ্রেড কোট; purchase_id-এর সঙ্গে পারস্পরিকভাবে একচেটিয়া।"
          }
        },
        "required": [
          "request_id"
        ],
        "type": "object"
      },
      "WaffoOrderList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "items",
            "items": {
              "$ref": "#/components/schemas/WaffoOrder"
            },
            "type": "array"
          },
          "total": {
            "description": "ক্ষুদ্রতম মুদ্রা এককে স্থির পূর্ণ পরিষেবা মূল্য; ওয়ালেট রিচার্জ বা মিশ্র পেমেন্ট নয়।",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total"
        ],
        "type": "object"
      },
      "WaffoOrderResult": {
        "additionalProperties": false,
        "properties": {
          "approval_url": {
            "description": "স্বল্পমেয়াদি প্রমাণীকৃত চেকআউট URL, বা পেমেন্ট, মেয়াদ শেষ বা চ্যানেল নিষ্ক্রিয়ের পরে ফাঁকা। কখনো লগ বা ক্যাশ করবেন না।",
            "type": "string"
          },
          "order": {
            "$ref": "#/components/schemas/WaffoOrder",
            "description": "অর্ডার"
          },
          "return_url": {
            "description": "টপ-আপে ওয়ালেট ড্যাশবোর্ড URL, পরিষেবা পেমেন্টে মূল্য মিলন URL। শুধু রিটার্ন URL কখনো পেমেন্টের প্রমাণ নয়।",
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "order",
          "approval_url",
          "return_url"
        ],
        "type": "object"
      },
      "WaffoSettings": {
        "additionalProperties": false,
        "properties": {
          "currencies": {
            "description": "currencies",
            "items": {
              "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
              "type": "string"
            },
            "type": "array"
          },
          "enabled": {
            "description": "চালু",
            "type": "boolean"
          },
          "maximum_cents": {
            "description": "ক্ষুদ্র মুদ্রা এককে সর্বোচ্চ ওয়ালেট টপ-আপ; ডিফল্ট 100000 এবং minimum_cents-এর কম হবে না।",
            "maximum": 100000000,
            "minimum": 1,
            "type": "integer"
          },
          "merchant_id": {
            "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
            "type": "string"
          },
          "minimum_cents": {
            "description": "ক্ষুদ্র মুদ্রা এককে সর্বনিম্ন ওয়ালেট টপ-আপ; ডিফল্ট 100।",
            "maximum": 100000000,
            "minimum": 1,
            "type": "integer"
          },
          "mode": {
            "description": "পেমেন্ট পরিবেশ। Sandbox ও live রেকর্ড বিচ্ছিন্ন।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "private_key_configured": {
            "description": "চালু",
            "type": "boolean"
          },
          "product_id": {
            "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
            "type": "string"
          },
          "store_id": {
            "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
            "type": "string"
          },
          "version": {
            "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
            "type": "string"
          },
          "webhook_public_key": {
            "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
            "type": "string"
          },
          "webhook_url": {
            "description": "Webhook ঠিকানা",
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "enabled",
          "mode",
          "merchant_id",
          "store_id",
          "product_id",
          "currencies",
          "private_key_configured",
          "webhook_public_key",
          "version",
          "webhook_url"
        ],
        "type": "object"
      },
      "WaffoSettingsInput": {
        "additionalProperties": false,
        "properties": {
          "clear_private_key": {
            "description": "চালু",
            "type": "boolean"
          },
          "currencies": {
            "description": "currencies",
            "items": {
              "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
              "type": "string"
            },
            "type": "array"
          },
          "enabled": {
            "description": "চালু",
            "type": "boolean"
          },
          "expected_version": {
            "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
            "type": "string"
          },
          "maximum_cents": {
            "description": "ক্ষুদ্র মুদ্রা এককে সর্বোচ্চ ওয়ালেট টপ-আপ; ডিফল্ট 100000 এবং minimum_cents-এর কম হবে না।",
            "maximum": 100000000,
            "minimum": 1,
            "type": "integer"
          },
          "merchant_id": {
            "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
            "type": "string"
          },
          "minimum_cents": {
            "description": "ক্ষুদ্র মুদ্রা এককে সর্বনিম্ন ওয়ালেট টপ-আপ; ডিফল্ট 100।",
            "maximum": 100000000,
            "minimum": 1,
            "type": "integer"
          },
          "mode": {
            "description": "পেমেন্ট পরিবেশ। Sandbox ও live রেকর্ড বিচ্ছিন্ন।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "private_key": {
            "description": "RSA স্বাক্ষরের ব্যক্তিগত কী। সংরক্ষণে এনক্রিপ্টেড; ফাঁকা মান সংরক্ষিত কী রাখে।",
            "maxLength": 8192,
            "type": "string",
            "writeOnly": true
          },
          "product_id": {
            "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
            "type": "string"
          },
          "store_id": {
            "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
            "type": "string"
          },
          "webhook_public_key": {
            "description": "ঐচ্ছিক অফিসিয়াল ওয়েবহুক পাবলিক কী ওভাররাইড। ফাঁকা হলে নির্বাচিত পরিবেশের SDK কী ব্যবহৃত হয়।",
            "maxLength": 8192,
            "type": "string"
          }
        },
        "required": [
          "enabled",
          "mode",
          "merchant_id",
          "store_id",
          "product_id",
          "currencies",
          "expected_version"
        ],
        "type": "object"
      },
      "WaffoWebhookEvent": {
        "description": "কাঁচা Waffo ইভেন্ট X-Waffo-Signature, নির্বাচিত পরিবেশের পাবলিক কী, store ও mode দিয়ে প্রমাণীকৃত। পেমেন্ট/রিফান্ড API দিয়ে স্বাধীনভাবে যাচাই হয়।",
        "type": "object"
      },
      "Wallet": {
        "additionalProperties": false,
        "properties": {
          "balance_cents": {
            "description": "ওয়ালেট ব্যালেন্স বা এন্ট্রির পর ব্যালেন্স, শতভাগে।",
            "type": "integer"
          },
          "currency": {
            "description": "তিন অক্ষরের বড় হাতের মুদ্রা কোড, যেমন USD।",
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "WalletEntry": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "description": "শতভাগে অর্থ; লেজার এন্ট্রি ধনাত্মক ক্রেডিট বা ঋণাত্মক ডেবিট হতে পারে।",
            "type": "integer"
          },
          "balance_cents": {
            "description": "ওয়ালেট ব্যালেন্স বা এন্ট্রির পর ব্যালেন্স, শতভাগে।",
            "type": "integer"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "description": "তিন অক্ষরের বড় হাতের মুদ্রা কোড, যেমন USD।",
            "pattern": "^[A-Z]{3}$",
            "type": "string"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "kind": {
            "description": "plan_upgrade পরিশোধিত আপগ্রেড রেকর্ড করে। paypal_refund_reserve উপলব্ধ ওয়ালেট অর্থ আটকে রাখে; paypal_refund_release সেই হোল্ড সরায়; paypal_refund নিশ্চিত নগদ রিফান্ড রেকর্ড করে। সংরক্ষণ/রিলিজ লেনদেন নগদ পেমেন্ট নয় এবং নিষ্পত্তি সম্পন্ন হলে পরস্পর বাতিল হয়।",
            "type": "string"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "reference": {
            "description": "ট্রেসিংয়ের জন্য সংশ্লিষ্ট ব্যবসায়িক রেফারেন্স।",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "WalletEntryList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/WalletEntry"
            },
            "type": "array"
          },
          "limit": {
            "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
            "type": "integer"
          },
          "offset": {
            "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
            "type": "integer"
          },
          "total": {
            "description": "মোট মিল রেকর্ড, বর্তমান পৃষ্ঠার দৈর্ঘ্য নয়।",
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "WalletRefundRequest": {
        "additionalProperties": false,
        "properties": {
          "amount_cents": {
            "minimum": 1,
            "type": "integer"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "customer_email": {
            "description": "শুধু প্রশাসক তালিকা।",
            "type": "string"
          },
          "decision": {
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "order_id": {
            "format": "uuid",
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "refund_id": {
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          },
          "refund_status": {
            "type": "string"
          },
          "request_id": {
            "format": "uuid",
            "type": "string"
          },
          "review_status": {
            "enum": [
              "pending",
              "approved",
              "declined",
              "cancelled"
            ],
            "type": "string"
          },
          "reviewed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "enum": [
              "pending_review",
              "refund_pending",
              "refunded",
              "refund_failed",
              "declined",
              "cancelled"
            ],
            "type": "string"
          },
          "tenant_name": {
            "description": "শুধু প্রশাসক তালিকা।",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "order_id",
          "mode",
          "currency",
          "amount_cents",
          "reason",
          "status",
          "review_status"
        ],
        "type": "object"
      },
      "WalletRefundRequestInput": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "description": "ধনাত্মক অর্থ, অপরিফান্ড অর্ডার মূল্য ও বর্তমান অব্যবহৃত ওয়ালেট ক্রেডিট উভয় দ্বারা সীমিত।",
            "pattern": "^[0-9]+(?:\\.[0-9]{1,2})?$",
            "type": "string"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "reason": {
            "maxLength": 255,
            "minLength": 1,
            "type": "string"
          },
          "request_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "amount",
          "reason",
          "request_id",
          "mode"
        ],
        "type": "object"
      },
      "WalletRefundRequestList": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/WalletRefundRequest"
            },
            "type": "array"
          },
          "limit": {
            "type": "integer"
          },
          "mode": {
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "offset": {
            "type": "integer"
          },
          "total": {
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total",
          "mode"
        ],
        "type": "object"
      },
      "WalletRefundReview": {
        "additionalProperties": false,
        "properties": {
          "approve": {
            "type": "boolean"
          },
          "decision": {
            "maxLength": 1000,
            "minLength": 1,
            "type": "string"
          },
          "expected_updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "approve",
          "decision"
        ],
        "type": "object"
      },
      "WalletResult": {
        "additionalProperties": false,
        "properties": {
          "currencies": {
            "description": "এই পরিবেশে অনুমোদিত মুদ্রা কোড।",
            "items": {
              "pattern": "^[A-Z]{3}$",
              "type": "string"
            },
            "type": "array"
          },
          "items": {
            "description": "ফেরত দেওয়া রেকর্ড; উপাদান ফিল্ডের জন্য items[] দেখুন। কিছু ফাঁকা সংগ্রহ null হতে পারে; ধরন দেখুন।",
            "items": {
              "$ref": "#/components/schemas/Wallet"
            },
            "type": "array"
          },
          "maximum_cents": {
            "description": "সক্ষম ওয়ালেট টপ-আপ চ্যানেলের সর্বোচ্চ রিচার্জ, ক্ষুদ্র মুদ্রা এককে।",
            "type": "integer"
          },
          "minimum_cents": {
            "description": "সক্ষম ওয়ালেট টপ-আপ চ্যানেলের সর্বনিম্ন রিচার্জ, ক্ষুদ্র মুদ্রা এককে।",
            "type": "integer"
          },
          "mode": {
            "description": "লাইসেন্স মেয়াদ: perpetual, timed বা trial; বিলিং অবজেক্ট sandbox বা live পেমেন্ট মোড ব্যবহার করে।",
            "enum": [
              "sandbox",
              "live"
            ],
            "type": "string"
          },
          "payment_channels": {
            "description": "উপলব্ধ পেমেন্ট চ্যানেল কনফিগারেশন। সক্রিয় বিলিং পরিবেশ ও ক্রয় মুদ্রার সঙ্গে মেলে শুধু এমন সক্ষম চ্যানেল দেখান।",
            "items": {
              "$ref": "#/components/schemas/PaymentChannel"
            },
            "type": "array"
          },
          "paypal_enabled": {
            "description": "এই পেমেন্ট পরিবেশে PayPal সক্ষম কি না।",
            "type": "boolean"
          }
        },
        "required": [],
        "type": "object"
      },
      "WebhookAttempt": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "delivery_id": {
            "description": "এই প্রচেষ্টার ডেলিভারি কাজের UUID।",
            "format": "uuid",
            "type": "string"
          },
          "duration_ms": {
            "description": "ডেলিভারি সময় মিলিসেকেন্ডে।",
            "type": "integer"
          },
          "error": {
            "description": "ত্রুটি অবজেক্ট বা ডেলিভারি ব্যর্থতার শ্রেণি; চাইল্ড ফিল্ড বা বর্তমান ধরন দেখুন।",
            "type": "string"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "number": {
            "description": "ক্রমসঞ্চিত প্রচেষ্টা ক্রমসংখ্যা।",
            "type": "integer"
          },
          "status_code": {
            "description": "এই প্রচেষ্টার HTTP অবস্থা; ট্রান্সপোর্ট ব্যর্থতায় 0 হতে পারে।",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "delivery_id",
          "number",
          "status_code",
          "error",
          "duration_ms",
          "created_at"
        ],
        "type": "object"
      },
      "WebhookDelivery": {
        "additionalProperties": false,
        "properties": {
          "attempts": {
            "description": "কাজের প্রচেষ্টার ক্রমসঞ্চিত সংখ্যা।",
            "type": "integer"
          },
          "available_at": {
            "description": "কাজ চালানোর সর্বপ্রথম UTC সময়।",
            "format": "date-time",
            "type": "string"
          },
          "created_at": {
            "description": "UTC-তে তৈরির সময়; অফলাইন অনুরোধ Unix সেকেন্ড ব্যবহার করে।",
            "format": "date-time",
            "type": "string"
          },
          "delivered_at": {
            "anyOf": [
              {
                "description": "সফল ডেলিভারি টাইমস্ট্যাম্প, বা null।",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "সফল ডেলিভারি টাইমস্ট্যাম্প, বা null।",
                "type": "null"
              }
            ],
            "description": "সফল ডেলিভারি টাইমস্ট্যাম্প, বা null।"
          },
          "endpoint_id": {
            "description": "ওয়েবহুক এন্ডপয়েন্ট UUID।",
            "format": "uuid",
            "type": "string"
          },
          "event_id": {
            "description": "মূল ইভেন্ট UUID; গ্রহীতার ডুপ্লিকেট নিয়ন্ত্রণে ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "id": {
            "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
            "format": "uuid",
            "type": "string"
          },
          "last_error": {
            "description": "সর্বশেষ ব্যর্থতার শ্রেণি; ফাঁকা হতে পারে।",
            "type": "string"
          },
          "last_status": {
            "description": "সর্বশেষ HTTP প্রতিক্রিয়া অবস্থা; প্রতিক্রিয়া না এলে 0 হতে পারে।",
            "type": "integer"
          },
          "status": {
            "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
            "type": "string"
          }
        },
        "required": [
          "id",
          "endpoint_id",
          "event_id",
          "status",
          "attempts",
          "available_at",
          "last_status",
          "last_error",
          "delivered_at",
          "created_at"
        ],
        "type": "object"
      },
      "WebhookEvent": {
        "description": "সঠিক স্বাক্ষরিত PayPal ইভেন্ট, PayPal API দিয়ে যাচাইকৃত",
        "type": "object"
      },
      "WebhookReceived": {
        "additionalProperties": false,
        "properties": {
          "ignored": {
            "type": "boolean"
          },
          "received": {
            "type": "boolean"
          }
        },
        "required": [],
        "type": "object"
      }
    },
    "securitySchemes": {
      "closureExport": {
        "description": "সীমিত 15-মিনিট ডাউনলোড ক্রেডেনশিয়াল, ড্যাশবোর্ড সেশন নয়। উৎপাদনে __Host-licentivo_closure_export ব্যবহৃত হয়; সর্বদা মূল বন্ধের সময়সীমায় সীমিত।",
        "in": "cookie",
        "name": "licentivo_closure_export",
        "type": "apiKey"
      },
      "customerSession": {
        "description": "উৎপাদনে __Host-licenova_customer ব্যবহৃত হয়; ক্রেতার পরিচয় বিক্রেতা সেশন থেকে স্বাধীন।",
        "in": "cookie",
        "name": "licenova_customer",
        "type": "apiKey"
      },
      "managementKey": {
        "bearerFormat": "lv_api_...",
        "scheme": "bearer",
        "type": "http"
      },
      "session": {
        "description": "উৎপাদনে __Host-licenova_session ব্যবহৃত হয়",
        "in": "cookie",
        "name": "licenova_session",
        "type": "apiKey"
      }
    }
  },
  "info": {
    "description": "Licentivo ব্যবস্থাপনা ও লাইসেন্সিং API। স্বাক্ষরিত রানটাইম গ্রান্ট, নোড-লক ও ফ্লোটিং লাইসেন্স, বর্তমান অ্যাক্টিভেশন ডিভাইস কোটা, মাসিক API ব্যবহার, পরিমাপকৃত সফটওয়্যার ফিচার, Launch অ্যাকাউন্ট সেশন, প্রিপেইড প্যাকেজ, উপহার, ওয়ালেট স্বয়ংক্রিয় নবায়ন ও সম্পূর্ণ কভারেজ আপগ্রেড সমর্থন করে। PayPal, Paddle ও Waffo যাচাইকৃত পেমেন্ট ও মূল মাধ্যমে রিফান্ড সমর্থন করে। গ্রাহক নীতি, অনুমোদন-সীমার বাতিল, সহায়তা, ক্ষতিপূরণ, ডেটা এক্সপোর্ট ও যৌক্তিক অ্যাকাউন্ট বন্ধ অন্তর্ভুক্ত। পেমেন্ট পরিবেশ ও মুদ্রা বিচ্ছিন্ন; ব্যক্তিগত ক্রেডেনশিয়াল এনক্রিপ্টেড এবং কখনো ফেরত দেওয়া হয় না।",
    "title": "Licentivo API",
    "version": "0.12.0",
    "x-document-language": "bn"
  },
  "openapi": "3.1.0",
  "paths": {
    "/api/v1/account/closure-export.zip": {
      "get": {
        "description": "প্রতিটি অনুরোধে ও তৈরি হওয়ার পর ক্রেডেনশিয়াল এবং মূল বন্ধের সময়সীমা আবার যাচাই হয়। ব্যাকআপ পুনরুদ্ধারে সময়সীমা আবার শুরু হয় না।",
        "operationId": "get__api_v1_account_closure_export_zip",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/zip": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "closureExport": []
          }
        ],
        "summary": "30 দিনের বন্ধকরণ সময়ে ডাউনলোড করুন"
      }
    },
    "/api/v1/account/closure-export/session": {
      "post": {
        "description": "যাচাইকৃত মূল ইমেইল/পাসওয়ার্ড ও নিশ্চিত বন্ধকরণ ঠিক 30 দিনের মধ্যে থাকতে হবে। 15-মিনিট cookie মূল সময়সীমায় সীমিত, রেট সীমিত এবং সাধারণ API/dashboard প্রবেশ অনুমোদন করতে পারে না।",
        "operationId": "post__api_v1_account_closure_export_session",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ClosureExportLogin"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ClosureExportCredential"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [],
        "summary": "সীমিত এক্সপোর্টের জন্য বন্ধ অ্যাকাউন্ট যাচাই করুন"
      }
    },
    "/api/v1/account/data-export": {
      "get": {
        "description": "Owner ডাউনলোডে ওয়ার্কস্পেস ব্যবসায়িক CSV থাকে। সদস্যের ব্যক্তিগত আর্কাইভে নিজের প্রোফাইল, পোস্ট ও অনুরোধ থাকে। ক্রেডেনশিয়াল গোপন মান/হ্যাশ ও স্বাক্ষরের ব্যক্তিগত কী বাদ।",
        "operationId": "get__api_v1_account_data_export",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/zip": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "নিজের ব্যক্তিগত ও অনুমোদিত ডেটা ডাউনলোড করুন",
        "x-required-role": "session"
      }
    },
    "/api/v1/account/deletions": {
      "get": {
        "description": "",
        "operationId": "get__api_v1_account_deletions",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/AccountClosureList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "নিজের যৌক্তিক বন্ধের অনুরোধ পড়ুন",
        "x-required-role": "session"
      },
      "post": {
        "description": "Owner বন্ধে ওয়ার্কস্পেস নির্বাচন আবশ্যক; সদস্য শুধু নিজের অ্যাকাউন্ট বন্ধ করতে পারেন। নিশ্চিতকরণ সেশন/API কী প্রত্যাহার করে কিন্তু ডেটা রাখে। নিশ্চিতকরণের পর 30 দিন এক্সপোর্ট অনুমত।",
        "operationId": "post__api_v1_account_deletions",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountClosureInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/AccountClosure"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "অ্যাকাউন্ট বা ওয়ার্কস্পেস যৌক্তিকভাবে বন্ধের অনুরোধ করুন",
        "x-required-role": "session"
      }
    },
    "/api/v1/account/deletions/{id}/cancel": {
      "post": {
        "description": "",
        "operationId": "post__api_v1_account_deletions__id__cancel",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CommerceResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "অনিশ্চিত বন্ধকরণ প্রত্যাহার করুন",
        "x-required-role": "session"
      }
    },
    "/api/v1/account/legal-acceptances": {
      "get": {
        "description": "",
        "operationId": "get__api_v1_account_legal_acceptances",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LegalAcceptanceList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "নিজের আইনি সম্মতির রসিদ পড়ুন",
        "x-required-role": "session"
      }
    },
    "/api/v1/account/profile": {
      "patch": {
        "description": "বর্তমান পাসওয়ার্ড প্রয়োজন। নতুন লগইন ইমেইলে একবার ব্যবহারযোগ্য যাচাই লিঙ্ক যায়, 30 মিনিট বৈধ। নিশ্চিত না হওয়া পর্যন্ত বর্তমান যাচাইকৃত লগইন ইমেইল ও প্রবেশ অপরিবর্তিত থাকে।",
        "operationId": "patch__api_v1_account_profile",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountCorrection"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CommerceResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "নিজের নাম সংশোধন বা লগইন ইমেইল পরিবর্তনের অনুরোধ করুন",
        "x-required-role": "session"
      }
    },
    "/api/v1/activate": {
      "post": {
        "description": "product_id + license_key + device_id দিয়ে প্রমাণীকৃত। cookie/CSRF/vendor key নেই। activate ছাড়া activation_id প্রয়োজন। প্রতিটি সফল অনুরোধ একটি API কল খরচ করে; idempotent রিপ্লে ও ব্যর্থতা করে না। অতিরিক্ত ব্যবহার ওয়ালেট থেকে পরমাণুভাবে ডেবিট হয় অথবা API_QUOTA_EXCEEDED/API_BALANCE_INSUFFICIENT ফেরত দেয়। ওয়ার্কস্পেস ডিভাইস কোটা বর্তমান অ্যাক্টিভেশন অনুসরণ করে। রিলিজ ক্ষমতা ফেরত দেয়; ফ্লোটিং লিজের মেয়াদ শেষেও ক্ষমতা ফেরে, তবে অফলাইন সাধারণ নিবন্ধন গণনায় থাকে। কোটা-মাসের বিলিং শীর্ষ ইতিমধ্যে পরিশোধিত ক্ষমতা ছাড়ালেই কেবল ডিভাইস অতিরিক্ত ব্যবহারের চার্জ হয়; রিলিজে আগের চার্জ ফেরত হয় না। API ব্যবহার আলাদা।",
        "operationId": "post_api_v1_activate",
        "parameters": [
          {
            "description": "প্রতিটি কাজের জন্য নতুন কী তৈরি করুন; পুনঃপ্রচেষ্টায় একই কী ও বডি রাখুন। সর্বাধিক 80 অক্ষর, শূন্যস্থান নয়। যাচাই ও heartbeat-এর জন্য ঐচ্ছিক।",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 80,
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RuntimeInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/RuntimeResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "রানটাইম অ্যাক্টিভেট"
      }
    },
    "/api/v1/activations": {
      "get": {
        "operationId": "get_api_v1_activations",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "license_id",
            "schema": {
              "description": "লাইসেন্স UUID, lv_lic_ গোপন মান থেকে আলাদা।",
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "product_id",
            "schema": {
              "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "status",
            "schema": {
              "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
              "enum": [
                "active",
                "released"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "q",
            "schema": {
              "description": "অনুসন্ধান পাঠ্য; লক্ষ্য ফিল্ড ও সর্বাধিক দৈর্ঘ্য কাজের ওপর নির্ভর করে।",
              "maxLength": 120,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "created_at": "2026-10-18T00:00:00Z",
                        "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                        "device_name": "Office PC",
                        "generation": 1,
                        "id": "44444444-4444-4444-8444-444444444444",
                        "last_seen_at": "2026-10-18T00:00:00Z",
                        "license_id": "33333333-3333-4333-8333-333333333333",
                        "product_id": "11111111-1111-4111-8111-111111111111",
                        "released_at": null,
                        "status": "active",
                        "virtual_machine": false
                      }
                    ],
                    "limit": 25,
                    "offset": 0,
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ActivationList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "অ্যাক্টিভেশন তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "devices"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/activations/{id}/release": {
      "post": {
        "operationId": "post_api_v1_activations_by_id_release",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "expected_generation": 1,
                "operation_id": "11111111-1111-4111-8111-111111111111"
              },
              "schema": {
                "$ref": "#/components/schemas/VersionedActivationReleaseInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333",
                    "status": "released"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/StateResult",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "অ্যাক্টিভেশন রিলিজ করুন",
        "x-management-reference": {
          "group": "devices"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/api-keys": {
      "get": {
        "operationId": "get_api_v1_api-keys",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "allow_http": false,
                        "created_at": "2026-10-18T00:00:00Z",
                        "expires_at": "2026-10-18T00:00:00Z",
                        "id": "33333333-3333-4333-8333-333333333333",
                        "name": "Report app",
                        "prefix": "lv_api_AAAAAAA",
                        "revoked": false,
                        "scope": "read"
                      }
                    ],
                    "limit": 25,
                    "offset": 0,
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/KeyList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "API কী তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "keys"
        },
        "x-required-role": "owner",
        "x-required-scope": "owner_session"
      },
      "post": {
        "operationId": "post_api_v1_api-keys",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "description": "cookie-প্রমাণীকৃত লেখার জন্য প্রয়োজন; GET /api/v1/auth/csrf থেকে data.csrf_token নিয়ে cookies রাখুন।",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "allow_http": false,
                "expires_days": 90,
                "name": "Order system",
                "scope": "write"
              },
              "schema": {
                "$ref": "#/components/schemas/KeyCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "expires_at": "2027-01-16T00:00:00Z",
                    "id": "33333333-3333-4333-8333-333333333333",
                    "key": "lv_api_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
                    "prefix": "lv_api_AAAAAAA"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/KeySecret",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "API কী তৈরি",
        "x-management-reference": {
          "group": "keys"
        },
        "x-required-role": "owner",
        "x-required-scope": "owner_session"
      }
    },
    "/api/v1/api-keys/{id}": {
      "delete": {
        "operationId": "delete_api_v1_api-keys_by_id",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "description": "cookie-প্রমাণীকৃত লেখার জন্য প্রয়োজন; GET /api/v1/auth/csrf থেকে data.csrf_token নিয়ে cookies রাখুন।",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ID",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "API কী বাতিল",
        "x-management-reference": {
          "group": "keys"
        },
        "x-required-role": "owner",
        "x-required-scope": "owner_session"
      },
      "patch": {
        "description": "Owner সেশন ও CSRF টোকেন প্রয়োজন। শুধু এই সক্রিয় কী আপডেট করে; রোটেশনে সেটিং থাকে। বিদ্যমান Launch সংযোগ বা রানটাইম গ্রান্ট বদলায় না। এই সেটিং Licentivo API-তে HTTP সক্ষম করে না।",
        "operationId": "patch_api_v1_api-keys_by_id",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "description": "cookie-প্রমাণীকৃত লেখার জন্য প্রয়োজন; GET /api/v1/auth/csrf থেকে data.csrf_token নিয়ে cookies রাখুন।",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "allow_http": true
              },
              "schema": {
                "$ref": "#/components/schemas/KeyUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "allow_http": false,
                    "id": "33333333-3333-4333-8333-333333333333"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/KeyUpdated",
                      "description": "Response data for the completed operation."
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সাইটের HTTP প্রবেশাধিকার হালনাগাদ করুন",
        "x-management-reference": {
          "group": "keys"
        },
        "x-required-role": "owner",
        "x-required-scope": "owner_session"
      }
    },
    "/api/v1/api-keys/{id}/rotate": {
      "post": {
        "operationId": "post_api_v1_api-keys_by_id_rotate",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "description": "cookie-প্রমাণীকৃত লেখার জন্য প্রয়োজন; GET /api/v1/auth/csrf থেকে data.csrf_token নিয়ে cookies রাখুন।",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {},
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333",
                    "key": "lv_api_BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB",
                    "prefix": "lv_api_BBBBBBB"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/KeyRotated",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "API কী পরিবর্তন",
        "x-management-reference": {
          "group": "keys"
        },
        "x-required-role": "owner",
        "x-required-scope": "owner_session"
      }
    },
    "/api/v1/audit-logs": {
      "get": {
        "operationId": "get_api_v1_audit-logs",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "action": "license.create",
                        "actor_id": "33333333-3333-4333-8333-333333333333",
                        "actor_kind": "api_key",
                        "created_at": "2026-10-18T00:00:00Z",
                        "id": "33333333-3333-4333-8333-333333333333",
                        "request_id": "55555555-5555-4555-8555-555555555555",
                        "resource_id": ""
                      }
                    ],
                    "limit": 25,
                    "offset": 0
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/AuditList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "অডিট লগ তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "usage"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/auth/accept-invitation": {
      "post": {
        "operationId": "post_api_v1_auth_accept-invitation",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TokenPassword"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PasswordSet"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "accept-invitation"
      }
    },
    "/api/v1/auth/change-password": {
      "post": {
        "operationId": "post_api_v1_auth_change-password",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangePassword"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PasswordSet"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "অ্যাকাউন্টের সব ক্রেডেনশিয়াল প্রত্যাহার করে পাসওয়ার্ড সেট করুন"
      }
    },
    "/api/v1/auth/confirm-email-change": {
      "post": {
        "description": "এনক্রিপ্টেড একবার ব্যবহারযোগ্য চ্যালেঞ্জ যাচাই করুন। শুধু সফল নিশ্চিতকরণ লগইন ইমেইল বদলে যাচাই করে এবং বিদ্যমান সেশন, API কী ও প্রমাণীকরণ লিঙ্ক প্রত্যাহার করে। মেয়াদোত্তীর্ণ, প্রতিস্থাপিত বা পাসওয়ার্ডে অবৈধ চ্যালেঞ্জ অ্যাকাউন্ট বদলাতে পারে না।",
        "operationId": "post__api_v1_auth_confirm_email_change",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EmailChangeConfirmation"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CommerceResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [],
        "summary": "নতুন লগইন ইমেইল নিশ্চিত করুন"
      }
    },
    "/api/v1/auth/csrf": {
      "get": {
        "operationId": "get_api_v1_auth_csrf",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CSRF"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "সেশনে বাঁধা CSRF টোকেন ইস্যু করুন"
      }
    },
    "/api/v1/auth/forgot-password": {
      "post": {
        "operationId": "post_api_v1_auth_forgot-password",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Email"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Notice"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "forgot-password"
      }
    },
    "/api/v1/auth/login": {
      "post": {
        "operationId": "post_api_v1_auth_login",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Login"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CSRF"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "login"
      }
    },
    "/api/v1/auth/logout": {
      "post": {
        "operationId": "post_api_v1_auth_logout",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LoggedOut"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "বর্তমান সেশন প্রত্যাহার করুন"
      }
    },
    "/api/v1/auth/me": {
      "get": {
        "operationId": "get_api_v1_auth_me",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Me"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "বর্তমান cookie অ্যাকাউন্ট"
      }
    },
    "/api/v1/auth/register": {
      "post": {
        "description": "প্রকাশিত শর্তে যেকোনো পেমেন্ট পরিবেশে policy_version ও স্পষ্ট সম্মতি প্রয়োজন। চার্জযোগ্য পরিষেবা অতিরিক্ত ব্যবহারে overage_accepted-ও প্রয়োজন। প্রথম নীতি প্রকাশের আগে খসড়ার সম্মতি রেকর্ড হয় না এবং প্রতিটি কাজ স্বাভাবিক নিবন্ধন, মূল্য ও পেমেন্ট পরীক্ষা অনুসরণ করে।",
        "operationId": "post_api_v1_auth_register",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Register"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Notice"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "register"
      }
    },
    "/api/v1/auth/resend-verification": {
      "post": {
        "operationId": "post_api_v1_auth_resend-verification",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Email"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Notice"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "resend-verification"
      }
    },
    "/api/v1/auth/reset-password": {
      "post": {
        "operationId": "post_api_v1_auth_reset-password",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TokenPassword"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PasswordSet"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "reset-password"
      }
    },
    "/api/v1/auth/verify-email": {
      "post": {
        "operationId": "post_api_v1_auth_verify-email",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Token"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Verified"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "verify-email"
      }
    },
    "/api/v1/billing/auto-renewal": {
      "get": {
        "description": "শুধু সেশন। PATCH-এর জন্য ওয়ার্কস্পেস Owner প্রয়োজন। ডিফল্ট অক্ষম। সক্ষম করতে বর্তমান মোড ও মুদ্রায় এক নবায়নের পর্যাপ্ত ব্যালেন্স এবং পর্যালোচিত সর্বশেষ পরিশোধিত প্ল্যান, প্রস্তাবিত মেয়াদ ও মূল্য সংস্করণ প্রয়োজন। মেয়াদ শেষে শুধু ওয়ালেট অর্থ থেকে চার্জ হয়, PayPal বা কার্ড থেকে কখনো নয়। মিনিটে চলা ওয়ার্কার ও রানটাইম মিউটেশন টেন্যান্ট লকের অধীনে প্রাপ্য নবায়ন প্রক্রিয়া করে। বারবার প্রচেষ্টায় একবার চার্জ হয়। অর্থ অপর্যাপ্ত হলে রিচার্জের অপেক্ষা; মূল্য, প্ল্যান বা উপলব্ধতা বদলালে নতুন সম্মতি পর্যন্ত চার্জ স্থগিত। নিষ্ক্রিয় করলে ভবিষ্যৎ স্বয়ংক্রিয় চার্জ বাতিল হয়, পরিশোধিত কভারেজ নয়।",
        "operationId": "get_api_v1_billing_auto_renewal",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "next_renewal_at": null,
                    "setting": {
                      "amount_cents": 0,
                      "currency": "USD",
                      "enabled": true,
                      "mode": "sandbox",
                      "plan": "starter",
                      "plan_name": "Starter",
                      "policy_version": "",
                      "price_version": "example-v1",
                      "status": "disabled",
                      "term_months": 1,
                      "updated_at": "2026-10-18T00:00:00Z",
                      "version": ""
                    }
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/AutoRenewalResult",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "DEFAULT_PLAN_DISABLED",
                    "message": "The default allowance plan has not been enabled by the administrator"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "স্বয়ংক্রিয় নবায়ন সেটিং পড়ুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-scope": "read"
      },
      "patch": {
        "description": "শুধু সেশন। PATCH-এর জন্য ওয়ার্কস্পেস Owner প্রয়োজন। ডিফল্ট অক্ষম। সক্ষম করতে বর্তমান মোড ও মুদ্রায় এক নবায়নের পর্যাপ্ত ব্যালেন্স এবং পর্যালোচিত সর্বশেষ পরিশোধিত প্ল্যান, প্রস্তাবিত মেয়াদ ও মূল্য সংস্করণ প্রয়োজন। মেয়াদ শেষে শুধু ওয়ালেট অর্থ থেকে চার্জ হয়, PayPal বা কার্ড থেকে কখনো নয়। মিনিটে চলা ওয়ার্কার ও রানটাইম মিউটেশন টেন্যান্ট লকের অধীনে প্রাপ্য নবায়ন প্রক্রিয়া করে। বারবার প্রচেষ্টায় একবার চার্জ হয়। অর্থ অপর্যাপ্ত হলে রিচার্জের অপেক্ষা; মূল্য, প্ল্যান বা উপলব্ধতা বদলালে নতুন সম্মতি পর্যন্ত চার্জ স্থগিত। নিষ্ক্রিয় করলে ভবিষ্যৎ স্বয়ংক্রিয় চার্জ বাতিল হয়, পরিশোধিত কভারেজ নয়। প্রকাশিত শর্তে যেকোনো পেমেন্ট পরিবেশে policy_version ও স্পষ্ট সম্মতি প্রয়োজন। চার্জযোগ্য পরিষেবা অতিরিক্ত ব্যবহারে overage_accepted-ও প্রয়োজন। প্রথম নীতি প্রকাশের আগে খসড়ার সম্মতি রেকর্ড হয় না এবং প্রতিটি কাজ স্বাভাবিক নিবন্ধন, মূল্য ও পেমেন্ট পরীক্ষা অনুসরণ করে।",
        "operationId": "patch_api_v1_billing_auto_renewal",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AutoRenewalInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/AutoRenewal"
                    },
                    "request_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "স্পষ্ট সম্মত ওয়ালেট নবায়ন সক্ষম বা অক্ষম করুন"
      }
    },
    "/api/v1/billing/invoices": {
      "get": {
        "operationId": "get_api_v1_billing_invoices",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "month",
            "schema": {
              "description": "UTC মাস YYYY-MM; বাদ দেওয়া কোয়েরি মানে বর্তমান মাস ব্যবহৃত হয়। বিলিং কাজে বন্ধ মাস প্রয়োজন।",
              "pattern": "^[0-9]{4}-[0-9]{2}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "active_devices": 0,
                        "base_covered": false,
                        "base_micros": 0,
                        "created_at": "2026-10-18T00:00:00Z",
                        "currency": "USD",
                        "finalized_at": null,
                        "id": "33333333-3333-4333-8333-333333333333",
                        "included_devices": 0,
                        "month": "2026-09",
                        "overage_devices": 0,
                        "paid_at": null,
                        "payment_mode": "sandbox",
                        "plan": "starter",
                        "plan_name": "Starter",
                        "price_version": "example-v1",
                        "refunded_at": null,
                        "status": "draft",
                        "total_cents": 0,
                        "total_micros": 0,
                        "unit_micros": 0,
                        "voided_at": null
                      }
                    ],
                    "limit": 25,
                    "offset": 0,
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/InvoiceList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ইনভয়েস তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/billing/invoices/{id}": {
      "get": {
        "operationId": "get_api_v1_billing_invoices_by_id",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "active_devices": 0,
                    "base_covered": false,
                    "base_micros": 0,
                    "created_at": "2026-10-18T00:00:00Z",
                    "currency": "USD",
                    "finalized_at": null,
                    "id": "33333333-3333-4333-8333-333333333333",
                    "included_devices": 0,
                    "month": "2026-09",
                    "overage_devices": 0,
                    "paid_at": null,
                    "payment_mode": "sandbox",
                    "plan": "starter",
                    "plan_name": "Starter",
                    "price_version": "example-v1",
                    "refunded_at": null,
                    "status": "draft",
                    "total_cents": 0,
                    "total_micros": 0,
                    "unit_micros": 0,
                    "voided_at": null
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Invoice",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ইনভয়েস পড়ুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/billing/invoices/{id}/export.csv": {
      "get": {
        "operationId": "get_api_v1_billing_invoices_by_id_export_csv",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "text/csv": {
                "example": "invoice_id,month,currency,status,plan,price_version,active_devices,included_devices,overage_devices,base_micros,unit_micros,total_micros,total_cents\n",
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ইনভয়েস এক্সপোর্ট করুন",
        "x-csv-columns": [
          "invoice_id",
          "month",
          "currency",
          "status",
          "plan",
          "price_version",
          "active_devices",
          "included_devices",
          "overage_devices",
          "base_micros",
          "unit_micros",
          "total_micros",
          "total_cents"
        ],
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/billing/invoices/{id}/finalize": {
      "post": {
        "operationId": "post_api_v1_billing_invoices_by_id_finalize",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {},
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333",
                    "status": "finalized"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/StateResult",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ইনভয়েস চূড়ান্ত করুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/billing/invoices/{id}/pay": {
      "post": {
        "description": "নতুন পেমেন্টের আগে বর্তমান নীতির স্পষ্ট সম্মতি প্রয়োজন। ইতিমধ্যে পরিশোধিত রিপ্লে মূল রসিদ বজায় রাখে।",
        "operationId": "post_api_v1_billing_invoices_by_id_pay",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LegalConsent"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Invoice"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "ব্যালেন্স থেকে নিশ্চিত পুরোনো ইনভয়েস পরিশোধ করুন",
        "x-required-role": "owner"
      }
    },
    "/api/v1/billing/invoices/{id}/void": {
      "post": {
        "operationId": "post_api_v1_billing_invoices_by_id_void",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {},
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333",
                    "status": "void"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/StateResult",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "বিল বাতিল",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/billing/jobs": {
      "get": {
        "operationId": "get_api_v1_billing_jobs",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "attempts": 0,
                        "available_at": "2026-10-18T00:00:00Z",
                        "created_at": "2026-10-18T00:00:00Z",
                        "id": "33333333-3333-4333-8333-333333333333",
                        "last_error": "",
                        "month": "2026-09",
                        "status": "pending"
                      }
                    ],
                    "limit": 25,
                    "offset": 0,
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/BillingJobList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "বিলিং কাজ তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-scope": "read"
      },
      "post": {
        "operationId": "post_api_v1_billing_jobs",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "month": "2026-09"
              },
              "schema": {
                "$ref": "#/components/schemas/MonthInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "attempts": 0,
                    "available_at": "2026-10-18T00:00:00Z",
                    "created_at": "2026-10-18T00:00:00Z",
                    "id": "33333333-3333-4333-8333-333333333333",
                    "last_error": "",
                    "month": "2026-09",
                    "status": "pending"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/BillingJob",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "বিলিং কাজ সারিতে দিন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/billing/jobs/{id}/retry": {
      "post": {
        "operationId": "post_api_v1_billing_jobs_by_id_retry",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {},
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333",
                    "status": "pending"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/StateResult",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "বিলিং কাজ পুনঃপ্রচেষ্টা করুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/billing/notification-preferences": {
      "get": {
        "description": "শুধু Owner সেশন; ব্যবস্থাপনা কী প্রত্যাখ্যাত। স্পষ্টভাবে সংরক্ষণ না করা পর্যন্ত চার ধরনের জন্য সক্ষম এবং zh ডিফল্ট। পছন্দ এই ব্যবহারকারী ও ওয়ার্কস্পেসের। প্রমাণীকরণ ইমেইল পরিবহন, প্রেরক, এনক্রিপ্টেড স্থায়ী সারি ও পুনঃপ্রচেষ্টা পুনর্ব্যবহার করে। কোনো ধরনের জন্য প্ল্যাটফর্ম অনুমতি ও প্রাপকের সম্মতি দুটোই প্রয়োজন। ডেলিভারিতে বর্তমান সম্মতি ও ইভেন্ট অবস্থা আবার পরীক্ষা হয়। ইমেইল পছন্দ ওয়ালেট ডেবিটের সম্মতি দেয় বা প্রত্যাহার করে না। Sandbox বার্তা চিহ্নিত। অপরিশোধিত অপেক্ষমাণ ক্রয় বা উপহারের জন্য বিজ্ঞপ্তি তৈরি হয় না।",
        "operationId": "get__api_v1_billing_notification_preferences",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/BillingNotificationPreferencesResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "বর্তমান owner-এর ইমেইল সম্মতি পড়ুন",
        "x-required-role": "owner"
      },
      "patch": {
        "description": "সেশন owner-এর আংশিক আপডেট; অন্য ব্যবহারকারী লক্ষ্য করা যায় না। Locale ভবিষ্যৎ বার্তা নিয়ন্ত্রণ করে। বিদ্যমান যাচাই ও নিরাপত্তা মেইল স্বাধীন থাকে। প্রমাণীকরণ ইমেইল পরিবহন, প্রেরক, এনক্রিপ্টেড স্থায়ী সারি ও পুনঃপ্রচেষ্টা পুনর্ব্যবহার করে। কোনো ধরনের জন্য প্ল্যাটফর্ম অনুমতি ও প্রাপকের সম্মতি দুটোই প্রয়োজন। ডেলিভারিতে বর্তমান সম্মতি ও ইভেন্ট অবস্থা আবার পরীক্ষা হয়। ইমেইল পছন্দ ওয়ালেট ডেবিটের সম্মতি দেয় বা প্রত্যাহার করে না। Sandbox বার্তা চিহ্নিত। অপরিশোধিত অপেক্ষমাণ ক্রয় বা উপহারের জন্য বিজ্ঞপ্তি তৈরি হয় না।",
        "operationId": "patch__api_v1_billing_notification_preferences",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BillingNotificationPreferenceInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/BillingNotificationPreference"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "বর্তমান owner-এর ইমেইল সম্মতি সংরক্ষণ করুন",
        "x-required-role": "owner"
      }
    },
    "/api/v1/billing/overage-consent": {
      "post": {
        "description": "",
        "operationId": "post__api_v1_billing_overage_consent",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CustomerOverageConsent"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CommerceResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "বর্তমান ওয়ালেট অতিরিক্ত ব্যবহার স্পষ্টভাবে অনুমোদন করুন",
        "x-required-role": "owner"
      }
    },
    "/api/v1/billing/overage-settings": {
      "get": {
        "description": "শুধু বর্তমান টেন্যান্ট। শুধু-পঠন সদস্য দেখতে পারেন। সীমাহীন API ভাতা গ্রাহকের অতিরিক্ত ব্যবহার পছন্দ দিয়ে কখনো সীমিত হয় না। null প্ল্যান মানে ডিফল্ট ভাতা উপলব্ধ নয়।",
        "operationId": "get__api_v1_billing_overage_settings",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "customer_api_settings_enabled": false,
                    "customer_device_settings_enabled": false,
                    "plan": null,
                    "preference": {
                      "block_api_overage": false,
                      "block_device_overage": false,
                      "mode": "sandbox",
                      "updated_at": "2026-10-18T00:00:00Z",
                      "version": ""
                    }
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/OverageSettings",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "DEFAULT_PLAN_DISABLED",
                    "message": "The default allowance plan has not been enabled by the administrator"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "অতিরিক্ত ব্যবহার পছন্দ পড়ুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-scope": "read"
      },
      "patch": {
        "description": "শুধু সেশন Owner। প্রতিটি প্রদত্ত পছন্দের জন্য সংশ্লিষ্ট প্রশাসনিক অনুমতি প্রয়োজন; অননুমোদিত ফিল্ড পুরো অনুরোধ 403 দিয়ে প্রত্যাখ্যান করে। রানটাইম কঠোর সীমা = প্রশাসকের সীমা OR গ্রাহকের ব্লক পছন্দ, যখন সেই অনুমতি সক্ষম। অতীত ব্যবহার বা চার্জ মুছে দেয় না। Sandbox ও live পছন্দ স্বাধীন।",
        "operationId": "patch__api_v1_billing_overage_settings",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OverageSettingsInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/OveragePreference"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "স্বাধীন ডিভাইস ও API অতিরিক্ত ব্যবহার পছন্দ সংরক্ষণ করুন"
      }
    },
    "/api/v1/billing/paddle/orders": {
      "get": {
        "operationId": "get__api_v1_billing_paddle_orders",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PaddleOrderList"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "Paddle পরিষেবা পেমেন্ট ও ওয়ালেট টপ-আপ তালিকাভুক্ত করুন",
        "x-licentivo-access": "session"
      },
      "post": {
        "operationId": "post__api_v1_billing_paddle_orders",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PaddleOrderInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PaddleOrderResult"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "একটি Paddle পরিষেবা পেমেন্ট তৈরি বা পুনরুদ্ধার করুন",
        "x-licentivo-access": "owner"
      }
    },
    "/api/v1/billing/paddle/orders/{id}": {
      "get": {
        "operationId": "get__api_v1_billing_paddle_orders__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PaddleOrderResult"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "নিজের চেকআউট লেনদেন ও প্রকাশ্য ক্লায়েন্ট টোকেন পড়ুন",
        "x-licentivo-access": "session"
      }
    },
    "/api/v1/billing/paddle/orders/{id}/reconcile": {
      "post": {
        "operationId": "post__api_v1_billing_paddle_orders__id__reconcile",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PaddleReconcileInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PaddleOrderResult"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "পেমেন্ট যাচাই করে কেনা পরিষেবা একবার সম্পন্ন করুন",
        "x-licentivo-access": "owner"
      }
    },
    "/api/v1/billing/paypal/orders": {
      "get": {
        "operationId": "get_api_v1_billing_paypal_orders",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "amount_cents": 0,
                        "approval_url": "",
                        "capture_id": null,
                        "created_at": "2026-10-18T00:00:00Z",
                        "credited_at": null,
                        "currency": "USD",
                        "id": "33333333-3333-4333-8333-333333333333",
                        "mode": "sandbox",
                        "paypal_order_id": null,
                        "purchase_id": null,
                        "refunded_cents": 0,
                        "request_id": "55555555-5555-4555-8555-555555555555",
                        "status": "creating",
                        "upgrade_id": null
                      }
                    ],
                    "limit": 25,
                    "offset": 0,
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PayPalOrderList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "রিচার্জ অর্ডার তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-scope": "read"
      },
      "post": {
        "description": "প্রকাশিত শর্তে যেকোনো পেমেন্ট পরিবেশে policy_version ও স্পষ্ট সম্মতি প্রয়োজন। চার্জযোগ্য পরিষেবা অতিরিক্ত ব্যবহারে overage_accepted-ও প্রয়োজন। প্রথম নীতি প্রকাশের আগে খসড়ার সম্মতি রেকর্ড হয় না এবং প্রতিটি কাজ স্বাভাবিক নিবন্ধন, মূল্য ও পেমেন্ট পরীক্ষা অনুসরণ করে।",
        "operationId": "post_api_v1_billing_paypal_orders",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RechargeInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PayPalOrder"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "idempotent রিচার্জ তৈরি/পুনরুদ্ধার করুন",
        "x-required-role": "owner"
      }
    },
    "/api/v1/billing/paypal/orders/{id}/capture": {
      "post": {
        "operationId": "post_api_v1_billing_paypal_orders_by_id_capture",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PayPalOrder"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "বিক্রেতার সঙ্গে বাঁধা অর্থ একবার নিশ্চিত করুন",
        "x-required-role": "owner"
      }
    },
    "/api/v1/billing/paypal/orders/{id}/reconcile": {
      "post": {
        "operationId": "post_api_v1_billing_paypal_orders_by_id_reconcile",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PayPalOrder"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "বিক্রেতার সঙ্গে বাঁধা অর্থ একবার নিশ্চিত করুন",
        "x-required-role": "owner"
      }
    },
    "/api/v1/billing/paypal/orders/{id}/refund-requests": {
      "post": {
        "description": "শুধু cookie সেশন; ব্যবস্থাপনা API কী গ্রহণ করা হয় না। গ্রাহকের পড়া নিজস্ব ওয়ার্কস্পেসে সীমিত। গ্রাহকের লেখায় প্ল্যাটফর্ম প্রশাসক অনুমতি ছাড়া যাচাইকৃত ওয়ার্কস্পেস Owner প্রয়োজন। আবেদন অর্থ সরায় বা সংরক্ষণ করে না। প্রশাসকের অনুমোদন বর্তমান ওয়ালেট ও অপরিশোধিত রিফান্ডযোগ্য ক্যাপচার মূল্য আবার পরীক্ষা করে, তারপর বিদ্যমান idempotent মূল-মাধ্যম রিফান্ড ও সংরক্ষণ প্রক্রিয়া ব্যবহার করে। অনুমোদনে প্ল্যান বাতিল হয় না।",
        "operationId": "post__api_v1_billing_paypal_orders__id__refund_requests",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WalletRefundRequestInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WalletRefundRequest"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "আমার অব্যবহৃত রিচার্জ ক্রেডিটের রিফান্ড আবেদন করুন",
        "x-required-role": "owner"
      }
    },
    "/api/v1/billing/plans": {
      "get": {
        "operationId": "get_api_v1_billing_plans",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlanList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "প্রকাশ্য প্রশাসক-পরিচালিত মূল্য ক্যাটালগ"
      }
    },
    "/api/v1/billing/purchases": {
      "get": {
        "operationId": "get_api_v1_billing_purchases",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "active": null,
                    "active_devices": 0,
                    "coverage_ends_at": null,
                    "items": [
                      {
                        "api_calls": 0,
                        "api_hard_limit": false,
                        "api_overage_cents": 0,
                        "api_unit_micros": 0,
                        "base_cents": 0,
                        "cancelled_at": null,
                        "created_at": "2026-10-18T00:00:00Z",
                        "currency": "USD",
                        "current_cycle_index": 0,
                        "current_upgrade_id": "",
                        "cycle_ends_at": "2026-10-18T00:00:00Z",
                        "cycle_starts_at": "2026-10-18T00:00:00Z",
                        "effective_included_devices": 0,
                        "effective_plan": "",
                        "effective_plan_name": "",
                        "ends_at": null,
                        "entitlement_cents": 0,
                        "gift_batch_id": "",
                        "gift_follows_current": false,
                        "hard_limit": false,
                        "id": "33333333-3333-4333-8333-333333333333",
                        "included_api_calls": null,
                        "included_devices": 0,
                        "mode": "sandbox",
                        "overage_cents": 0,
                        "plan": "starter",
                        "plan_name": "Starter",
                        "price_version": "example-v1",
                        "refunded_cents": 0,
                        "renewal": false,
                        "renewal_of": "",
                        "request_id": "55555555-5555-4555-8555-555555555555",
                        "service_credit_basis_cents": 0,
                        "service_credit_basis_seconds": 0,
                        "source": "purchase",
                        "starts_at": null,
                        "status": "pending",
                        "term_months": 1,
                        "total_api_calls": 0,
                        "total_api_overage_cents": 0,
                        "total_device_overage_cents": 0,
                        "unit_micros": 0
                      }
                    ],
                    "mode": "sandbox",
                    "renewal_package": null,
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PurchaseList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "প্যাকেজ ক্রয় তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-scope": "read"
      },
      "post": {
        "description": "নির্বাচিত প্ল্যান, মুদ্রা, মূল্য সংশোধন ও মেয়াদে ক্রয় তৈরি করুন। অবিলম্বে ওয়ালেট নিষ্পত্তি চেষ্টা করে; ব্যালেন্স অপর্যাপ্ত হলে কভারেজ শুরু না করে pending ফেরত দেয়। সক্রিয় প্যাকেজ বাড়াতে renewal=true সেট করুন। সফল পেমেন্ট বিদ্যমান কভারেজের পরে পরিষেবা নির্ধারণ করে; GET /billing/purchases থেকে coverage_ends_at জানা যায়। বর্তমান কোটা ব্যবহার ও সফটওয়্যার লাইসেন্সের মেয়াদ অপরিবর্তিত থাকে। পুনঃপ্রচেষ্টায় request_id পুনর্ব্যবহার হয় ও দ্বিগুণ চার্জ হতে পারে না। প্রকাশিত শর্তে যেকোনো পেমেন্ট পরিবেশে policy_version ও স্পষ্ট সম্মতি প্রয়োজন। চার্জযোগ্য পরিষেবা অতিরিক্ত ব্যবহারে overage_accepted-ও প্রয়োজন। প্রথম নীতি প্রকাশের আগে খসড়ার সম্মতি রেকর্ড হয় না এবং প্রতিটি কাজ স্বাভাবিক নিবন্ধন, মূল্য ও পেমেন্ট পরীক্ষা অনুসরণ করে।",
        "operationId": "post_api_v1_billing_purchases",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BuyPlan"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlanPurchase"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "প্যাকেজ কিনুন বা আগাম নবায়ন পরিশোধ করুন",
        "x-required-role": "owner"
      }
    },
    "/api/v1/billing/refund-requests": {
      "get": {
        "description": "শুধু cookie সেশন; ব্যবস্থাপনা API কী গ্রহণ করা হয় না। গ্রাহকের পড়া নিজস্ব ওয়ার্কস্পেসে সীমিত। গ্রাহকের লেখায় প্ল্যাটফর্ম প্রশাসক অনুমতি ছাড়া যাচাইকৃত ওয়ার্কস্পেস Owner প্রয়োজন। আবেদন অর্থ সরায় বা সংরক্ষণ করে না। প্রশাসকের অনুমোদন বর্তমান ওয়ালেট ও অপরিশোধিত রিফান্ডযোগ্য ক্যাপচার মূল্য আবার পরীক্ষা করে, তারপর বিদ্যমান idempotent মূল-মাধ্যম রিফান্ড ও সংরক্ষণ প্রক্রিয়া ব্যবহার করে। অনুমোদনে প্ল্যান বাতিল হয় না।",
        "operationId": "get__api_v1_billing_refund_requests",
        "parameters": [
          {
            "in": "query",
            "name": "mode",
            "schema": {
              "enum": [
                "sandbox",
                "live"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WalletRefundRequestList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "আমার ওয়ার্কস্পেসের রিফান্ড আবেদন তালিকাভুক্ত করুন"
      }
    },
    "/api/v1/billing/refund-requests/{id}/cancel": {
      "post": {
        "description": "শুধু cookie সেশন; ব্যবস্থাপনা API কী গ্রহণ করা হয় না। গ্রাহকের পড়া নিজস্ব ওয়ার্কস্পেসে সীমিত। গ্রাহকের লেখায় প্ল্যাটফর্ম প্রশাসক অনুমতি ছাড়া যাচাইকৃত ওয়ার্কস্পেস Owner প্রয়োজন। আবেদন অর্থ সরায় বা সংরক্ষণ করে না। প্রশাসকের অনুমোদন বর্তমান ওয়ালেট ও অপরিশোধিত রিফান্ডযোগ্য ক্যাপচার মূল্য আবার পরীক্ষা করে, তারপর বিদ্যমান idempotent মূল-মাধ্যম রিফান্ড ও সংরক্ষণ প্রক্রিয়া ব্যবহার করে। অনুমোদনে প্ল্যান বাতিল হয় না।",
        "operationId": "post__api_v1_billing_refund_requests__id__cancel",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WalletRefundRequest"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "আমার অপেক্ষমাণ রিফান্ড আবেদন প্রত্যাহার করুন",
        "x-required-role": "owner"
      }
    },
    "/api/v1/billing/renewal-plans": {
      "get": {
        "description": "শুধু সম্পন্ন ক্রয় ও প্রয়োগকৃত আপগ্রেডের মালিকানা। সক্রিয় প্রকাশিত অফার ও বিদ্যমান গ্রাহকদের জন্য লুকানো শুধু-নবায়ন অফার ফেরত দেয়। অপেক্ষমাণ কোট মালিকানা প্রতিষ্ঠা করে না। মেয়াদের আগে বা পরে POST /billing/purchases দিয়ে নবায়ন করুন।",
        "operationId": "get__api_v1_billing_renewal_plans",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "api_hard_limit": false,
                        "api_unit_micros": 0,
                        "base_micros": 0,
                        "currency": "USD",
                        "description": "Desktop reporting software",
                        "enabled": true,
                        "hard_limit": false,
                        "included_api_calls": null,
                        "included_devices": 0,
                        "name": "Report app",
                        "plan": "starter",
                        "price_version": "example-v1",
                        "public": false,
                        "renewal_only": false,
                        "sort_order": 0,
                        "terms": [],
                        "unit_micros": 0,
                        "updated_at": "2026-10-18T00:00:00Z"
                      }
                    ],
                    "mode": "sandbox"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/RenewalPlans",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "DEFAULT_PLAN_DISABLED",
                    "message": "The default allowance plan has not been enabled by the administrator"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "নবায়ন অফার তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/billing/subscription": {
      "get": {
        "operationId": "get_api_v1_billing_subscription",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "current": {
                      "base_covered": false,
                      "base_micros": 0,
                      "created_at": "2026-10-18T00:00:00Z",
                      "currency": "USD",
                      "hard_limit": false,
                      "included_devices": 0,
                      "month": "2026-09",
                      "payment_mode": "sandbox",
                      "plan": "starter",
                      "plan_name": "Starter",
                      "price_version": "example-v1",
                      "unit_micros": 0
                    },
                    "next": null,
                    "sandbox": false
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Subscription",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "DEFAULT_PLAN_DISABLED",
                    "message": "The default allowance plan has not been enabled by the administrator"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ডিফল্ট ভাতা অক্ষম (DEFAULT_PLAN_DISABLED)"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "মাসিক সাবস্ক্রিপশন পড়ুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-scope": "read"
      },
      "patch": {
        "operationId": "patch_api_v1_billing_subscription",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "currency": "USD",
                "plan": "starter",
                "price_version": "example-v1"
              },
              "schema": {
                "$ref": "#/components/schemas/PlanChange"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "currency": "USD",
                    "effective_month": "2026-11",
                    "plan": "starter",
                    "sandbox": false
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ScheduledPlan",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "মাসিক প্ল্যান নির্ধারণ করুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/billing/upgrades": {
      "get": {
        "description": "",
        "operationId": "get__api_v1_billing_upgrades",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "amount_cents": 0,
                        "api_hard_limit": false,
                        "api_unit_micros": 0,
                        "applied_at": null,
                        "base_cents": 0,
                        "created_at": "2026-10-18T00:00:00Z",
                        "currency": "USD",
                        "cycle_seconds": 0,
                        "ends_at": "2026-10-18T00:00:00Z",
                        "expires_at": "2026-10-18T00:00:00Z",
                        "hard_limit": false,
                        "id": "33333333-3333-4333-8333-333333333333",
                        "included_api_calls": null,
                        "included_devices": 0,
                        "mode": "sandbox",
                        "parent_id": "33333333-3333-4333-8333-333333333333",
                        "parts": [],
                        "plan": "starter",
                        "plan_name": "Starter",
                        "previous_base_cents": 0,
                        "previous_plan_name": "",
                        "previous_upgrade_id": "",
                        "price_version": "example-v1",
                        "purchase_id": "33333333-3333-4333-8333-333333333333",
                        "remaining_seconds": 0,
                        "request_id": "55555555-5555-4555-8555-555555555555",
                        "status": "pending",
                        "unit_micros": 0
                      }
                    ],
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/UpgradeList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "422": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "502": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "DEFAULT_PLAN_DISABLED",
                    "message": "The default allowance plan has not been enabled by the administrator"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "প্যাকেজ আপগ্রেড তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/billing/upgrades/quote": {
      "post": {
        "description": "সেশন Owner প্রয়োজন। লক্ষ্যের মুদ্রা একই হতে হবে, মাসিক মূল্য বা ডিভাইস/API ভাতা কম হওয়া যাবে না। মূল মেয়াদ ও ব্যবহার বজায় থাকে। আপগ্রেডে সবসময় বর্তমান ও ভবিষ্যতের সব প্রিপেইড/উপহার কভারেজ থাকে। প্রতিটি সময়ের মূল সুবিধা মূল্য অবশিষ্ট সেকেন্ড অনুপাতে ক্রেডিট হয়; শুরু না হওয়া সময়ের পুরো মেয়াদ ব্যবহৃত হয়। উপহার মূল্য নগদ ফেরতযোগ্য নয়। পেমেন্ট একটি পরমাণু ওয়ালেট চার্জ; তারিখ ও ব্যবহৃত কোটা থাকে। কোট ও পেমেন্টের মধ্যে নবায়ন, উপহার বা বাতিল UPGRADE_STATE_CONFLICT দিয়ে কোট বাতিল করে; সংশ্লিষ্ট দেরিতে আসা PayPal রিচার্জ ওয়ালেট ক্রেডিট থাকে। কভারেজ বদলালে নতুন কোট প্রয়োজন।",
        "operationId": "post__api_v1_billing_upgrades_quote",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpgradeQuoteInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlanUpgrade"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "ওয়ালেট ডেবিট না করে আনুপাতিক প্ল্যান আপগ্রেড প্রিভিউ করুন"
      }
    },
    "/api/v1/billing/upgrades/{id}/pay": {
      "post": {
        "description": "ব্যালেন্স অপর্যাপ্ত হলে প্ল্যান না বদলে pending ফেরত দেয়। একবার চার্জের পরে applied ফেরত দেয়। সক্রিয় প্ল্যান বদলে গেলে বা কোটের মেয়াদ শেষ হলে 409 ফেরত দেয়। আপগ্রেডে সবসময় বর্তমান ও ভবিষ্যতের সব প্রিপেইড/উপহার কভারেজ থাকে। প্রতিটি সময়ের মূল সুবিধা মূল্য অবশিষ্ট সেকেন্ড অনুপাতে ক্রেডিট হয়; শুরু না হওয়া সময়ের পুরো মেয়াদ ব্যবহৃত হয়। উপহার মূল্য নগদ ফেরতযোগ্য নয়। পেমেন্ট একটি পরমাণু ওয়ালেট চার্জ; তারিখ ও ব্যবহৃত কোটা থাকে। কোট ও পেমেন্টের মধ্যে নবায়ন, উপহার বা বাতিল UPGRADE_STATE_CONFLICT দিয়ে কোট বাতিল করে; সংশ্লিষ্ট দেরিতে আসা PayPal রিচার্জ ওয়ালেট ক্রেডিট থাকে। কভারেজ বদলালে নতুন কোট প্রয়োজন। নতুন পেমেন্টের আগে বর্তমান নীতির স্পষ্ট সম্মতি প্রয়োজন। ইতিমধ্যে পরিশোধিত রিপ্লে মূল রসিদ বজায় রাখে।",
        "operationId": "post__api_v1_billing_upgrades__id__pay",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LegalConsent"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlanUpgrade"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "বৈধ আপগ্রেড কোট নিশ্চিত করে একবার পরিশোধ করুন"
      }
    },
    "/api/v1/billing/waffo/orders": {
      "get": {
        "operationId": "get__api_v1_billing_waffo_orders",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WaffoOrderList"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "Waffo পরিষেবা পেমেন্ট ও ওয়ালেট টপ-আপ তালিকাভুক্ত করুন",
        "x-licentivo-access": "session"
      },
      "post": {
        "operationId": "post__api_v1_billing_waffo_orders",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WaffoOrderInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WaffoOrderResult"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "একটি Waffo পরিষেবা পেমেন্ট তৈরি বা পুনরুদ্ধার করুন",
        "x-licentivo-access": "owner"
      }
    },
    "/api/v1/billing/waffo/orders/{id}": {
      "get": {
        "operationId": "get__api_v1_billing_waffo_orders__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WaffoOrderResult"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "নিজের ওয়ার্কস্পেসের Waffo চেকআউট পড়ুন",
        "x-licentivo-access": "session"
      }
    },
    "/api/v1/billing/waffo/orders/{id}/reconcile": {
      "post": {
        "operationId": "post__api_v1_billing_waffo_orders__id__reconcile",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WaffoOrderResult"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "পেমেন্ট যাচাই করে পরিষেবা ও রিফান্ড মিলন করুন",
        "x-licentivo-access": "owner"
      }
    },
    "/api/v1/billing/wallet": {
      "get": {
        "operationId": "get_api_v1_billing_wallet",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "currencies": [],
                    "items": [
                      {
                        "balance_cents": 0,
                        "currency": "USD",
                        "mode": "sandbox"
                      }
                    ],
                    "maximum_cents": 0,
                    "minimum_cents": 0,
                    "mode": "sandbox",
                    "payment_channels": [],
                    "paypal_enabled": false
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WalletResult",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ওয়ালেট ব্যালেন্স পড়ুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/billing/wallet/entries": {
      "get": {
        "operationId": "get_api_v1_billing_wallet_entries",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "amount_cents": 0,
                        "balance_cents": 0,
                        "created_at": "2026-10-18T00:00:00Z",
                        "currency": "USD",
                        "id": "33333333-3333-4333-8333-333333333333",
                        "kind": "",
                        "mode": "sandbox",
                        "reference": ""
                      }
                    ],
                    "limit": 25,
                    "offset": 0,
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WalletEntryList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ওয়ালেট এন্ট্রি তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "billing"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/consume": {
      "post": {
        "description": "লাইসেন্স-প্রমাণীকৃত রানটাইম কাজ; vendor cookie বা API Key নেই। ফিচার ব্যবহারে স্থির Idempotency-Key প্রয়োজন; consume-এ প্ল্যাটফর্ম API ডেবিট হয় না।",
        "operationId": "post_api_v1_consume",
        "parameters": [
          {
            "description": "প্রতিটি কাজের জন্য নতুন কী তৈরি করুন; পুনঃপ্রচেষ্টায় একই কী ও বডি রাখুন। সর্বাধিক 80 অক্ষর, শূন্যস্থান নয়। যাচাই ও heartbeat-এর জন্য ঐচ্ছিক।",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 80,
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RuntimeInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ConsumptionResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "/consume"
      }
    },
    "/api/v1/consume/cancel": {
      "post": {
        "description": "ব্যবসায়িক কাজের আগে সংরক্ষণ করুন; সফলতার পরই কমিট করুন; ব্যর্থতায় বাতিল করুন। পুনঃপ্রচেষ্টায় একই কাজ শনাক্তকারী ও অনুরোধ বডি রাখুন। টাইমআউট হওয়া কমিট অনিশ্চিত: কমিট পুনঃপ্রচেষ্টা করুন, কখনো বাতিল বা সম্পন্ন কাজ পুনরাবৃত্তি নয়। সম্পন্ন সংরক্ষণ বর্তমান অবস্থা ফেরত দেয়; প্ল্যাটফর্ম API ডেবিট নেই। সম্পূর্ণ হলে license.consume ইভেন্ট হয়; অস্থায়ী হোল্ড ব্যবহার ইভেন্ট তৈরি করে না।",
        "operationId": "post_api_v1_consume_cancel",
        "parameters": [
          {
            "description": "প্রতিটি কাজের জন্য নতুন কী তৈরি করুন; পুনঃপ্রচেষ্টায় একই কী ও বডি রাখুন। সর্বাধিক 80 অক্ষর, শূন্যস্থান নয়। যাচাই ও heartbeat-এর জন্য ঐচ্ছিক।",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 80,
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RuntimeInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ReservationResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "ফিচার ইউনিট: বাতিল"
      }
    },
    "/api/v1/consume/commit": {
      "post": {
        "description": "ব্যবসায়িক কাজের আগে সংরক্ষণ করুন; সফলতার পরই কমিট করুন; ব্যর্থতায় বাতিল করুন। পুনঃপ্রচেষ্টায় একই কাজ শনাক্তকারী ও অনুরোধ বডি রাখুন। টাইমআউট হওয়া কমিট অনিশ্চিত: কমিট পুনঃপ্রচেষ্টা করুন, কখনো বাতিল বা সম্পন্ন কাজ পুনরাবৃত্তি নয়। সম্পন্ন সংরক্ষণ বর্তমান অবস্থা ফেরত দেয়; প্ল্যাটফর্ম API ডেবিট নেই। সম্পূর্ণ হলে license.consume ইভেন্ট হয়; অস্থায়ী হোল্ড ব্যবহার ইভেন্ট তৈরি করে না।",
        "operationId": "post_api_v1_consume_commit",
        "parameters": [
          {
            "description": "প্রতিটি কাজের জন্য নতুন কী তৈরি করুন; পুনঃপ্রচেষ্টায় একই কী ও বডি রাখুন। সর্বাধিক 80 অক্ষর, শূন্যস্থান নয়। যাচাই ও heartbeat-এর জন্য ঐচ্ছিক।",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 80,
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RuntimeInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ReservationResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "ফিচার ইউনিট: কমিট"
      }
    },
    "/api/v1/consume/reserve": {
      "post": {
        "description": "ব্যবসায়িক কাজের আগে সংরক্ষণ করুন; সফলতার পরই কমিট করুন; ব্যর্থতায় বাতিল করুন। পুনঃপ্রচেষ্টায় একই কাজ শনাক্তকারী ও অনুরোধ বডি রাখুন। টাইমআউট হওয়া কমিট অনিশ্চিত: কমিট পুনঃপ্রচেষ্টা করুন, কখনো বাতিল বা সম্পন্ন কাজ পুনরাবৃত্তি নয়। সম্পন্ন সংরক্ষণ বর্তমান অবস্থা ফেরত দেয়; প্ল্যাটফর্ম API ডেবিট নেই। সম্পূর্ণ হলে license.consume ইভেন্ট হয়; অস্থায়ী হোল্ড ব্যবহার ইভেন্ট তৈরি করে না।",
        "operationId": "post_api_v1_consume_reserve",
        "parameters": [
          {
            "description": "প্রতিটি কাজের জন্য নতুন কী তৈরি করুন; পুনঃপ্রচেষ্টায় একই কী ও বডি রাখুন। সর্বাধিক 80 অক্ষর, শূন্যস্থান নয়। যাচাই ও heartbeat-এর জন্য ঐচ্ছিক।",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 80,
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RuntimeInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ReservationResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "ফিচার ইউনিট: সংরক্ষণ"
      }
    },
    "/api/v1/customer/activations/{id}/release": {
      "post": {
        "operationId": "post_api_v1_customer_activations_by_id_release",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CustomerReleaseInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CustomerReleaseResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "customerSession": []
          }
        ],
        "summary": "/customer/activations/{id}/release"
      }
    },
    "/api/v1/customer/cases": {
      "get": {
        "description": "",
        "operationId": "get__api_v1_customer_cases",
        "parameters": [
          {
            "description": "গণনা ও পৃষ্ঠাবিন্যাসের আগে একটি অনুরোধ ধরন বাদ দিন। সহায়তা তালিকা থেকে রিফান্ড মামলা বাদ দিতে refund ব্যবহার করুন; প্রবেশ বর্তমান সেশনের পরিসরে থাকে।",
            "in": "query",
            "name": "exclude_kind",
            "schema": {
              "maxLength": 24,
              "type": "string"
            }
          },
          {
            "description": "রিফান্ড মামলা ওয়ালেট টপ-আপ বা পরিষেবা বাতিলে সীমিত করুন।",
            "in": "query",
            "name": "refund_scope",
            "required": false,
            "schema": {
              "enum": [
                "wallet",
                "service"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportCaseList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "গ্রাহক অনুরোধ তালিকাভুক্ত করুন",
        "x-required-role": "session"
      },
      "post": {
        "description": "স্থির request_id ওয়ার্কস্পেসের পরিসরে; পরিবর্তিত বিষয়বস্তু এটি পুনর্ব্যবহার করতে পারে না।",
        "operationId": "post__api_v1_customer_cases",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SupportCaseInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportCase"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সহায়তা, গোপনীয়তা বা আপিল অনুরোধ তৈরি করুন",
        "x-required-role": "session"
      }
    },
    "/api/v1/customer/cases/unread": {
      "get": {
        "description": "রিফান্ড চ্যাট বাদ। গ্রাহক শুধু অনুমোদিত ওয়ার্কস্পেস টিকিট দেখেন; সদস্য নিজেরটি দেখেন। প্রতিটি প্রশাসকের স্বাধীন রিড ওয়াটারমার্ক আছে।",
        "operationId": "get__api_v1_customer_cases_unread",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportUnread"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "ব্যক্তিগত টিকিট ও বিজ্ঞপ্তির অপঠিত গণনা পড়ুন",
        "x-required-role": "session"
      }
    },
    "/api/v1/customer/cases/{id}": {
      "get": {
        "description": "",
        "operationId": "get__api_v1_customer_cases__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportCaseDetail"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "অনুরোধ ও উত্তর পড়ুন",
        "x-required-role": "session"
      }
    },
    "/api/v1/customer/cases/{id}/messages": {
      "post": {
        "description": "রিফান্ড মামলা REFUND_REVIEW_WORKFLOW দিয়ে উত্তর প্রত্যাখ্যান করে; প্রশাসক সরাসরি অনুমোদন বা প্রত্যাখ্যান করেন। সাধারণ সহায়তা টিকিটে উত্তর থাকে। পর্যালোচিত বন্ধ তাদের গোপনীয়তা ওয়ার্কফ্লো অবস্থা রাখে।",
        "operationId": "post__api_v1_customer_cases__id__messages",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SupportReply"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportCaseDetail"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সহায়তা টিকিটে উত্তর দিন",
        "x-required-role": "session"
      }
    },
    "/api/v1/customer/cases/{id}/read": {
      "post": {
        "description": "শুধু সর্বশেষ দেখানো বার্তা পর্যন্ত পঠিত চিহ্নিত হয়। পরের নতুন বার্তা অপঠিত থাকে এবং বিলম্বিত স্বীকৃতি ওয়াটারমার্ক পেছাতে পারে না।",
        "operationId": "post__api_v1_customer_cases__id__read",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SupportReadInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CommerceResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "দেখানো টিকিট বার্তার প্রাপ্তি স্বীকার করুন",
        "x-required-role": "session"
      }
    },
    "/api/v1/customer/compensations": {
      "get": {
        "description": "",
        "operationId": "get__api_v1_customer_compensations",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "created_at": "2026-10-18T00:00:00Z",
                        "id": "33333333-3333-4333-8333-333333333333",
                        "incident_id": "33333333-3333-4333-8333-333333333333",
                        "intervals": "",
                        "mode": "timed",
                        "purchase_id": "33333333-3333-4333-8333-333333333333",
                        "seconds": 0
                      }
                    ]
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ServiceCompensationList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "পরিষেবা ক্ষতিপূরণ তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "service"
        },
        "x-required-role": "session",
        "x-required-scope": "read"
      }
    },
    "/api/v1/customer/licenses": {
      "get": {
        "operationId": "get_api_v1_customer_licenses",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CustomerLicenses"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "customerSession": []
          }
        ],
        "summary": "সংযুক্ত ক্রেতা লাইসেন্স"
      }
    },
    "/api/v1/customer/login": {
      "post": {
        "operationId": "post_api_v1_customer_login",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Email"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Notice"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "/customer/login"
      }
    },
    "/api/v1/customer/logout": {
      "post": {
        "operationId": "post_api_v1_customer_logout",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LoggedOut"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "customerSession": []
          }
        ],
        "summary": "/customer/logout"
      }
    },
    "/api/v1/customer/notices": {
      "get": {
        "description": "",
        "operationId": "get__api_v1_customer_notices",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "body": "",
                        "created_at": "2026-10-18T00:00:00Z",
                        "effective_at": null,
                        "emailed_at": null,
                        "id": "33333333-3333-4333-8333-333333333333",
                        "kind": "",
                        "read_at": null,
                        "reference": "",
                        "title": ""
                      }
                    ]
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CommerceNoticeList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "পরিষেবা বিজ্ঞপ্তি তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "service"
        },
        "x-required-role": "session",
        "x-required-scope": "read"
      }
    },
    "/api/v1/customer/notices/{id}/read": {
      "post": {
        "description": "",
        "operationId": "post__api_v1_customer_notices__id__read",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CommerceResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "নিজের বিজ্ঞপ্তি পঠিত চিহ্নিত করুন",
        "x-required-role": "session"
      }
    },
    "/api/v1/customer/offline/respond": {
      "post": {
        "operationId": "post_api_v1_customer_offline_respond",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OfflineRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/OfflineResponse"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "customerSession": []
          }
        ],
        "summary": "/customer/offline/respond"
      }
    },
    "/api/v1/customer/refunds": {
      "post": {
        "description": "স্পষ্ট পরিসরে নিশ্চিতকরণ এবং ফেরত পাওয়া quote_hash ও quoted_at প্রয়োজন। প্রশাসক অনুমোদন পর্যন্ত পরিষেবা সক্রিয় থাকে। অবস্থা বদলালে বা কোটের মেয়াদ শেষ হলে নতুন প্রিভিউ প্রয়োজন; বিরোধী অপেক্ষমাণ আবেদন প্রত্যাখ্যাত। পরিসরবিহীন অনুরোধে স্পষ্ট নিশ্চিতকরণের পর যোগ্য তাৎক্ষণিক বাতিল সম্ভব। order_id দিয়ে reason=failed_delivery-সহ paid_unapplied Waffo/Paddle পেমেন্টও নির্বাচন করা যায়; কখনো দেওয়া হয়নি এমন ওয়ালেট ক্রেডিট ফ্রিজ হয় না।",
        "operationId": "post__api_v1_customer_refunds",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CustomerRefundInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportCase"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সরাসরি পর্যালোচনার জন্য রিফান্ড আবেদন জমা দিন",
        "x-required-role": "owner"
      }
    },
    "/api/v1/customer/refunds/quote": {
      "post": {
        "description": "স্পষ্ট ক্রয়/পরিষেবা পরিসর সীমাবদ্ধ স্ন্যাপশট হ্যাশ, প্রভাবিত ক্রয়, প্রতি মুদ্রায় রিফান্ড অনুমান ও অবশিষ্ট তারিখ ফেরত দেয়। জমা দিলে পরিষেবা বন্ধ হয় না। উপহারের নগদ মূল্য নেই; পরিশোধিত আপগ্রেড পর্যালোচনায় রিফান্ডযোগ্য থাকে।",
        "operationId": "post__api_v1_customer_refunds_quote",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CustomerRefundQuoteInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CustomerRefundQuote"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "বাতিলের পরিসর, রিফান্ড ও অবশিষ্ট পরিষেবা প্রিভিউ করুন",
        "x-required-role": "owner"
      }
    },
    "/api/v1/customer/refunds/{id}/cancel": {
      "post": {
        "operationId": "post__api_v1_customer_refunds__id__cancel",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CancelCustomerRefund"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportCaseDetail"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "আমার অবশিষ্ট অপর্যালোচিত রিফান্ড অনুরোধ প্রত্যাহার করুন",
        "x-required-role": "owner"
      }
    },
    "/api/v1/customer/verify": {
      "post": {
        "operationId": "post_api_v1_customer_verify",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Token"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CustomerSession"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "/customer/verify"
      }
    },
    "/api/v1/deactivate": {
      "post": {
        "description": "product_id + license_key + device_id দিয়ে প্রমাণীকৃত। cookie/CSRF/vendor key নেই। activate ছাড়া activation_id প্রয়োজন। প্রতিটি সফল অনুরোধ একটি API কল খরচ করে; idempotent রিপ্লে ও ব্যর্থতা করে না। অতিরিক্ত ব্যবহার ওয়ালেট থেকে পরমাণুভাবে ডেবিট হয় অথবা API_QUOTA_EXCEEDED/API_BALANCE_INSUFFICIENT ফেরত দেয়। ওয়ার্কস্পেস ডিভাইস কোটা বর্তমান অ্যাক্টিভেশন অনুসরণ করে। রিলিজ ক্ষমতা ফেরত দেয়; ফ্লোটিং লিজের মেয়াদ শেষেও ক্ষমতা ফেরে, তবে অফলাইন সাধারণ নিবন্ধন গণনায় থাকে। কোটা-মাসের বিলিং শীর্ষ ইতিমধ্যে পরিশোধিত ক্ষমতা ছাড়ালেই কেবল ডিভাইস অতিরিক্ত ব্যবহারের চার্জ হয়; রিলিজে আগের চার্জ ফেরত হয় না। API ব্যবহার আলাদা।",
        "operationId": "post_api_v1_deactivate",
        "parameters": [
          {
            "description": "প্রতিটি কাজের জন্য নতুন কী তৈরি করুন; পুনঃপ্রচেষ্টায় একই কী ও বডি রাখুন। সর্বাধিক 80 অক্ষর, শূন্যস্থান নয়। যাচাই ও heartbeat-এর জন্য ঐচ্ছিক।",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 80,
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RuntimeInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/RuntimeResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "রানটাইম ডিঅ্যাক্টিভেট"
      }
    },
    "/api/v1/demo/trial": {
      "post": {
        "operationId": "post_api_v1_demo_trial",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Trial"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "প্রতি owner একটি বিচ্ছিন্ন সাত-দিনের SDK ট্রায়াল তৈরি করুন",
        "x-required-role": "owner"
      }
    },
    "/api/v1/examples/sdk": {
      "get": {
        "operationId": "get_api_v1_examples_sdk",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SDKExampleInfo"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "প্রকাশ্য SDK উদাহরণের উপলব্ধতা"
      }
    },
    "/api/v1/examples/sdk/download/{name}": {
      "get": {
        "operationId": "get_api_v1_examples_sdk_download_{name}",
        "parameters": [
          {
            "in": "path",
            "name": "name",
            "required": true,
            "schema": {
              "description": "ভাষা সঙ্গে .zip, যেমন csharp.zip",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/zip": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "কোডে প্রকাশ্য পণ্য সেটিং আগে থেকে থাকা সোর্স ডাউনলোড করুন"
      }
    },
    "/api/v1/examples/sdk/trial": {
      "post": {
        "description": "ব্রাউজার CSRF ও HttpOnly দর্শক cookie প্রয়োজন। প্রতিটি দর্শক আলাদা লাইসেন্স পায়; তিন দিন প্রথম অ্যাক্টিভেশনে শুরু হয়। বারবার দাবি করলে মেয়াদ বাড়ে না। export সক্ষম হয়, pro নয়।",
        "operationId": "post_api_v1_examples_sdk_trial",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SDKExampleTrial"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "এই দর্শকের স্বাধীন তিন-দিনের ট্রায়াল দাবি/পুনরুদ্ধার করুন"
      }
    },
    "/api/v1/forum/images": {
      "post": {
        "operationId": "post__api_v1_forum_images",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "image": {
                    "description": "PNG, JPEG বা GIF; সর্বাধিক 5 MB, 4096 × 4096 এবং 16 মিলিয়ন পিক্সেল। GIF স্থির PNG হিসেবে সংরক্ষিত হয়। প্রকাশিত পোস্টে যুক্ত না হওয়া পর্যন্ত ব্যক্তিগত।",
                    "format": "binary",
                    "type": "string"
                  }
                },
                "required": [
                  "image"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ForumImage"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "ব্যক্তিগত খসড়া ছবি আপলোড করুন",
        "tags": [
          "Community"
        ]
      }
    },
    "/api/v1/forum/replies/{id}": {
      "delete": {
        "operationId": "delete__api_v1_forum_replies__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "format": "uuid",
                          "type": "string"
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "type": "object"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "উত্তর মুছুন (লেখক বা প্ল্যাটফর্ম প্রশাসক)",
        "tags": [
          "Community"
        ]
      },
      "patch": {
        "operationId": "patch__api_v1_forum_replies__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ForumReplyInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "format": "uuid",
                          "type": "string"
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "type": "object"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "নিজের উত্তর সম্পাদনা করুন",
        "tags": [
          "Community"
        ]
      }
    },
    "/api/v1/forum/topics": {
      "get": {
        "operationId": "get__api_v1_forum_topics",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "q",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "category",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "language",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ForumTopicList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          }
        },
        "security": [],
        "summary": "প্রকাশ্য আলোচনা তালিকাভুক্ত করুন, পিন করা আগে",
        "tags": [
          "Community"
        ]
      },
      "post": {
        "operationId": "post__api_v1_forum_topics",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ForumTopicInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "format": "uuid",
                          "type": "string"
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "type": "object"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "আলোচনা তৈরি করুন (যেকোনো যাচাইকৃত টেন্যান্ট সদস্য)",
        "tags": [
          "Community"
        ]
      }
    },
    "/api/v1/forum/topics/{id}": {
      "delete": {
        "operationId": "delete__api_v1_forum_topics__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "format": "uuid",
                          "type": "string"
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "type": "object"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "আলোচনা মুছুন (লেখক বা প্ল্যাটফর্ম প্রশাসক)",
        "tags": [
          "Community"
        ]
      },
      "get": {
        "operationId": "get__api_v1_forum_topics__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ForumTopicDetail"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          }
        },
        "security": [],
        "summary": "প্রকাশ্য আলোচনা ও উত্তর পড়ুন",
        "tags": [
          "Community"
        ]
      },
      "patch": {
        "operationId": "patch__api_v1_forum_topics__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ForumTopicInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "format": "uuid",
                          "type": "string"
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "type": "object"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "নিজের আলোচনা সম্পাদনা করুন",
        "tags": [
          "Community"
        ]
      }
    },
    "/api/v1/forum/topics/{id}/moderation": {
      "post": {
        "operationId": "post__api_v1_forum_topics__id__moderation",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ForumModerationInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "format": "uuid",
                          "type": "string"
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "type": "object"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "আলোচনা পিন, আনপিন, লুকান বা লক করুন (প্ল্যাটফর্ম প্রশাসক)",
        "tags": [
          "Community"
        ]
      }
    },
    "/api/v1/forum/topics/{id}/replies": {
      "post": {
        "operationId": "post__api_v1_forum_topics__id__replies",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ForumReplyInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "format": "uuid",
                          "type": "string"
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "type": "object"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ত্রুটি কোড ও অনুরোধ ID; অ্যাকাউন্ট বিবরণ প্রকাশ হয় না"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "আলোচনায় উত্তর দিন",
        "tags": [
          "Community"
        ]
      }
    },
    "/api/v1/forum/topics/{id}/translate": {
      "post": {
        "description": "বেনামি দর্শক CSRF টোকেন দিয়ে এই এন্ডপয়েন্ট ব্যবহার করতে পারেন। শুধু প্রকাশিত সংরক্ষিত ফোরাম পাঠ্য গ্রহণ করা হয়, ইচ্ছামতো জমা পাঠ্য নয়। অনুবাদ বিষয়বস্তু ও লক্ষ্য ভাষা অনুযায়ী ক্যাশ হয়। লুকানো বিষয়/উত্তরে 404; সমসাময়িক অনুবাদে TRANSLATION_PENDING আসতে পারে। মূল সংরক্ষিত থাকে।",
        "operationId": "post__api_v1_forum_topics__id__translate",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ForumTranslationInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ForumTranslationResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          }
        },
        "security": [],
        "summary": "প্রকাশিত বিষয় বা উত্তর অনুবাদ করুন"
      }
    },
    "/api/v1/forum/translation": {
      "get": {
        "description": "",
        "operationId": "get__api_v1_forum_translation",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/TranslationOptions"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          }
        },
        "security": [],
        "summary": "প্রকাশ্যে উপলব্ধ অনুবাদের লক্ষ্য ভাষা পান"
      }
    },
    "/api/v1/heartbeat": {
      "post": {
        "description": "product_id + license_key + device_id দিয়ে প্রমাণীকৃত। cookie/CSRF/vendor key নেই। activate ছাড়া activation_id প্রয়োজন। প্রতিটি সফল অনুরোধ একটি API কল খরচ করে; idempotent রিপ্লে ও ব্যর্থতা করে না। অতিরিক্ত ব্যবহার ওয়ালেট থেকে পরমাণুভাবে ডেবিট হয় অথবা API_QUOTA_EXCEEDED/API_BALANCE_INSUFFICIENT ফেরত দেয়। যাচাই ও heartbeat পুনঃপ্রচেষ্টা রসিদ 3600 সেকেন্ড পরে মেয়াদোত্তীর্ণ হয়। মূল অনুমোদন বৈধ থাকলে এই সময়ে মিল থাকা অনুরোধ অতিরিক্ত ডেবিট ছাড়া রিপ্লে হয়। সময়সীমার পরে নতুন কী ব্যবহার করুন; আগে ব্যবহৃত কী নতুন অনুরোধ হিসেবে প্রক্রিয়াকৃত হতে পারে। অ্যাক্টিভেশন, ডিঅ্যাক্টিভেশন ও ফিচার ব্যবহারের রসিদ স্থায়ী থাকে। ওয়ার্কস্পেস ডিভাইস কোটা বর্তমান অ্যাক্টিভেশন অনুসরণ করে। রিলিজ ক্ষমতা ফেরত দেয়; ফ্লোটিং লিজের মেয়াদ শেষেও ক্ষমতা ফেরে, তবে অফলাইন সাধারণ নিবন্ধন গণনায় থাকে। কোটা-মাসের বিলিং শীর্ষ ইতিমধ্যে পরিশোধিত ক্ষমতা ছাড়ালেই কেবল ডিভাইস অতিরিক্ত ব্যবহারের চার্জ হয়; রিলিজে আগের চার্জ ফেরত হয় না। API ব্যবহার আলাদা।",
        "operationId": "post_api_v1_heartbeat",
        "parameters": [
          {
            "description": "প্রতিটি কাজের জন্য নতুন কী তৈরি করুন; পুনঃপ্রচেষ্টায় একই কী ও বডি রাখুন। সর্বাধিক 80 অক্ষর, শূন্যস্থান নয়। যাচাই ও heartbeat-এর জন্য ঐচ্ছিক।",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "maxLength": 80,
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RuntimeInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/RuntimeResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "চলাকালীন হার্টবিট"
      }
    },
    "/api/v1/launch/connections": {
      "get": {
        "description": "Launch বিশ্বাস সংযোগ তালিকাভুক্ত করুন। সিদ্ধান্ত, পুনঃপ্রচেষ্টা ও পরিসর যাচাই Licentivo করে।",
        "operationId": "launch_get__api_v1_launch_connections",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {},
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "এই কাজের ফল।",
                      "properties": {
                        "items": {
                          "description": "অনুরোধের পরিসরে মিল থাকা রেকর্ড।",
                          "items": {
                            "$ref": "#/components/schemas/LaunchConnection"
                          },
                          "type": "array"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [
          {
            "managementKey": []
          },
          {
            "session": []
          }
        ],
        "summary": "Launch বিশ্বাস সংযোগ তালিকাভুক্ত করুন",
        "tags": [
          "Launch account licensing"
        ],
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-scope": "read"
      },
      "post": {
        "description": "Launch ইস্যুকারী ও বাণিজ্য পরিবেশ নিবন্ধন করুন। সিদ্ধান্ত, পুনঃপ্রচেষ্টা ও পরিসর পরীক্ষা Licentivo করে।",
        "operationId": "launch_post__api_v1_launch_connections",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "audience": "licentivo:launch",
                "enabled": true,
                "environment": "live",
                "issuer": "https://shop.example.test",
                "public_keys": {
                  "launch-1": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
                }
              },
              "schema": {
                "$ref": "#/components/schemas/LaunchConnectionInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "audience": "licentivo:launch",
                    "enabled": true,
                    "environment": "live",
                    "id": "11111111-1111-4111-8111-111111111111",
                    "issuer": "https://shop.example.test"
                  },
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LaunchConnection",
                      "description": "এই কাজের ফল।"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [
          {
            "managementKey": []
          },
          {
            "session": []
          }
        ],
        "summary": "Launch ইস্যুকারী ও বাণিজ্য পরিবেশ নিবন্ধন করুন",
        "tags": [
          "Launch account licensing"
        ],
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/launch/connections/{id}": {
      "put": {
        "description": "ইস্যুকারী, audience ও পরিবেশ অপরিবর্তনীয়। বিশ্বস্ত পাবলিক কী-এর সম্পূর্ণ সেট দিন।",
        "operationId": "launch_put__api_v1_launch_connections_id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "audience": "licentivo:launch",
                "enabled": true,
                "environment": "live",
                "issuer": "https://shop.example.test",
                "public_keys": {
                  "launch-1": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
                }
              },
              "schema": {
                "$ref": "#/components/schemas/LaunchConnectionInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "audience": "licentivo:launch",
                    "enabled": true,
                    "environment": "live",
                    "id": "11111111-1111-4111-8111-111111111111",
                    "issuer": "https://shop.example.test"
                  },
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LaunchConnection",
                      "description": "এই কাজের ফল।"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [
          {
            "managementKey": []
          },
          {
            "session": []
          }
        ],
        "summary": "Launch কী রোটেট বা রানটাইম সীমা আপডেট করুন",
        "tags": [
          "Launch account licensing"
        ],
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/launch/connections/{id}/devices/{activation}/release": {
      "post": {
        "description": "Licentivo 30-দিনের স্ব-রিলিজ ভাতা সংরক্ষণ করে, কাজ রেকর্ড করে এবং পুনঃপ্রচেষ্টা ও ম্যানুয়াল পর্যালোচনা পরিচালনা করে। ওয়ার্কার একই লেনদেন লকের মধ্যে বাইন্ডিং সংস্করণ তুলনা করে সেশন ও ক্রেডেনশিয়াল প্রত্যাহার করে। পুরোনো Launch লগইন সেশন প্রত্যাহৃত ডিভাইসে আরেকটি পরিচয় assertion বিনিময় করতে পারে না।",
        "operationId": "launch_post__api_v1_launch_connections_id_devices_activation_release",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "activation",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "account_ref": "account_ref_example",
                "entitlement_ref": "entitlement_ref_example",
                "environment": "live",
                "expected_generation": 1,
                "operation_id": "11111111-1111-4111-8111-111111111111"
              },
              "schema": {
                "$ref": "#/components/schemas/LaunchDeviceReleaseInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "activation_id": "11111111-1111-4111-8111-111111111111",
                    "expected_generation": 1,
                    "license_id": "11111111-1111-4111-8111-111111111111",
                    "operation_id": "11111111-1111-4111-8111-111111111111",
                    "source": "logout",
                    "status": "pending"
                  },
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/DeviceReleaseOperation",
                      "description": "এই কাজের ফল।"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [
          {
            "managementKey": []
          },
          {
            "session": []
          }
        ],
        "summary": "সংস্করণযুক্ত দূরবর্তী অ্যাকাউন্ট ডিভাইস রিলিজ অনুরোধ করুন",
        "tags": [
          "Launch account licensing"
        ],
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/launch/connections/{id}/entitlements/{entitlement}/devices": {
      "get": {
        "description": "অ্যাকাউন্ট ডিভাইস, কর্তৃত্বপূর্ণ রিলিজ ভাতা ও কাজ পড়ুন। সিদ্ধান্ত, পুনঃপ্রচেষ্টা ও পরিসর পরীক্ষা Licentivo করে।",
        "operationId": "launch_get__api_v1_launch_connections_id_entitlements_entitlement_devices",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "entitlement",
            "required": true,
            "schema": {
              "description": "বড়-ছোট অক্ষর সংবেদনশীল অপরিবর্তনীয় ক্রয় অধিকার রেফারেন্স।",
              "pattern": "^[A-Za-z0-9_-]{1,128}$",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "account_ref",
            "required": true,
            "schema": {
              "description": "বড়-ছোট অক্ষর সংবেদনশীল অপরিবর্তনীয় ক্রয় অধিকার রেফারেন্স।",
              "pattern": "^[A-Za-z0-9_-]{1,128}$",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "environment",
            "required": true,
            "schema": {
              "description": "বাণিজ্য পরিবেশ, সংযোগ ও স্বাক্ষরিত গ্রান্ট উভয়ে পিন করা।",
              "enum": [
                "live",
                "sandbox"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {},
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "এই কাজের ফল।",
                      "properties": {
                        "can_release": {
                          "description": "এই বিশ্বাস সংযোগ নতুন রানটাইম ব্যবহার অনুমোদন করতে পারে কি না।",
                          "type": "boolean"
                        },
                        "items": {
                          "description": "অনুরোধের পরিসরে মিল থাকা রেকর্ড।",
                          "items": {
                            "additionalProperties": false,
                            "properties": {
                              "device_name": {
                                "description": "মানুষের পড়ার উপযোগী ডিভাইস লেবেল।",
                                "type": "string"
                              },
                              "generation": {
                                "description": "বর্তমান ডিভাইস বাইন্ডিংয়ের বর্তমান অবতার।",
                                "type": "integer"
                              },
                              "id": {
                                "description": "Licentivo রিসোর্স UUID।",
                                "format": "uuid",
                                "type": "string"
                              },
                              "last_seen_at": {
                                "description": "রেকর্ড তৈরির UTC সময়।",
                                "format": "date-time",
                                "type": "string"
                              },
                              "status": {
                                "description": "সার্ভার-নিয়ন্ত্রিত বর্তমান জীবনচক্র বা প্রক্রিয়াকরণ অবস্থা।",
                                "type": "string"
                              }
                            },
                            "required": [],
                            "type": "object"
                          },
                          "type": "array"
                        },
                        "operations": {
                          "description": "সার্ভার-নিয়ন্ত্রিত ডিভাইস রিলিজ কাজের ইতিহাস।",
                          "items": {
                            "$ref": "#/components/schemas/DeviceReleaseOperation"
                          },
                          "type": "array"
                        },
                        "remaining": {
                          "description": "গত 30 দিনের অবশিষ্ট স্ব-পরিষেবা রিলিজ, Licentivo দ্বারা গণিত।",
                          "type": "integer"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [
          {
            "managementKey": []
          },
          {
            "session": []
          }
        ],
        "summary": "অ্যাকাউন্ট ডিভাইস, কর্তৃত্বপূর্ণ রিলিজ ভাতা ও কাজ পড়ুন",
        "tags": [
          "Launch account licensing"
        ],
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/launch/connections/{id}/events": {
      "post": {
        "description": "প্রাপ্তি স্বীকারের আগে স্থায়ীভাবে সংরক্ষণ করুন। ভিন্ন বডিসহ ডুপ্লিকেট ID-তে সংঘর্ষ হয়। ওয়ার্কার নির্দিষ্ট বৈধতা ও একমুখী বাড়তে থাকা সমষ্টিগত সংস্করণ লেনদেনের মধ্যে প্রয়োগ করে, পুরোনো সংস্করণ উপেক্ষা করে এবং ম্যানুয়াল পর্যালোচনার আগে ব্যর্থতায় সর্বাধিক 12 প্রচেষ্টা করে। বিদ্যমান অধিকারের ক্ষেত্রে মালিকানা ও সংস্করণ পরীক্ষা বজায় রেখে রিফান্ড, স্থগিত ও মেয়াদ শেষ প্ল্যান ম্যাপিং, নীতি সংস্করণ, বৈধতা মোড ও ডিভাইস দখল থেকে স্বাধীনভাবে প্রবেশ প্রত্যাহার করে। প্ল্যান ডাউনগ্রেড নতুন ফিচার, মিটার নিয়ম ও কার্যকর ডিভাইস সীমা একসঙ্গে প্রয়োগ করে, সবচেয়ে পুরোনো বাইন্ডিং রাখে এবং নিজস্ব রিলিজ ভাতা খরচ ছাড়া অতিরিক্ত ডিভাইসের সেশন ও ক্রেডেনশিয়াল প্রত্যাহার করে। নবায়ন, প্ল্যান পরিবর্তন ও নীতি সংরক্ষণ স্বাধীন ম্যানুয়াল ফিচার ও ডিভাইস সীমা বজায় রাখে। স্পষ্ট entitlement.downgraded স্ন্যাপশট সক্রিয় বাণিজ্যিক অবস্থা রাখে কিন্তু প্রয়োগ ব্যর্থ হলে পুরোনো অধিকার স্থায়ীভাবে আটকে দেয়। প্রমাণযোগ্য হ্রাসসহ বিদ্যমান সক্রিয় স্ন্যাপশট একই সুরক্ষা পায়। কেবল অপেক্ষমাণ বিধিনিষেধ সংস্করণের সমান বা উচ্চতর প্রয়োগকৃত স্ন্যাপশট বাধা সরায়। idempotent রানটাইম পুনঃপ্রচেষ্টা কাজের ডুপ্লিকেট নিয়ন্ত্রণ বজায় রেখে পরিবর্তিত অনুমোদন ও ক্রয়ের সময়সীমা হালনাগাদ করে। অনুমোদন প্রস্তুত ঘোষণার আগে ইভেন্ট জিজ্ঞাসা করুন।",
        "operationId": "launch_post__api_v1_launch_connections_id_events",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "account_ref": "account_ref_example",
                "entitlement_ref": "entitlement_ref_example",
                "environment": "live",
                "event_id": "11111111-1111-4111-8111-111111111111",
                "launch_product_id": "11111111-1111-4111-8111-111111111111",
                "plan_ref": "plan_ref_example",
                "type": "entitlement.created",
                "valid_from": "2026-10-24T00:00:00Z",
                "version": 1
              },
              "schema": {
                "$ref": "#/components/schemas/LaunchCommerceEvent"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "attempts": 1,
                    "available_at": "2026-10-24T00:00:00Z",
                    "connection_id": "11111111-1111-4111-8111-111111111111",
                    "event_id": "11111111-1111-4111-8111-111111111111",
                    "status": "pending"
                  },
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LaunchEvent",
                      "description": "এই কাজের ফল।"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [
          {
            "managementKey": []
          },
          {
            "session": []
          }
        ],
        "summary": "সম্পূর্ণ Launch বাণিজ্য স্ন্যাপশট গ্রহণ করুন",
        "tags": [
          "Launch account licensing"
        ],
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/launch/connections/{id}/events/{event}": {
      "get": {
        "description": "Launch বাণিজ্য ইভেন্টের ফল পড়ুন। সিদ্ধান্ত, পুনঃপ্রচেষ্টা ও পরিসর পরীক্ষা Licentivo করে।",
        "operationId": "launch_get__api_v1_launch_connections_id_events_event_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "event",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "attempts": 1,
                    "available_at": "2026-10-24T00:00:00Z",
                    "connection_id": "11111111-1111-4111-8111-111111111111",
                    "event_id": "11111111-1111-4111-8111-111111111111",
                    "status": "pending"
                  },
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LaunchEvent",
                      "description": "এই কাজের ফল।"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [
          {
            "managementKey": []
          },
          {
            "session": []
          }
        ],
        "summary": "Launch বাণিজ্য ইভেন্টের ফল পড়ুন",
        "tags": [
          "Launch account licensing"
        ],
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/launch/connections/{id}/events/{event}/retry": {
      "post": {
        "description": "অপ্রয়োগকৃত Launch ইভেন্ট পুনঃপ্রচেষ্টা করুন। সিদ্ধান্ত, পুনঃপ্রচেষ্টা ও পরিসর পরীক্ষা Licentivo করে।",
        "operationId": "launch_post__api_v1_launch_connections_id_events_event_retry",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "event",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {},
              "schema": {
                "additionalProperties": false,
                "properties": {},
                "required": [],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {},
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "এই কাজের ফল।",
                      "properties": {
                        "queued": {
                          "description": "এই বিশ্বাস সংযোগ নতুন রানটাইম ব্যবহার অনুমোদন করতে পারে কি না।",
                          "type": "boolean"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [
          {
            "managementKey": []
          },
          {
            "session": []
          }
        ],
        "summary": "অপ্রয়োগকৃত Launch ইভেন্ট পুনঃপ্রচেষ্টা করুন",
        "tags": [
          "Launch account licensing"
        ],
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/launch/connections/{id}/plans/{plan}": {
      "put": {
        "description": "Launch প্ল্যান সংস্করণ লাইসেন্স নীতিতে ম্যাপ করুন। সিদ্ধান্ত, পুনঃপ্রচেষ্টা ও পরিসর পরীক্ষা Licentivo করে।",
        "operationId": "launch_put__api_v1_launch_connections_id_plans_plan_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "plan",
            "required": true,
            "schema": {
              "description": "বড়-ছোট অক্ষর সংবেদনশীল অপরিবর্তনীয় ক্রয় অধিকার রেফারেন্স।",
              "pattern": "^[A-Za-z0-9_-]{1,128}$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "launch_product_id": "11111111-1111-4111-8111-111111111111",
                "policy_id": "11111111-1111-4111-8111-111111111111",
                "policy_version": 1,
                "product_id": "11111111-1111-4111-8111-111111111111"
              },
              "schema": {
                "$ref": "#/components/schemas/LaunchPlanMappingInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {},
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "এই কাজের ফল।",
                      "properties": {
                        "saved": {
                          "description": "এই বিশ্বাস সংযোগ নতুন রানটাইম ব্যবহার অনুমোদন করতে পারে কি না।",
                          "type": "boolean"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [
          {
            "managementKey": []
          },
          {
            "session": []
          }
        ],
        "summary": "Launch প্ল্যান সংস্করণ লাইসেন্স নীতিতে ম্যাপ করুন",
        "tags": [
          "Launch account licensing"
        ],
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/launch/connections/{id}/session-revocations": {
      "post": {
        "description": "সিঙ্ক্রোনাস পরমাণু প্রত্যাহার: HTTP 200 মানে সেশন, ক্রেডেনশিয়াল, মিল থাকা ডিভাইস বাইন্ডিং ও স্থায়ী রসিদ কমিট হয়েছে। সংযোগ পরিবেশ নির্ধারণ করে; ঐচ্ছিক অশূন্য environment মিলতে হবে। idempotency-তে বাদ দেওয়া ও মিল থাকা স্পষ্ট মান সমতুল্য। সমসাময়িক পুনঃপ্রচেষ্টাসহ event_id ও একই স্বাভাবিকীকৃত বডি পুনর্ব্যবহার করুন; ভিন্ন বডিতে সংঘর্ষ। সফল রিপ্লে মূল গণনা ফেরায় এবং নতুন লগইন প্রত্যাহার করে না। অজানা অ্যাকাউন্ট/sid শূন্য প্রভাবিত সারিসহ সফল হয় ও লগইন প্রত্যাখ্যান চিহ্ন রাখে। অ্যাকাউন্ট পরিসর সার্ভারের গ্রহণ-সময়ের প্রমাণীকরণ কাটঅফ রেকর্ড করে। কেনা অধিকারের বৈধতা ও লাইসেন্স শর্ত থাকে। নিষ্ক্রিয় সংযোগ প্রত্যাহার গ্রহণ করে।",
        "operationId": "launch_post__api_v1_launch_connections_id_session_revocations",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "account_ref": "account_456",
                "event_id": "11111111-1111-4111-8111-111111111111",
                "reason": "forced_logout",
                "scope": "session",
                "sid": "login_123"
              },
              "schema": {
                "$ref": "#/components/schemas/LaunchSessionRevocationInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "account_ref": "account_456",
                    "completed_at": "2026-10-24T05:00:00.145678Z",
                    "connection_id": "11111111-1111-4111-8111-111111111111",
                    "created_at": "2026-10-24T05:00:00.123456Z",
                    "environment": "live",
                    "event_id": "11111111-1111-4111-8111-111111111111",
                    "reason": "forced_logout",
                    "released_devices": 2,
                    "revoked_credentials": 2,
                    "revoked_sessions": 2,
                    "scope": "session",
                    "sid": "login_123",
                    "status": "succeeded"
                  },
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LaunchSessionRevocation",
                      "description": "এই কাজের ফল।"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "404": {
            "description": "এই টেন্যান্টে সংযোগ নেই"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "415": {
            "description": "Content-Type: application/json ব্যবহার করুন"
          },
          "500": {
            "description": "ডেটাবেস ব্যর্থতা বা অজানা ফল; ID বা বডি না বদলে মূল ইভেন্ট জিজ্ঞাসা বা পুনঃপ্রচেষ্টা করুন"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [
          {
            "managementKey": []
          },
          {
            "session": []
          }
        ],
        "summary": "একটি Launch লগইন বা সব অ্যাকাউন্ট অনুমোদন সেশন প্রত্যাহার করুন",
        "tags": [
          "Launch account licensing"
        ],
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/launch/connections/{id}/session-revocations/{event}": {
      "get": {
        "description": "এই টেন্যান্ট ও সংযোগের মূল স্থায়ী রসিদ ফেরত দেয়। HTTP 404 মানে কোনো কমিট ফল বর্তমানে দৃশ্যমান নয়; একই event_id ও বডি দিয়ে মূল POST পুনঃপ্রচেষ্টা করুন। অ্যাসিঙ্ক্রোনাস ওয়ার্কার প্রয়োজন নেই।",
        "operationId": "launch_get__api_v1_launch_connections_id_session_revocations_event_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "event",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "account_ref": "account_456",
                    "completed_at": "2026-10-24T05:00:00.145678Z",
                    "connection_id": "11111111-1111-4111-8111-111111111111",
                    "created_at": "2026-10-24T05:00:00.123456Z",
                    "environment": "live",
                    "event_id": "11111111-1111-4111-8111-111111111111",
                    "reason": "forced_logout",
                    "released_devices": 2,
                    "revoked_credentials": 2,
                    "revoked_sessions": 2,
                    "scope": "session",
                    "sid": "login_123",
                    "status": "succeeded"
                  },
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LaunchSessionRevocation",
                      "description": "এই কাজের ফল।"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "404": {
            "description": "এই টেন্যান্ট ও সংযোগে কোনো কমিট ফল নেই"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "500": {
            "description": "ডেটাবেস ব্যর্থতা বা অজানা ফল; ID বা বডি না বদলে মূল ইভেন্ট জিজ্ঞাসা বা পুনঃপ্রচেষ্টা করুন"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [
          {
            "managementKey": []
          },
          {
            "session": []
          }
        ],
        "summary": "কমিট করা Launch সেশন প্রত্যাহারের ফল জিজ্ঞাসা করুন",
        "tags": [
          "Launch account licensing"
        ],
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/launch/device-operations/{operation}": {
      "get": {
        "description": "দূরবর্তী রিলিজ অগ্রগতি পড়ুন। সিদ্ধান্ত, পুনঃপ্রচেষ্টা ও পরিসর পরীক্ষা Licentivo করে।",
        "operationId": "launch_get__api_v1_launch_device_operations_operation_",
        "parameters": [
          {
            "in": "path",
            "name": "operation",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "activation_id": "11111111-1111-4111-8111-111111111111",
                    "expected_generation": 1,
                    "license_id": "11111111-1111-4111-8111-111111111111",
                    "operation_id": "11111111-1111-4111-8111-111111111111",
                    "source": "logout",
                    "status": "pending"
                  },
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/DeviceReleaseOperation",
                      "description": "এই কাজের ফল।"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [
          {
            "managementKey": []
          },
          {
            "session": []
          }
        ],
        "summary": "দূরবর্তী রিলিজ অগ্রগতি পড়ুন",
        "tags": [
          "Launch account licensing"
        ],
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/launch/device-operations/{operation}/retry": {
      "post": {
        "description": "manual_review কাজের জন্য owner-এর approve=true প্রয়োজন। অনুমোদন মূল বাইন্ডিং সংস্করণ কখনো এড়ায় না।",
        "operationId": "launch_post__api_v1_launch_device_operations_operation_retry",
        "parameters": [
          {
            "in": "path",
            "name": "operation",
            "required": true,
            "schema": {
              "description": "Licentivo রিসোর্স UUID।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {},
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "approve": {
                    "description": "এই বিশ্বাস সংযোগ নতুন রানটাইম ব্যবহার অনুমোদন করতে পারে কি না।",
                    "type": "boolean"
                  }
                },
                "required": [],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {},
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "additionalProperties": false,
                      "description": "এই কাজের ফল।",
                      "properties": {
                        "queued": {
                          "description": "এই বিশ্বাস সংযোগ নতুন রানটাইম ব্যবহার অনুমোদন করতে পারে কি না।",
                          "type": "boolean"
                        }
                      },
                      "required": [],
                      "type": "object"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [
          {
            "managementKey": []
          },
          {
            "session": []
          }
        ],
        "summary": "পর্যালোচিত রিলিজ পুনঃপ্রচেষ্টা বা স্পষ্ট অনুমোদন করুন",
        "tags": [
          "Launch account licensing"
        ],
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/launch/exchange": {
      "post": {
        "description": "Idempotency-Key বাধ্যতামূলক। JWT হেডারে alg=Ed25519, typ=licentivo-launch-identity+jwt ও পিন করা kid; নির্ভুল iss/aud/environment, sub, sid, jti, iat, nbf, exp, auth_time, session_exp, launch_product_id, product_id ও entitlement_ref প্রয়োজন। assertion সর্বাধিক 120 সেকেন্ড বৈধ। রিপ্লে একই অনুরোধ ও idempotency কী দিয়ে শুধু একই সক্রিয় ডিভাইস সেশন পুনরুদ্ধার করে। ক্রয় কেবল Licentivo থেকে পড়া হয়।",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "description": "এই Launch অনুমোদন কাজের Idempotency-Key।",
              "maxLength": 80,
              "minLength": 1,
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                "environment": "live",
                "identity_token": "identity_token_example",
                "launch_connection_id": "11111111-1111-4111-8111-111111111111",
                "product_id": "11111111-1111-4111-8111-111111111111"
              },
              "schema": {
                "$ref": "#/components/schemas/LaunchExchangeInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "activation_id": "11111111-1111-4111-8111-111111111111"
                  },
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/RuntimeResult",
                      "description": "এই কাজের ফল।"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [],
        "summary": "ডিভাইস অনুমোদনের জন্য Launch অ্যাকাউন্ট পরিচয় বিনিময় করুন",
        "tags": [
          "Launch account licensing"
        ]
      }
    },
    "/api/v1/legal/policy": {
      "get": {
        "description": "সমর্থিত সব 13 ভাষায় স্থির পরিষেবা, রিফান্ড ও গোপনীয়তা নথি ফেরত দেয়। নিশ্চিত নয় এমন ঐচ্ছিক প্রোফাইল বিবরণ বাদ যায়। প্রকাশিত সংস্করণে স্পষ্ট সম্মতি প্রয়োজন; প্রথম প্রকাশ পর্যন্ত বিদ্যমান প্রবাহ চলে।",
        "operationId": "get__api_v1_legal_policy",
        "parameters": [
          {
            "in": "query",
            "name": "version",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "locale",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CommercePolicy"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [],
        "summary": "অপরিবর্তনীয় আইনি নীতি পড়ুন"
      }
    },
    "/api/v1/licenses": {
      "get": {
        "operationId": "get_api_v1_licenses",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "product_id",
            "schema": {
              "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "q",
            "schema": {
              "description": "অনুসন্ধান পাঠ্য; লক্ষ্য ফিল্ড ও সর্বাধিক দৈর্ঘ্য কাজের ওপর নির্ভর করে।",
              "maxLength": 254,
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "status",
            "schema": {
              "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
              "enum": [
                "active",
                "expired",
                "suspended",
                "revoked"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "created_at": "2026-10-18T00:00:00Z",
                        "customer": "Order #1001",
                        "duration_days": 30,
                        "expires_at": null,
                        "features": [
                          "export"
                        ],
                        "first_activated_at": null,
                        "id": "33333333-3333-4333-8333-333333333333",
                        "key_prefix": "lv_lic_AAAAAAA",
                        "max_devices": 1,
                        "mode": "timed",
                        "policy_id": "22222222-2222-4222-8222-222222222222",
                        "policy_version": 1,
                        "product_id": "11111111-1111-4111-8111-111111111111",
                        "status": "active",
                        "updated_at": "2026-10-18T00:00:00Z"
                      }
                    ],
                    "limit": 25,
                    "offset": 0,
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LicenseList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "লাইসেন্স তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "licenses"
        },
        "x-required-scope": "read"
      },
      "post": {
        "description": "Owner সেশন বা সক্রিয় Owner-এর write key প্রয়োজন। Idempotency-Key স্বয়ংক্রিয় পুনঃপ্রচেষ্টা নেই।",
        "operationId": "post_api_v1_licenses",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "customer": "Order #1001",
                "customer_email": "buyer@example.com",
                "duration_days": 30,
                "policy_id": "22222222-2222-4222-8222-222222222222",
                "product_id": "11111111-1111-4111-8111-111111111111"
              },
              "schema": {
                "$ref": "#/components/schemas/LicenseCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "duration_days": 30,
                    "expires_at": null,
                    "first_activated_at": null,
                    "id": "33333333-3333-4333-8333-333333333333",
                    "key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
                    "key_prefix": "lv_lic_AAAAAAA"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LicenseSecret",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "লাইসেন্স ইস্যু করুন",
        "x-management-reference": {
          "group": "licenses"
        },
        "x-request-variants": [
          {
            "name": "timed",
            "request": {
              "customer": "Order #1001",
              "customer_email": "buyer@example.com",
              "duration_days": 30,
              "policy_id": "22222222-2222-4222-8222-222222222222",
              "product_id": "11111111-1111-4111-8111-111111111111"
            },
            "response": {
              "data": {
                "duration_days": 30,
                "expires_at": null,
                "first_activated_at": null,
                "id": "33333333-3333-4333-8333-333333333333",
                "key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
                "key_prefix": "lv_lic_AAAAAAA"
              },
              "request_id": "55555555-5555-4555-8555-555555555555"
            }
          },
          {
            "name": "perpetual",
            "request": {
              "customer": "Order #1001",
              "customer_email": "buyer@example.com",
              "duration_days": null,
              "policy_id": "22222222-2222-4222-8222-222222222223",
              "product_id": "11111111-1111-4111-8111-111111111111"
            },
            "response": {
              "data": {
                "duration_days": null,
                "expires_at": null,
                "first_activated_at": null,
                "id": "33333333-3333-4333-8333-333333333333",
                "key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
                "key_prefix": "lv_lic_AAAAAAA"
              },
              "request_id": "55555555-5555-4555-8555-555555555555"
            }
          }
        ],
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/licenses/batch": {
      "post": {
        "description": "নীতি প্রয়োগে লাইসেন্স মোড বা মেয়াদ কখনো বদলায় না। প্রতিটি timed/trial লাইসেন্স তৈরিতে তার এন্ট্রি বা সাধারণ ব্যাচ ফিল্ড থেকে স্পষ্ট মেয়াদ প্রয়োজন। Launch-পরিচালিত লাইসেন্স স্বাধীন একক বা ব্যাচ নবায়ন HTTP 409 LAUNCH_VALIDITY_MANAGED দিয়ে প্রত্যাখ্যান করে; Launch-এ ক্রয় নবায়ন করে নির্দিষ্ট বৈধতা সিঙ্ক করুন। মিশ্র নবায়ন ব্যাচ সম্পূর্ণ রোলব্যাক হয়।",
        "operationId": "post_api_v1_licenses_batch",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "duration_days": 30,
                "entries": [
                  {
                    "customer": "Order #1001",
                    "customer_email": "buyer@example.com"
                  }
                ],
                "operation": "create",
                "policy_id": "22222222-2222-4222-8222-222222222222",
                "product_id": "11111111-1111-4111-8111-111111111111",
                "request_id": "55555555-5555-4555-8555-555555555555"
              },
              "schema": {
                "$ref": "#/components/schemas/BatchInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "count": 1,
                    "items": [
                      {
                        "customer": "Order #1001",
                        "customer_email": "buyer@example.com",
                        "duration_days": 30,
                        "expires_at": null,
                        "first_activated_at": null,
                        "id": "33333333-3333-4333-8333-333333333333",
                        "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
                      }
                    ],
                    "operation": "create",
                    "request_id": "55555555-5555-4555-8555-555555555555"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/BatchResult",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "লাইসেন্স ব্যাচ",
        "x-management-reference": {
          "group": "licenses"
        },
        "x-request-variants": [
          {
            "name": "create",
            "request": {
              "duration_days": 30,
              "entries": [
                {
                  "customer": "Order #1001",
                  "customer_email": "buyer@example.com"
                }
              ],
              "operation": "create",
              "policy_id": "22222222-2222-4222-8222-222222222222",
              "product_id": "11111111-1111-4111-8111-111111111111",
              "request_id": "55555555-5555-4555-8555-555555555555"
            },
            "response": {
              "data": {
                "count": 1,
                "items": [
                  {
                    "customer": "Order #1001",
                    "customer_email": "buyer@example.com",
                    "duration_days": 30,
                    "expires_at": null,
                    "first_activated_at": null,
                    "id": "33333333-3333-4333-8333-333333333333",
                    "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
                  }
                ],
                "operation": "create",
                "request_id": "55555555-5555-4555-8555-555555555555"
              },
              "request_id": "55555555-5555-4555-8555-555555555555"
            }
          },
          {
            "name": "renew",
            "request": {
              "days": 30,
              "ids": [
                "33333333-3333-4333-8333-333333333333"
              ],
              "operation": "renew",
              "request_id": "55555555-5555-4555-8555-555555555555"
            },
            "response": {
              "data": {
                "count": 1,
                "items": [
                  {
                    "id": "33333333-3333-4333-8333-333333333333",
                    "operation": "renew"
                  }
                ],
                "operation": "renew",
                "request_id": "55555555-5555-4555-8555-555555555555"
              },
              "request_id": "55555555-5555-4555-8555-555555555555"
            }
          },
          {
            "name": "revoke",
            "request": {
              "ids": [
                "33333333-3333-4333-8333-333333333333"
              ],
              "operation": "revoke",
              "request_id": "55555555-5555-4555-8555-555555555555"
            },
            "response": {
              "data": {
                "count": 1,
                "items": [
                  {
                    "id": "33333333-3333-4333-8333-333333333333",
                    "operation": "revoke"
                  }
                ],
                "operation": "revoke",
                "request_id": "55555555-5555-4555-8555-555555555555"
              },
              "request_id": "55555555-5555-4555-8555-555555555555"
            }
          },
          {
            "name": "apply_policy",
            "request": {
              "ids": [
                "33333333-3333-4333-8333-333333333333"
              ],
              "operation": "apply_policy",
              "policy_id": "22222222-2222-4222-8222-222222222222",
              "preview_token": "REPLACE_WITH_THE_UNEXPIRED_PREVIEW_TOKEN",
              "request_id": "55555555-5555-4555-8555-555555555555"
            },
            "response": {
              "data": {
                "count": 1,
                "items": [
                  {
                    "id": "33333333-3333-4333-8333-333333333333",
                    "operation": "apply_policy"
                  }
                ],
                "operation": "apply_policy",
                "request_id": "55555555-5555-4555-8555-555555555555"
              },
              "request_id": "55555555-5555-4555-8555-555555555555"
            }
          }
        ],
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/licenses/export.csv": {
      "get": {
        "operationId": "get_api_v1_licenses_export_csv",
        "parameters": [
          {
            "in": "query",
            "name": "product_id",
            "schema": {
              "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "q",
            "schema": {
              "description": "অনুসন্ধান পাঠ্য; লক্ষ্য ফিল্ড ও সর্বাধিক দৈর্ঘ্য কাজের ওপর নির্ভর করে।",
              "maxLength": 254,
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "status",
            "schema": {
              "description": "বর্তমান রিসোর্স অবস্থা; enum ও কাজের নোট দেখুন।",
              "enum": [
                "active",
                "expired",
                "suspended",
                "revoked"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "text/csv": {
                "example": "id,product_id,key_prefix,customer,mode,status,max_devices,expires_at\n",
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "413": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "EXPORT_TOO_LARGE",
                    "message": "Filter the export to at most 5000 records"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "সর্বাধিক 5000 রেকর্ড ফিল্টার করুন"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "লাইসেন্স এক্সপোর্ট করুন",
        "x-csv-columns": [
          "id",
          "product_id",
          "key_prefix",
          "customer",
          "mode",
          "status",
          "max_devices",
          "expires_at"
        ],
        "x-management-reference": {
          "group": "licenses"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/licenses/policy-preview": {
      "post": {
        "description": "নীতি প্রয়োগে লাইসেন্স মোড বা মেয়াদ কখনো বদলায় না। প্রতিটি timed/trial লাইসেন্স তৈরিতে তার এন্ট্রি বা সাধারণ ব্যাচ ফিল্ড থেকে স্পষ্ট মেয়াদ প্রয়োজন।",
        "operationId": "post_api_v1_licenses_policy-preview",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "ids": [
                  "33333333-3333-4333-8333-333333333333"
                ],
                "policy_id": "22222222-2222-4222-8222-222222222222"
              },
              "schema": {
                "$ref": "#/components/schemas/PreviewInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "changes": [],
                    "expires_in": 600,
                    "note": "",
                    "policy_version": 1,
                    "preview_token": ""
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PolicyPreview",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "নীতি প্রয়োগ প্রিভিউ করুন",
        "x-management-reference": {
          "group": "licenses"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/licenses/{id}": {
      "delete": {
        "operationId": "delete_api_v1_licenses_by_id",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ID",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "লাইসেন্স আর্কাইভ",
        "x-management-reference": {
          "group": "licenses"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      },
      "get": {
        "operationId": "get_api_v1_licenses_by_id",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "created_at": "2026-10-18T00:00:00Z",
                    "customer": "Order #1001",
                    "duration_days": 30,
                    "expires_at": null,
                    "features": [
                      "export"
                    ],
                    "first_activated_at": null,
                    "id": "33333333-3333-4333-8333-333333333333",
                    "key_prefix": "lv_lic_AAAAAAA",
                    "max_devices": 1,
                    "mode": "timed",
                    "policy_id": "22222222-2222-4222-8222-222222222222",
                    "policy_version": 1,
                    "product_id": "11111111-1111-4111-8111-111111111111",
                    "status": "active",
                    "updated_at": "2026-10-18T00:00:00Z"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/License",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "লাইসেন্স পড়ুন",
        "x-management-reference": {
          "group": "licenses"
        },
        "x-required-scope": "read"
      },
      "patch": {
        "operationId": "patch_api_v1_licenses_by_id",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "status": "suspended"
              },
              "schema": {
                "$ref": "#/components/schemas/LicenseUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ID",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "লাইসেন্স আপডেট করুন",
        "x-management-reference": {
          "group": "licenses"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/licenses/{id}/capabilities": {
      "get": {
        "operationId": "get_api_v1_licenses_by_id_capabilities",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "customer_email": "buyer@example.com",
                    "license": {
                      "license_id": "33333333-3333-4333-8333-333333333333",
                      "license_model": "node_locked",
                      "maintenance_days": 0,
                      "maintenance_until": null,
                      "max_version": "",
                      "min_version": "",
                      "product_id": "11111111-1111-4111-8111-111111111111",
                      "updated_at": "2026-10-18T00:00:00Z"
                    },
                    "meter_rules": [],
                    "usage": null
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LicenseCapabilityResult",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "লাইসেন্সের সক্ষমতা পড়ুন",
        "x-management-reference": {
          "group": "licenses"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/licenses/{id}/customer": {
      "patch": {
        "operationId": "patch_api_v1_licenses_by_id_customer",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "email": "buyer@example.com",
                "name": "Sample customer"
              },
              "schema": {
                "$ref": "#/components/schemas/CustomerAssignment"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ID",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "গ্রাহক নির্ধারণ করুন",
        "x-management-reference": {
          "group": "licenses"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/licenses/{id}/maintenance/renew": {
      "post": {
        "operationId": "post_api_v1_licenses_by_id_maintenance_renew",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "days": 30
              },
              "schema": {
                "$ref": "#/components/schemas/Renew"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "license_id": "33333333-3333-4333-8333-333333333333",
                    "license_model": "node_locked",
                    "maintenance_days": 0,
                    "maintenance_until": null,
                    "max_version": "",
                    "min_version": "",
                    "product_id": "11111111-1111-4111-8111-111111111111",
                    "updated_at": "2026-10-18T00:00:00Z"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LicenseCapabilities",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "রক্ষণাবেক্ষণ নবায়ন করুন",
        "x-management-reference": {
          "group": "licenses"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/licenses/{id}/renew": {
      "post": {
        "description": "প্রথম অ্যাক্টিভেশনের আগে নবায়ন duration_days বাড়ায়। অ্যাক্টিভেশনের পরে বর্তমান সময় ও expires_at-এর মধ্যে পরেরটি থেকে সম্প্রসারণ শুরু হয়; মেয়াদোত্তীর্ণ লাইসেন্স কেনা সম্প্রসারণ সময় হারায় না। Launch-পরিচালিত লাইসেন্স স্বাধীন একক বা ব্যাচ নবায়ন HTTP 409 LAUNCH_VALIDITY_MANAGED দিয়ে প্রত্যাখ্যান করে; Launch-এ ক্রয় নবায়ন করে নির্দিষ্ট বৈধতা সিঙ্ক করুন। মিশ্র নবায়ন ব্যাচ সম্পূর্ণ রোলব্যাক হয়।",
        "operationId": "post_api_v1_licenses_by_id_renew",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "days": 30
              },
              "schema": {
                "$ref": "#/components/schemas/Renew"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "duration_days": 60,
                    "expires_at": null,
                    "id": "33333333-3333-4333-8333-333333333333"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Renewed",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "লাইসেন্স নবায়ন",
        "x-management-reference": {
          "group": "licenses"
        },
        "x-request-variants": [
          {
            "name": "before_activation",
            "request": {
              "days": 30
            },
            "response": {
              "data": {
                "duration_days": 60,
                "expires_at": null,
                "id": "33333333-3333-4333-8333-333333333333"
              },
              "request_id": "55555555-5555-4555-8555-555555555555"
            }
          },
          {
            "name": "after_activation",
            "request": {
              "days": 30
            },
            "response": {
              "data": {
                "duration_days": 30,
                "expires_at": "2026-12-17T00:00:00Z",
                "id": "33333333-3333-4333-8333-333333333333"
              },
              "request_id": "55555555-5555-4555-8555-555555555555"
            }
          }
        ],
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/licenses/{id}/reveal-key": {
      "post": {
        "description": "Requires an active Owner browser session and CSRF token. Management API keys and read-only members are forbidden. Keys are encrypted at rest and each view is audited without recording the secret. Ordinary lists, details and CSV exports contain only the prefix. Older encrypted batch/onboarding receipts are recovered during migration. Older hash-only issuances return LICENSE_KEY_UNAVAILABLE (409); Launch account licenses return LICENSE_KEY_NOT_APPLICABLE (409). Viewing does not rotate the key or change validity, devices or usage.",
        "operationId": "post_api_v1_licenses_by_id_reveal-key",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LicenseKeyReveal"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "View the original license key",
        "x-required-role": "owner"
      }
    },
    "/api/v1/licenses/{id}/revoke": {
      "post": {
        "operationId": "post_api_v1_licenses_by_id_revoke",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {},
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ID",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "লাইসেন্স বাতিল",
        "x-management-reference": {
          "group": "licenses"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/members": {
      "get": {
        "operationId": "get_api_v1_members",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/MemberList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "get /members",
        "x-required-role": "owner"
      },
      "post": {
        "operationId": "post_api_v1_members",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Invite"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Invited"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "post /members",
        "x-required-role": "owner"
      }
    },
    "/api/v1/members/{id}": {
      "patch": {
        "operationId": "patch_api_v1_members_by_id",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MemberUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ID"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "patch /members/{id}",
        "x-required-role": "owner"
      }
    },
    "/api/v1/offline/respond": {
      "post": {
        "operationId": "post_api_v1_offline_respond",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "activation_id": "44444444-4444-4444-8444-444444444444",
                "app_version": "1.0.0",
                "created_at": 1792281600,
                "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                "device_name": "Office PC",
                "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
                "operation": "deactivate",
                "product_id": "11111111-1111-4111-8111-111111111111",
                "request_id": "55555555-5555-4555-8555-555555555555",
                "version": 1
              },
              "schema": {
                "$ref": "#/components/schemas/OfflineRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "operation": "deactivate",
                    "request_id": "55555555-5555-4555-8555-555555555555",
                    "result": {
                      "activation_id": "44444444-4444-4444-8444-444444444444",
                      "deactivated": true
                    },
                    "version": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/OfflineResponse",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "অফলাইন প্রতিক্রিয়া ইস্যু করুন",
        "x-management-reference": {
          "group": "integration"
        },
        "x-request-variants": [
          {
            "name": "activate",
            "request": {
              "app_version": "1.0.0",
              "created_at": 1792281600,
              "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
              "device_name": "Office PC",
              "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
              "operation": "activate",
              "product_id": "11111111-1111-4111-8111-111111111111",
              "request_id": "55555555-5555-4555-8555-555555555555",
              "version": 1
            },
            "response": {
              "data": {
                "operation": "activate",
                "request_id": "55555555-5555-4555-8555-555555555555",
                "result": {
                  "activation_id": "44444444-4444-4444-8444-444444444444",
                  "device_key": "lv_dev_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
                  "heartbeat_seconds": 600,
                  "lease": {
                    "key_id": "66666666-6666-4666-8666-666666666666",
                    "payload": "BASE64URL_ENCODED_SIGNED_CLAIMS",
                    "signature": "BASE64URL_ED25519_SIGNATURE",
                    "version": 1
                  }
                },
                "version": 1
              },
              "request_id": "55555555-5555-4555-8555-555555555555"
            }
          },
          {
            "name": "deactivate",
            "request": {
              "activation_id": "44444444-4444-4444-8444-444444444444",
              "app_version": "1.0.0",
              "created_at": 1792281600,
              "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
              "device_name": "Office PC",
              "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
              "operation": "deactivate",
              "product_id": "11111111-1111-4111-8111-111111111111",
              "request_id": "55555555-5555-4555-8555-555555555555",
              "version": 1
            },
            "response": {
              "data": {
                "operation": "deactivate",
                "request_id": "55555555-5555-4555-8555-555555555555",
                "result": {
                  "activation_id": "44444444-4444-4444-8444-444444444444",
                  "deactivated": true
                },
                "version": 1
              },
              "request_id": "55555555-5555-4555-8555-555555555555"
            }
          }
        ],
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/onboarding": {
      "post": {
        "operationId": "post_api_v1_onboarding",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "duration_days": 7,
                "mode": "trial",
                "name": "Report app",
                "request_id": "55555555-5555-4555-8555-555555555555"
              },
              "schema": {
                "$ref": "#/components/schemas/OnboardingInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "config": {
                      "allow_http": false,
                      "app_version": "1.0.0",
                      "base_url": "https://license.example.com",
                      "cache_path": "",
                      "device_name": "My application",
                      "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
                      "product_id": "11111111-1111-4111-8111-111111111111",
                      "trusted_keys": {
                        "66666666-6666-4666-8666-666666666666": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
                      }
                    },
                    "license_id": "33333333-3333-4333-8333-333333333333",
                    "license_key": "lv_lic_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
                    "next": "Choose a language and download the configured SDK bundle.",
                    "policy_id": "22222222-2222-4222-8222-222222222222",
                    "product_id": "11111111-1111-4111-8111-111111111111"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/OnboardingResult",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ইন্টিগ্রেশন রিসোর্স তৈরি করুন",
        "x-management-reference": {
          "group": "integration"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/payments/paddle/webhook": {
      "post": {
        "operationId": "post__api_v1_payments_paddle_webhook",
        "parameters": [
          {
            "in": "header",
            "name": "Paddle-Signature",
            "required": true,
            "schema": {
              "description": "পেমেন্ট পরিষেবার প্রদর্শন নাম।",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PaddleWebhookEvent"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WebhookReceived"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [],
        "summary": "Paddle স্বাক্ষর যাচাই করে সম্পন্ন পেমেন্ট বা সমন্বয় মিলন করুন",
        "x-licentivo-access": "public"
      }
    },
    "/api/v1/payments/paypal/webhook": {
      "post": {
        "operationId": "post_api_v1_payments_paypal_webhook",
        "parameters": [
          {
            "in": "header",
            "name": "Paypal-Auth-Algo",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Paypal-Cert-Url",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Paypal-Transmission-Id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Paypal-Transmission-Sig",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Paypal-Transmission-Time",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookEvent"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WebhookReceived"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "যাচাইকৃত ক্যাপচার/রিফান্ড/রিভার্সাল বিজ্ঞপ্তি"
      }
    },
    "/api/v1/payments/waffo/webhook": {
      "post": {
        "operationId": "post__api_v1_payments_waffo_webhook",
        "parameters": [
          {
            "in": "header",
            "name": "X-Waffo-Signature",
            "required": true,
            "schema": {
              "description": "MER_ দিয়ে শুরু বিক্রেতা শনাক্তকারী।",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WaffoWebhookEvent"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WebhookReceived"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [],
        "summary": "Waffo স্বাক্ষর যাচাই করে পেমেন্ট বা রিফান্ড মিলন করুন",
        "x-licentivo-access": "public"
      }
    },
    "/api/v1/policies": {
      "get": {
        "operationId": "get_api_v1_policies",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "product_id",
            "schema": {
              "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "created_at": "2026-10-18T00:00:00Z",
                        "features": [
                          "export"
                        ],
                        "heartbeat_seconds": 600,
                        "id": "22222222-2222-4222-8222-222222222222",
                        "max_devices": 1,
                        "mode": "timed",
                        "name": "One device",
                        "offline_mode": "limited",
                        "offline_seconds": 86400,
                        "product_id": "11111111-1111-4111-8111-111111111111",
                        "updated_at": "2026-10-18T00:00:00Z",
                        "version": 1
                      }
                    ],
                    "limit": 25,
                    "offset": 0,
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PolicyList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "নীতি তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "policies"
        },
        "x-required-scope": "read"
      },
      "post": {
        "description": "Owner সেশন বা সক্রিয় Owner-এর write key প্রয়োজন। Idempotency-Key স্বয়ংক্রিয় পুনঃপ্রচেষ্টা নেই।",
        "operationId": "post_api_v1_policies",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "features": [
                  "export"
                ],
                "heartbeat_seconds": 600,
                "max_devices": 1,
                "mode": "timed",
                "name": "One device",
                "offline_mode": "limited",
                "offline_seconds": 86400,
                "product_id": "11111111-1111-4111-8111-111111111111"
              },
              "schema": {
                "$ref": "#/components/schemas/PolicyCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ID",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "নীতি তৈরি",
        "x-management-reference": {
          "group": "policies"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/policies/{id}": {
      "delete": {
        "operationId": "delete_api_v1_policies_by_id",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ID",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "নীতি আর্কাইভ",
        "x-management-reference": {
          "group": "policies"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      },
      "get": {
        "operationId": "get_api_v1_policies_by_id",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "created_at": "2026-10-18T00:00:00Z",
                    "features": [
                      "export"
                    ],
                    "heartbeat_seconds": 600,
                    "id": "22222222-2222-4222-8222-222222222222",
                    "max_devices": 1,
                    "mode": "timed",
                    "name": "One device",
                    "offline_mode": "limited",
                    "offline_seconds": 86400,
                    "product_id": "11111111-1111-4111-8111-111111111111",
                    "updated_at": "2026-10-18T00:00:00Z",
                    "version": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Policy",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "নীতি পড়ুন",
        "x-management-reference": {
          "group": "policies"
        },
        "x-required-scope": "read"
      },
      "patch": {
        "description": "নীতি ও সংশ্লিষ্ট প্রতিটি অপ্রত্যাহৃত লাইসেন্স স্ন্যাপশট পরমাণুভাবে আপডেট করুন। বিদ্যমান লাইসেন্স শর্ত, প্রতিশ্রুত ব্যবহার ও পৃথক রক্ষণাবেক্ষণ সম্প্রসারণ থাকে। synced_licenses ফেরত দেয়। ACTIVE_DEVICES_CONFLICT সম্পূর্ণ সংরক্ষণ রোলব্যাক করে।",
        "operationId": "patch_api_v1_policies_by_id",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "max_devices": 2
              },
              "schema": {
                "$ref": "#/components/schemas/PolicyUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333",
                    "synced_licenses": 0
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PolicySyncResult",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "মৌলিক নীতি আপডেট করুন",
        "x-management-reference": {
          "group": "policies"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/policies/{id}/capabilities": {
      "get": {
        "operationId": "get_api_v1_policies_by_id_capabilities",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "allow_vm": true,
                    "device_match": "system",
                    "license_model": "node_locked",
                    "maintenance_days": 0,
                    "max_version": "",
                    "meter_rules": [],
                    "min_version": "",
                    "policy_id": "22222222-2222-4222-8222-222222222222",
                    "policy_version": 1,
                    "product_id": "11111111-1111-4111-8111-111111111111",
                    "require_hardware": false,
                    "self_release_limit": 3,
                    "session_seconds": 7200,
                    "updated_at": "2026-10-18T00:00:00Z"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PolicyCapabilities",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "নীতির সক্ষমতা পড়ুন",
        "x-management-reference": {
          "group": "policies"
        },
        "x-required-scope": "read"
      },
      "patch": {
        "description": "বর্তমান policy_version ব্যবহার করুন। ইস্যু করা শর্ত, প্রতিশ্রুত ব্যবহার ও পৃথক রক্ষণাবেক্ষণ সম্প্রসারণ বজায় রেখে নীতি ও সংশ্লিষ্ট প্রতিটি অপ্রত্যাহৃত লাইসেন্স স্ন্যাপশট পরমাণুভাবে আপডেট করুন। synced_licenses ফেরত দেয়। POLICY_CHANGED বা ACTIVE_DEVICES_CONFLICT সম্পূর্ণ সংরক্ষণ রোলব্যাক করে।",
        "operationId": "patch_api_v1_policies_by_id_capabilities",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "license_model": "node_locked",
                "meter_rules": [
                  {
                    "allow_overage": false,
                    "feature": "export",
                    "limit": 500,
                    "max_overage": 0,
                    "period": "month"
                  }
                ],
                "policy_version": 1
              },
              "schema": {
                "$ref": "#/components/schemas/PolicyCapabilitiesInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333",
                    "synced_licenses": 0
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PolicySyncResult",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "নীতির সক্ষমতা আপডেট করুন",
        "x-management-reference": {
          "group": "policies"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/products": {
      "get": {
        "operationId": "get_api_v1_products",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "q",
            "schema": {
              "description": "অনুসন্ধান পাঠ্য; লক্ষ্য ফিল্ড ও সর্বাধিক দৈর্ঘ্য কাজের ওপর নির্ভর করে।",
              "maxLength": 120,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "created_at": "2026-10-18T00:00:00Z",
                        "description": "Desktop reporting software",
                        "id": "11111111-1111-4111-8111-111111111111",
                        "name": "Report app",
                        "status": "active",
                        "updated_at": "2026-10-18T00:00:00Z"
                      }
                    ],
                    "limit": 25,
                    "offset": 0,
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ProductList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "পণ্য তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "products"
        },
        "x-required-scope": "read"
      },
      "post": {
        "description": "Owner সেশন বা সক্রিয় Owner-এর write key প্রয়োজন। Idempotency-Key স্বয়ংক্রিয় পুনঃপ্রচেষ্টা নেই।",
        "operationId": "post_api_v1_products",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "description": "Desktop reporting software",
                "name": "Report app"
              },
              "schema": {
                "$ref": "#/components/schemas/ProductCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ID",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "পণ্য তৈরি",
        "x-management-reference": {
          "group": "products"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/products/{id}": {
      "delete": {
        "operationId": "delete_api_v1_products_by_id",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ID",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "পণ্য আর্কাইভ",
        "x-management-reference": {
          "group": "products"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      },
      "get": {
        "operationId": "get_api_v1_products_by_id",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "created_at": "2026-10-18T00:00:00Z",
                    "description": "Desktop reporting software",
                    "id": "11111111-1111-4111-8111-111111111111",
                    "name": "Report app",
                    "status": "active",
                    "updated_at": "2026-10-18T00:00:00Z"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Product",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "পণ্য পড়ুন",
        "x-management-reference": {
          "group": "products"
        },
        "x-required-scope": "read"
      },
      "patch": {
        "operationId": "patch_api_v1_products_by_id",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "name": "Report app Pro",
                "status": "active"
              },
              "schema": {
                "$ref": "#/components/schemas/ProductUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ID",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "পণ্য আপডেট করুন",
        "x-management-reference": {
          "group": "products"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/products/{id}/public-keys": {
      "get": {
        "operationId": "get_api_v1_products_by_id_public-keys",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/KeyBundle"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "পণ্যের পিন করা কী বান্ডল"
      }
    },
    "/api/v1/products/{id}/releases": {
      "get": {
        "operationId": "get_api_v1_products_by_id_releases",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "channel": "stable",
                        "created_at": "2026-10-18T00:00:00Z",
                        "download_url": "",
                        "id": "33333333-3333-4333-8333-333333333333",
                        "notes": "Initial release",
                        "product_id": "11111111-1111-4111-8111-111111111111",
                        "published_at": "2026-10-18T00:00:00Z",
                        "sha256": "",
                        "version": "1.0.0"
                      }
                    ],
                    "limit": 25,
                    "offset": 0,
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ReleaseList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "রিলিজ তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "releases"
        },
        "x-required-scope": "read"
      },
      "post": {
        "operationId": "post_api_v1_products_by_id_releases",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "channel": "stable",
                "notes": "Initial release",
                "version": "1.0.0"
              },
              "schema": {
                "$ref": "#/components/schemas/ReleaseInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "channel": "stable",
                    "created_at": "2026-10-18T00:00:00Z",
                    "download_url": "",
                    "id": "33333333-3333-4333-8333-333333333333",
                    "notes": "Initial release",
                    "product_id": "11111111-1111-4111-8111-111111111111",
                    "published_at": "2026-10-18T00:00:00Z",
                    "sha256": "",
                    "version": "1.0.0"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Release",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "রিলিজ প্রকাশ করুন",
        "x-management-reference": {
          "group": "releases"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/products/{id}/sdk-bundle": {
      "post": {
        "operationId": "post_api_v1_products_by_id_sdk-bundle",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "language": "go"
              },
              "schema": {
                "$ref": "#/components/schemas/BundleInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/zip": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "পণ্যের উদাহরণের সোর্স ডাউনলোড করুন",
        "x-management-reference": {
          "group": "products"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/products/{id}/sdk-initializer": {
      "get": {
        "operationId": "get_api_v1_products_by_id_sdk-initializer",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "language",
            "schema": {
              "default": "go",
              "description": "ডাউনলোড বান্ডলের SDK ভাষা শনাক্তকারী।",
              "enum": [
                "go",
                "java",
                "c",
                "cpp",
                "csharp",
                "python",
                "javascript",
                "rust",
                "ruby"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "language": "go",
                    "product_id": "11111111-1111-4111-8111-111111111111",
                    "source": "const productID = \"11111111-1111-4111-8111-111111111111\"\nvar trustedKeys = map[string]string{\"66666666-6666-4666-8666-666666666666\": \"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\"}\n",
                    "trusted_keys": {
                      "66666666-6666-4666-8666-666666666666": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
                    }
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SDKInitializer",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ইনিশিয়ালাইজেশন কোড কপি করুন",
        "x-management-reference": {
          "group": "products"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/products/{id}/signing-keys": {
      "get": {
        "operationId": "get_api_v1_products_by_id_signing-keys",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "keys": [],
                    "product_id": "11111111-1111-4111-8111-111111111111"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ManagementKeyBundle",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "স্বাক্ষর কী তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "products"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/products/{id}/signing-keys/rotate": {
      "post": {
        "operationId": "post_api_v1_products_by_id_signing-keys_rotate",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {},
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "active": true,
                    "algorithm": "Ed25519",
                    "created_at": "2026-10-18T00:00:00Z",
                    "key_id": "66666666-6666-4666-8666-666666666666",
                    "public_key": "",
                    "retired_at": null
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SigningKey",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "স্বাক্ষর কী পরিবর্তন",
        "x-management-reference": {
          "group": "products"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/releases/eligible": {
      "post": {
        "description": "লাইসেন্স-প্রমাণীকৃত রানটাইম কাজ; vendor cookie বা API Key নেই। ফিচার ব্যবহারে স্থির Idempotency-Key প্রয়োজন; consume-এ প্ল্যাটফর্ম API ডেবিট হয় না।",
        "operationId": "post_api_v1_releases_eligible",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RuntimeInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/EligibleReleases"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "/releases/eligible"
      }
    },
    "/api/v1/service/status": {
      "get": {
        "description": "শুধু বৈশ্বিক বিজ্ঞপ্তি প্রকাশ্য; লক্ষ্য ওয়ার্কস্পেস ID প্রকাশ হয় না।",
        "operationId": "get__api_v1_service_status",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ServiceIncidentList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [],
        "summary": "প্রকাশ্য রক্ষণাবেক্ষণ ও ঘটনা পড়ুন"
      }
    },
    "/api/v1/sessions/logout": {
      "post": {
        "description": "ব্রাউজার cookies বা CSRF টোকেন নেই। ডুপ্লিকেট কাজ নতুন বাইন্ডিং রিলিজ না করে রিপ্লে হয়। stale অবস্থা পুরোনো প্রত্যাহারের সফল সমাপ্তি। SDK অনুরোধ জমার আগে স্থানীয় ব্যবহার অস্বীকার ও রানটাইম ক্রেডেনশিয়াল পরিষ্কার করে।",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "activation_id": "11111111-1111-4111-8111-111111111111",
                "expected_generation": 1,
                "operation_id": "11111111-1111-4111-8111-111111111111",
                "product_id": "11111111-1111-4111-8111-111111111111",
                "release_token": "lv_out_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
              },
              "schema": {
                "$ref": "#/components/schemas/LogoutTicket"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "activation_id": "11111111-1111-4111-8111-111111111111",
                    "expected_generation": 1,
                    "license_id": "11111111-1111-4111-8111-111111111111",
                    "operation_id": "11111111-1111-4111-8111-111111111111",
                    "source": "logout",
                    "status": "pending"
                  },
                  "request_id": "request_id_example"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/DeviceReleaseOperation",
                      "description": "এই কাজের ফল।"
                    },
                    "request_id": {
                      "description": "HTTP অনুরোধ সহসম্পর্ক শনাক্তকারী।",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "গৃহীত ফল"
          },
          "400": {
            "description": "অবৈধ ইনপুট"
          },
          "401": {
            "description": "প্রমাণীকরণ বা পরিচয় assertion প্রত্যাখ্যাত"
          },
          "403": {
            "description": "অধিকার, ক্রেডেনশিয়াল, পরিবেশ বা লগইন প্রত্যাহৃত"
          },
          "409": {
            "description": "idempotency, নীতি, পর্যালোচনা বা বাইন্ডিং সংস্করণ সংঘর্ষ"
          },
          "503": {
            "description": "সাময়িক ব্যর্থতা; মূল কাজ পুনঃপ্রচেষ্টা করুন"
          }
        },
        "security": [],
        "summary": "শুধু আনলিঙ্ক টিকিট দিয়ে একটি সংস্করণযুক্ত ডিভাইস বাইন্ডিং প্রত্যাহার করুন",
        "tags": [
          "Launch account licensing"
        ]
      }
    },
    "/api/v1/summary": {
      "get": {
        "operationId": "get_api_v1_summary",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "active_licenses": 0,
                    "licenses": 0,
                    "policies": 0,
                    "products": 0
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Summary",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ওয়ার্কস্পেস গণনা",
        "x-management-reference": {
          "group": "usage"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/support/contact": {
      "get": {
        "description": "শুধু কনফিগার করা যোগাযোগ ইমেইল ফেরত দেয়; ফাঁকা মানে লুকানো। কোনো মেইল পাঠায় না।",
        "operationId": "get__api_v1_support_contact",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportContact"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [],
        "summary": "প্রকাশ্য সহায়তা ইমেইল পড়ুন"
      }
    },
    "/api/v1/system/billing-notifications": {
      "get": {
        "description": "প্রমাণীকরণ ইমেইল পরিবহন, প্রেরক, এনক্রিপ্টেড স্থায়ী সারি ও পুনঃপ্রচেষ্টা পুনর্ব্যবহার করে। কোনো ধরনের জন্য প্ল্যাটফর্ম অনুমতি ও প্রাপকের সম্মতি দুটোই প্রয়োজন। ডেলিভারিতে বর্তমান সম্মতি ও ইভেন্ট অবস্থা আবার পরীক্ষা হয়। ইমেইল পছন্দ ওয়ালেট ডেবিটের সম্মতি দেয় বা প্রত্যাহার করে না। Sandbox বার্তা চিহ্নিত। অপরিশোধিত অপেক্ষমাণ ক্রয় বা উপহারের জন্য বিজ্ঞপ্তি তৈরি হয় না।",
        "operationId": "get__api_v1_system_billing_notifications",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/BillingNotificationSettings"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "প্ল্যাটফর্ম বিলিং ইমেইল নিয়ম পড়ুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      },
      "patch": {
        "description": "আংশিক আপডেট; স্পষ্ট false মান থাকে। প্রমাণীকরণ ইমেইল পরিবহন, প্রেরক, এনক্রিপ্টেড স্থায়ী সারি ও পুনঃপ্রচেষ্টা পুনর্ব্যবহার করে। কোনো ধরনের জন্য প্ল্যাটফর্ম অনুমতি ও প্রাপকের সম্মতি দুটোই প্রয়োজন। ডেলিভারিতে বর্তমান সম্মতি ও ইভেন্ট অবস্থা আবার পরীক্ষা হয়। ইমেইল পছন্দ ওয়ালেট ডেবিটের সম্মতি দেয় বা প্রত্যাহার করে না। Sandbox বার্তা চিহ্নিত। অপরিশোধিত অপেক্ষমাণ ক্রয় বা উপহারের জন্য বিজ্ঞপ্তি তৈরি হয় না।",
        "operationId": "patch__api_v1_system_billing_notifications",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BillingNotificationSettingsInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/BillingNotificationSettings"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "বিলিং ইমেইল নিয়ম ও প্রকাশ্য সহায়তা যোগাযোগ কনফিগার করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/billing-notifications/preview": {
      "get": {
        "description": "সংরক্ষিত প্ল্যাটফর্ম সেটিং ও নমুনা sandbox ডেটা ব্যবহার করে। কোনো ক্রয় বা মেইল কাজ তৈরি হয় না।",
        "operationId": "get__api_v1_system_billing_notifications_preview",
        "parameters": [
          {
            "in": "query",
            "name": "kind",
            "required": true,
            "schema": {
              "enum": [
                "purchase_success",
                "expiry_reminder",
                "auto_renewal_success",
                "auto_renewal_problem"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "locale",
            "schema": {
              "default": "zh",
              "enum": [
                "zh",
                "zh-hant",
                "en",
                "es",
                "hi",
                "ar",
                "fr",
                "bn",
                "pt",
                "id",
                "ur"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/BillingEmailPreview"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "না পাঠিয়ে বিলিং ইমেইল প্রিভিউ করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/billing-notifications/test": {
      "post": {
        "description": "স্পষ্ট পরীক্ষা নমুনা sandbox ডেটা ব্যবহার করে, [TEST] যোগ করে ও বিদ্যমান মেইল কনফিগারেশন অনুসরণ করে। ওই গ্রাহক বিজ্ঞপ্তির ধরন নিষ্ক্রিয় হলেও টেমপ্লেট পরীক্ষা করা যায়। কোনো পেমেন্ট বা নবায়ন হয় না।",
        "operationId": "post__api_v1_system_billing_notifications_test",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BillingEmailTestInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/MailQueued"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "অনুরোধ করা বিলিং ইমেইল পরীক্ষা সারিতে দিন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/check-mail": {
      "post": {
        "description": "শুধু সংরক্ষিত পরিষেবা পরীক্ষা করুন। API প্রদানকারীর পরীক্ষা শুধু-পঠন অনুরোধ ব্যবহার করে এবং ইমেইল পাঠায় না। শুধু পাঠানোর কী থেকে check_status=limited ও ok=false আসতে পারে; এতে ক্রেডেনশিয়ালের বৈধতা বা সফল ডেলিভারি নিশ্চিত হয় না। পাঠানো পরীক্ষা করতে স্পষ্ট টেস্ট-মেইল অনুরোধ প্রয়োজন।",
        "operationId": "post_api_v1_system_check-mail",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/MailConnection"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "MAIL_PROVIDER_AUTH_FAILED, MAIL_PROVIDER_RATE_LIMITED অথবা MAIL_PROVIDER_UNAVAILABLE। পরীক্ষামূলক মেইল ডেলিভারি অ্যাসিঙ্ক্রোনাস; ত্রুটি মূল HTTP 202 প্রতিক্রিয়ার বদলে কাজের ফলে দেখা যায়।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "post /system/check-mail",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/customer/cases": {
      "get": {
        "description": "",
        "operationId": "get__api_v1_system_customer_cases",
        "parameters": [
          {
            "description": "গণনা ও পৃষ্ঠাবিন্যাসের আগে একটি অনুরোধ ধরন বাদ দিন। সহায়তা তালিকা থেকে রিফান্ড মামলা বাদ দিতে refund ব্যবহার করুন; প্রবেশ বর্তমান সেশনের পরিসরে থাকে।",
            "in": "query",
            "name": "exclude_kind",
            "schema": {
              "maxLength": 24,
              "type": "string"
            }
          },
          {
            "description": "রিফান্ড মামলা ওয়ালেট টপ-আপ বা পরিষেবা বাতিলে সীমিত করুন।",
            "in": "query",
            "name": "refund_scope",
            "required": false,
            "schema": {
              "enum": [
                "wallet",
                "service"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportCaseList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "গ্রাহক অনুরোধ তালিকাভুক্ত করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/customer/cases/unread": {
      "get": {
        "description": "রিফান্ড চ্যাট বাদ। গ্রাহক শুধু অনুমোদিত ওয়ার্কস্পেস টিকিট দেখেন; সদস্য নিজেরটি দেখেন। প্রতিটি প্রশাসকের স্বাধীন রিড ওয়াটারমার্ক আছে।",
        "operationId": "get__api_v1_system_customer_cases_unread",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportUnread"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "ব্যক্তিগত টিকিট ও বিজ্ঞপ্তির অপঠিত গণনা পড়ুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/customer/cases/{id}": {
      "get": {
        "description": "",
        "operationId": "get__api_v1_system_customer_cases__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportCaseDetail"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "অনুরোধ ও উত্তর পড়ুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/customer/cases/{id}/deletion-review": {
      "post": {
        "description": "আর্থিক দায় স্বীকার প্রয়োজন। স্বাভাবিক প্রবেশ অবিলম্বে প্রত্যাহার হয়; গ্রাহক এক্সপোর্ট ঠিক 30 দিন পরে বন্ধ হয় এবং সব ব্যবসায়িক রেকর্ড অনুমোদিত প্রশাসক এক্সপোর্টের জন্য থাকে।",
        "operationId": "post__api_v1_system_customer_cases__id__deletion_review",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountClosureReview"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportCaseDetail"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "যৌক্তিক অ্যাকাউন্ট বন্ধ নিশ্চিত বা প্রত্যাখ্যান করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/customer/cases/{id}/manual-refund": {
      "post": {
        "description": "গ্রাহকের সম্মতি ও সম্পন্ন পেমেন্টের প্রমাণ প্রয়োজন। এটি নিষ্পত্তি রেকর্ড করে; ব্যাংক স্থানান্তর পাঠায় না। পুনরায় নিশ্চিত করলে দ্বিগুণ ডেবিট হতে পারে না। পরিষেবাসহ মূল Waffo/Paddle পেমেন্ট শুধু ঘোষণাভিত্তিক পথ ORIGINAL_REFUND_REQUIRED দিয়ে প্রত্যাখ্যান করে।",
        "operationId": "post__api_v1_system_customer_cases__id__manual_refund",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ManualRefundInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportCaseDetail"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "প্রকৃত সম্পন্ন বিকল্প রিফান্ড রেকর্ড করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/customer/cases/{id}/messages": {
      "post": {
        "description": "রিফান্ড মামলা REFUND_REVIEW_WORKFLOW দিয়ে উত্তর প্রত্যাখ্যান করে; প্রশাসক সরাসরি অনুমোদন বা প্রত্যাখ্যান করেন। সাধারণ সহায়তা টিকিটে উত্তর থাকে। পর্যালোচিত বন্ধ তাদের গোপনীয়তা ওয়ার্কফ্লো অবস্থা রাখে।",
        "operationId": "post__api_v1_system_customer_cases__id__messages",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SupportReply"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportCaseDetail"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সহায়তা টিকিটে উত্তর দিন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/customer/cases/{id}/read": {
      "post": {
        "description": "শুধু সর্বশেষ দেখানো বার্তা পর্যন্ত পঠিত চিহ্নিত হয়। পরের নতুন বার্তা অপঠিত থাকে এবং বিলম্বিত স্বীকৃতি ওয়াটারমার্ক পেছাতে পারে না।",
        "operationId": "post__api_v1_system_customer_cases__id__read",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SupportReadInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CommerceResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "দেখানো টিকিট বার্তার প্রাপ্তি স্বীকার করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/customer/cases/{id}/recover-original-refund": {
      "post": {
        "description": "বাস্তবে বিকল্প স্থানান্তর হয়নি বলে প্রশাসকের স্পষ্ট নিশ্চিতকরণ প্রয়োজন। মূল প্রমাণ বজায় রেখে ক্ষতিপূরণমূলক লেজার এন্ট্রি ব্যবহার করে। মূল পেমেন্ট থেকে শুধু অবশিষ্ট অর্থ চাওয়া হয়।",
        "operationId": "post__api_v1_system_customer_cases__id__recover_original_refund",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RecoverOriginalRefund"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportCaseDetail"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "অপরিশোধিত ম্যানুয়াল ঘোষণা সংশোধন করে মূল রিফান্ড অনুরোধ করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/customer/cases/{id}/refund-quote": {
      "post": {
        "description": "নতুন পরিসর, পরিমাণ ও সময়সূচির প্রিভিউ। পরিষেবার পরিসর বদলালে নতুন গ্রাহক আবেদন প্রয়োজন; প্রশাসক পুরোনোটি সরাসরি প্রত্যাখ্যান করতে পারেন।",
        "operationId": "post__api_v1_system_customer_cases__id__refund_quote",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EmptyRefundPreviewInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ScopedRefundPreview"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "অনুমোদনের আগে অপেক্ষমাণ পরিসরযুক্ত আবেদন প্রিভিউ করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/customer/cases/{id}/refund-review": {
      "post": {
        "description": "লক্ষ্য ওয়ার্কস্পেসে ক্রমবদ্ধ করে। অনুমোদন উপলব্ধ ওয়ালেট অর্থ সংরক্ষণ করে, স্থির প্রদানকারী অনুরোধ ID দিয়ে মূল মাধ্যমে রিফান্ড বরাদ্দ করে এবং সম্মত বিকল্প দরকার এমন ব্যালেন্স রাখে। Waffo/Paddle অনুমোদন স্থায়ী মূল-প্রদানকারী রিফান্ড ইন্টেন্ট তৈরি করে ও বিক্রেতার রিফান্ড API অনুরোধ পাঠায়। কোনো ম্যানুয়াল ঘোষণা এই রিফান্ড সম্পন্ন করতে পারে না। processing/pending অনুমোদন অবস্থা নিষ্পত্তিকৃত অর্থ নয়।",
        "operationId": "post__api_v1_system_customer_cases__id__refund_review",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RefundReview"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SupportCaseDetail"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "গ্রাহক রিফান্ড অনুমোদন বা প্রত্যাখ্যান করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/legal/policy": {
      "get": {
        "description": "",
        "operationId": "get__api_v1_system_legal_policy",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CommercePolicy"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "অপারেটর প্রোফাইল ও অপেক্ষমাণ নীতি সংস্করণ পড়ুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      },
      "patch": {
        "description": "প্রকাশে অপারেটরের নিশ্চিত আইনি নাম ও বৈধ যোগাযোগ ইমেইল প্রয়োজন। অন্য প্রোফাইল বিবরণ ঐচ্ছিক এবং অনিশ্চিত বিষয় প্রকাশ্য নথি থেকে বাদ যায়। প্রকাশিত প্রতিস্থাপন অন্তত 30 দিনের কনসোল ও সফলভাবে পাঠানো ইমেইল বিজ্ঞপ্তির সময় আগের সংস্করণ বজায় রাখে।",
        "operationId": "patch__api_v1_system_legal_policy",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CommercePolicyInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CommercePolicy"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "পরিষেবা নীতি প্রকাশ বা নির্ধারণ করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/mail-jobs": {
      "get": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। সর্বশেষ 50 বার্তার ধরন, পরিবেশ, প্রাপক, প্রচেষ্টা, অবস্থা ও বাতিলের কারণ। ডেলিভারিকৃত/বাতিল পেলোড মুছে যায়। SMTP গ্রহণ ইনবক্সে ডেলিভারি বা পড়া নয়।",
        "operationId": "get_api_v1_system_mail-jobs",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/MailJobList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "get /system/mail-jobs",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/mail-jobs/{id}/retry": {
      "post": {
        "description": "প্রচেষ্টা গণনা রিসেট করে একই ব্যর্থ বার্তা সারিতে দেয়। ডেলিভারিকৃত, বাতিল, চলমান ও অপেক্ষমাণ কাজ MAIL_JOB_NOT_RETRYABLE ফেরত দেয়। বিলিং কাজ নতুন ডেলিভারি প্রচেষ্টার আগে বর্তমান সম্মতি ও ইভেন্ট অবস্থা আবার যাচাই করে। SMTP ত্রুটি কমিট করা পেমেন্ট কখনো উল্টায় না।",
        "operationId": "post__api_v1_system_mail_jobs__id__retry",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/MailQueued"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সংরক্ষিত এনক্রিপ্টেড পেলোডসহ ব্যর্থ ইমেইল পুনঃপ্রচেষ্টা করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/operations": {
      "get": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। শুধু যোগযোগ্য অ্যাপ্লিকেশন লগে কর্তা, বিষয়, কারণ ও স্পষ্ট পরিবর্তন থাকে।",
        "operationId": "get__api_v1_system_operations",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "user_id",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "action",
            "schema": {
              "maxLength": 80,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlatformOperationList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "প্রশাসনিক গ্রাহক কাজ তালিকাভুক্ত করুন"
      }
    },
    "/api/v1/system/overview": {
      "get": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। প্যাকেজ মেট্রিক বর্তমান কনফিগার করা পেমেন্ট পরিবেশ ব্যবহার করে। নতুন ব্যবহারকারী গত 30 দিন; মেয়াদ শেষ পরবর্তী 7 দিন।",
        "operationId": "get__api_v1_system_overview",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlatformOverview"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "প্ল্যাটফর্ম গ্রাহক ও প্যাকেজের মোট পড়ুন"
      }
    },
    "/api/v1/system/paddle": {
      "get": {
        "operationId": "get__api_v1_system_paddle",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PaddleSettings"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "ব্যক্তিগত কী ছাড়া Paddle কনফিগারেশন পড়ুন",
        "x-licentivo-access": "platform"
      },
      "patch": {
        "operationId": "patch__api_v1_system_paddle",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PaddleSettingsInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PaddleSettings"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "এনক্রিপ্টেড Paddle Billing ক্রেডেনশিয়াল সংরক্ষণ করুন",
        "x-licentivo-access": "platform"
      }
    },
    "/api/v1/system/paddle/check": {
      "post": {
        "operationId": "post__api_v1_system_paddle_check",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PaddleCheck"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "Paddle ক্রেডেনশিয়াল ও সক্রিয় পণ্য যাচাই করুন",
        "x-licentivo-access": "platform"
      }
    },
    "/api/v1/system/paddle/orders": {
      "get": {
        "operationId": "get__api_v1_system_paddle_orders",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PaddleOrderList"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "Paddle পরিষেবা পেমেন্ট ও ওয়ালেট টপ-আপ তালিকাভুক্ত করুন",
        "x-licentivo-access": "platform"
      }
    },
    "/api/v1/system/paddle/orders/{id}/reconcile": {
      "post": {
        "operationId": "post__api_v1_system_paddle_orders__id__reconcile",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PaddleReconcileInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PaddleOrderResult"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "নতুন চার্জ তৈরি না করে মূল লেনদেন মিলন বা পুনরুদ্ধার করুন",
        "x-licentivo-access": "platform"
      }
    },
    "/api/v1/system/payment-channels": {
      "get": {
        "operationId": "get__api_v1_system_payment_channels",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PaymentChannels"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "স্বাধীনভাবে কনফিগারযোগ্য পেমেন্ট চ্যানেল তালিকাভুক্ত করুন",
        "x-licentivo-access": "platform"
      },
      "patch": {
        "operationId": "patch__api_v1_system_payment_channels",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PaymentChannelInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PaymentChannels"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "optimistic সমবর্তী নিয়ন্ত্রণে চ্যানেল পরমাণুভাবে সক্ষম বা অক্ষম করুন",
        "x-licentivo-access": "platform"
      }
    },
    "/api/v1/system/paypal": {
      "get": {
        "operationId": "get_api_v1_system_paypal",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PayPalSettings"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "paypal",
        "x-platform-admin": true,
        "x-required-role": "owner"
      },
      "patch": {
        "operationId": "patch_api_v1_system_paypal",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PayPalInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PayPalSettings"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "paypal",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/paypal/check": {
      "post": {
        "operationId": "post_api_v1_system_paypal_check",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PayPalCheck"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "paypal/check",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/paypal/orders/{id}/refund": {
      "post": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। PayPal-এর সঙ্গে যোগাযোগের আগে উপলব্ধ অব্যবহৃত ওয়ালেট ক্রেডিট সংরক্ষণ করে। Pending মানে ফল নিশ্চিত নয়; একই অনুরোধের মিলন করুন। প্যাকেজ স্বয়ংক্রিয় বাতিল হয় না।",
        "operationId": "post__api_v1_system_paypal_orders__id__refund",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RefundInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PayPalRefund"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "অব্যবহৃত ওয়ালেট অর্থ মূল PayPal পেমেন্ট পদ্ধতিতে ফেরত দিন"
      }
    },
    "/api/v1/system/paypal/refund-requests": {
      "get": {
        "description": "শুধু cookie সেশন; ব্যবস্থাপনা API কী গ্রহণ করা হয় না। গ্রাহকের পড়া নিজস্ব ওয়ার্কস্পেসে সীমিত। গ্রাহকের লেখায় প্ল্যাটফর্ম প্রশাসক অনুমতি ছাড়া যাচাইকৃত ওয়ার্কস্পেস Owner প্রয়োজন। আবেদন অর্থ সরায় বা সংরক্ষণ করে না। প্রশাসকের অনুমোদন বর্তমান ওয়ালেট ও অপরিশোধিত রিফান্ডযোগ্য ক্যাপচার মূল্য আবার পরীক্ষা করে, তারপর বিদ্যমান idempotent মূল-মাধ্যম রিফান্ড ও সংরক্ষণ প্রক্রিয়া ব্যবহার করে। অনুমোদনে প্ল্যান বাতিল হয় না।",
        "operationId": "get__api_v1_system_paypal_refund_requests",
        "parameters": [
          {
            "in": "query",
            "name": "mode",
            "schema": {
              "enum": [
                "sandbox",
                "live"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WalletRefundRequestList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "পর্যালোচনার জন্য গ্রাহক রিফান্ড আবেদন তালিকাভুক্ত করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/paypal/refund-requests/{id}/review": {
      "post": {
        "description": "শুধু cookie সেশন; ব্যবস্থাপনা API কী গ্রহণ করা হয় না। গ্রাহকের পড়া নিজস্ব ওয়ার্কস্পেসে সীমিত। গ্রাহকের লেখায় প্ল্যাটফর্ম প্রশাসক অনুমতি ছাড়া যাচাইকৃত ওয়ার্কস্পেস Owner প্রয়োজন। আবেদন অর্থ সরায় বা সংরক্ষণ করে না। প্রশাসকের অনুমোদন বর্তমান ওয়ালেট ও অপরিশোধিত রিফান্ডযোগ্য ক্যাপচার মূল্য আবার পরীক্ষা করে, তারপর বিদ্যমান idempotent মূল-মাধ্যম রিফান্ড ও সংরক্ষণ প্রক্রিয়া ব্যবহার করে। অনুমোদনে প্ল্যান বাতিল হয় না।",
        "operationId": "post__api_v1_system_paypal_refund_requests__id__review",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WalletRefundReview"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WalletRefundRequest"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, প্রমাণীকরণ, মালিকানা, পর্যালোচনা সংঘর্ষ বা ব্যালেন্স ত্রুটি"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "গ্রাহক রিফান্ড আবেদন অনুমোদন বা প্রত্যাখ্যান করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/paypal/refunds": {
      "get": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন।",
        "operationId": "get__api_v1_system_paypal_refunds",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "mode",
            "schema": {
              "enum": [
                "sandbox",
                "live"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/RefundList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "নির্বাচিত পেমেন্ট পরিবেশের রিফান্ড অনুরোধ তালিকাভুক্ত করুন"
      }
    },
    "/api/v1/system/paypal/refunds/{id}/reconcile": {
      "post": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। রিফান্ড ID না পেলে একই PayPal-Request-Id পুনঃপ্রচেষ্টা করে, অথবা বিদ্যমান প্রদানকারীর রিফান্ড আনে।",
        "operationId": "post__api_v1_system_paypal_refunds__id__reconcile",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PayPalRefund"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "নতুন চার্জ পরিচয় ছাড়া একই রিফান্ডের মিলন করুন"
      }
    },
    "/api/v1/system/plan-gifts": {
      "get": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। প্রদত্ত প্রাপক ডুপ্লিকেট বাদ দেওয়া ওয়ার্কস্পেসকে বোঝায়। অনুসন্ধান প্রাপকের ইমেইল, ওয়ার্কস্পেস বা প্যাকেজ নামে মেলে।",
        "operationId": "get__api_v1_system_plan_gifts",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "q",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "mode",
            "schema": {
              "enum": [
                "sandbox",
                "live"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "user_id",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlanGiftList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "উপহার ইতিহাস তালিকাভুক্ত করুন"
      },
      "post": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। পরমাণু ব্যাচ। প্রিভিউ থেকে fingerprint ও স্থির request_id দিন; মিল থাকা রিপ্লে একই ব্যাচ ফেরত দেয়। স্তর বা সময়সূচি বদলালে নতুন প্রিভিউ প্রয়োজন। উপহারের প্রকৃত পেমেন্ট শূন্য থাকে এবং নগদ রিফান্ড হতে পারে না। আপগ্রেডে তার রেকর্ড করা সুবিধা মূল্য স্বাভাবিকভাবে ক্রেডিট হয়। শুধু নতুন, শুরু না হওয়া বর্তমান স্তরের উপহার পরবর্তী আপগ্রেড বিনা অতিরিক্ত পেমেন্টে অনুসরণ করে ও তারিখ বজায় রাখে। পুরোনো উপহার পুনর্বিন্যস্ত হয় না; মাসিক কোটা ও অতিরিক্ত ব্যবহার নিয়ম স্বাভাবিকভাবে প্রযোজ্য। মিশ্র ব্যাচ current/--- মেটাডেটা ব্যবহার করে; প্রতিটি প্রকৃত স্তর ও মুদ্রার জন্য পৃথক ক্রয়-সমর্থিত উপহার রেকর্ড দেখুন।",
        "operationId": "post__api_v1_system_plan_gifts",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlanGiftInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlanGiftResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "পর্যালোচিত বর্তমান স্তরের উপহার নিশ্চিত করুন"
      }
    },
    "/api/v1/system/plan-gifts/preview": {
      "post": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। 1–100 পৃথক সক্রিয় গ্রাহক ব্যবহারকারী ID। একই ওয়ার্কস্পেসের ব্যবহারকারীরা একটি চুক্তি পান। প্রতিটি আইটেম সেই গ্রাহকের বর্তমান কার্যকর প্যাকেজ অথবা নির্বাচিত পরিবেশের সর্বশেষ মেয়াদোত্তীর্ণ প্যাকেজ গ্রহণ করে। মিশ্র স্তরের ব্যাচ প্রতিটি আইটেমে প্রকৃত প্ল্যান ও সুবিধা মূল্য ফেরত দেয়। plan/currency/price_version বাদ দিন; ঐচ্ছিক স্পষ্ট মান প্রতিটি গ্রাহকের বিদ্যমান প্যাকেজের সঙ্গে মিলতে হবে। প্যাকেজহীন গ্রাহক এই এন্ডপয়েন্টে ভিন্ন স্তর পান না। after_current সব পরিশোধিত/উপহার কভারেজের পরে যোগ করে; immediate ওভারল্যাপ অধিকার প্রত্যাখ্যান করে। কোনো লেখা বা চার্জ নেই।",
        "operationId": "post__api_v1_system_plan_gifts_preview",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlanGiftPreviewInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlanGiftPreview"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "বর্তমান স্তরের প্যাকেজ উপহার প্রিভিউ করুন"
      }
    },
    "/api/v1/system/plan-gifts/{id}/cancel": {
      "post": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। বারবার বাতিল নিরাপদ। ইতিহাস মুছে, অতিরিক্ত ব্যবহার রিফান্ড করে বা অন্য নির্ধারিত চুক্তি সরিয়ে না দিয়ে এই চুক্তি থামায়।",
        "operationId": "post__api_v1_system_plan_gifts__id__cancel",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlatformReason"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlanGiftCancellation"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সক্রিয় বা নির্ধারিত উপহার বাতিল করুন"
      }
    },
    "/api/v1/system/plans": {
      "get": {
        "operationId": "get_api_v1_system_plans",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/AdminPlanList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "plans",
        "x-platform-admin": true,
        "x-required-role": "owner"
      },
      "post": {
        "operationId": "post_api_v1_system_plans",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlanInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Price"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "plans",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/plans/customer-controls": {
      "patch": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। উভয় সুইচ ডিফল্ট false। device_enabled, api_enabled বা উভয় দিন। বাদ দেওয়া সুইচের বর্তমান অবস্থা থাকে। প্রতিটি নিষ্ক্রিয় সুইচ তার গ্রাহক নিয়ন্ত্রণ লুকায় এবং পুনরায় সক্ষম না হওয়া পর্যন্ত শুধু নিজের সংরক্ষিত পছন্দ উপেক্ষা করে। unlimited চিহ্নিত API ভাতা সীমাহীন থাকে।",
        "operationId": "patch__api_v1_system_plans_customer_controls",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CustomerControlsInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CustomerControlsResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "গ্রাহকের ডিভাইস বা API অতিরিক্ত ব্যবহার সেটিং স্বাধীনভাবে অনুমোদন করুন"
      }
    },
    "/api/v1/system/plans/default": {
      "patch": {
        "operationId": "patch_api_v1_system_plans_default",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DefaultPlan"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/DefaultPlan"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "plans/default",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/privacy/retention": {
      "get": {
        "description": "",
        "operationId": "get__api_v1_system_privacy_retention",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CommerceResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "আর্কাইভ ও সংরক্ষণ রান পড়ুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/privacy/retention/run": {
      "post": {
        "description": "শুধু যৌক্তিক আর্কাইভ; গ্রাহক/ব্যবসা সারি সংরক্ষিত। প্রমাণীকৃত পরিচালিত .lvb ব্যাকআপ ফাইল 90 দিনের পরে এবং অ্যাপের নিরাপত্তা লগ ছয় ক্যালেন্ডার মাস পরে রোটেট করে। রান ডেটাবেস লক দিয়ে ক্রমবদ্ধ হয়।",
        "operationId": "post__api_v1_system_privacy_retention_run",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Confirmation"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CommerceResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "ইতিমধ্যে প্রাপ্য আর্কাইভ ও সংরক্ষণ প্রক্রিয়া করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/provider-refunds/{id}/reconcile": {
      "post": {
        "description": "প্রদানকারী/ব্যবসায়িক রেফারেন্স দিয়ে বিদ্যমান অনুরোধ জিজ্ঞাসা করে। শুধু আগে জমা না দেওয়া স্থায়ী ইন্টেন্ট প্রথম অনুরোধ পাঠাতে পারে; ডুপ্লিকেট বা অজানা জমা আবার পোস্ট করা হয় না। সম্পূর্ণ হতে স্বাধীনভাবে যাচাইকৃত মূল প্রদানকারীর রসিদ প্রয়োজন।",
        "operationId": "post__api_v1_system_provider_refunds__id__reconcile",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ProviderRefund"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "বিদ্যমান মূল-চ্যানেল রিফান্ডের মিলন করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/refund-requests": {
      "get": {
        "description": "শুধু-পঠন প্ল্যাটফর্ম প্রশাসক সেশন। ওয়ালেট রিফান্ড আবেদন ও প্রদানকারীর ওয়ালেট/পরিষেবা বাতিল মামলা একত্র করে। পরিবেশ-পরিসরের অপেক্ষমাণ গণনা পৃষ্ঠাবিন্যাস ও পরিসর ফিল্টার থেকে স্বাধীন। পড়লে অর্থ অনুমোদিত, ফ্রিজ বা রিফান্ড হয় না; প্রতিটি উৎসের বিদ্যমান পর্যালোচনা এন্ডপয়েন্ট ব্যবহার করুন।",
        "operationId": "get_system_refund_requests",
        "parameters": [
          {
            "in": "query",
            "name": "mode",
            "schema": {
              "enum": [
                "sandbox",
                "live"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "review",
            "schema": {
              "enum": [
                "pending",
                "all"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "scope",
            "schema": {
              "enum": [
                "wallet",
                "service"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/RefundInboxList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "পরিবেশ-পরিসরের অনুরোধ ও অপেক্ষমাণ পর্যালোচনা গণনা"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, সেশন বা অনুমতি ত্রুটি"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, সেশন বা অনুমতি ত্রুটি"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, সেশন বা অনুমতি ত্রুটি"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, সেশন বা অনুমতি ত্রুটি"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, সেশন বা অনুমতি ত্রুটি"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সমন্বিত গ্রাহক রিফান্ড পর্যালোচনা সারি",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/refunds": {
      "get": {
        "operationId": "get__api_v1_system_refunds",
        "parameters": [
          {
            "in": "query",
            "name": "mode",
            "schema": {
              "enum": [
                "sandbox",
                "live"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/RefundHistory"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "PayPal, Waffo ও Paddle জুড়ে রিফান্ড তালিকাভুক্ত করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/revenue": {
      "get": {
        "operationId": "get_api_v1_system_revenue",
        "parameters": [
          {
            "in": "query",
            "name": "mode",
            "schema": {
              "enum": [
                "sandbox",
                "live"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "month",
            "schema": {
              "description": "all বা UTC YYYY-MM",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Revenue"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "revenue",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/sdk-example": {
      "post": {
        "description": "শুধু প্ল্যাটফর্ম প্রশাসকের Owner সেশন, CSRF সহ। API কী প্রত্যাখ্যাত। নির্দিষ্ট পণ্য ও নীতি পুনর্ব্যবহার করে; বিদ্যমান ট্রায়াল নবায়ন করে না।",
        "operationId": "post_api_v1_system_sdk-example",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SDKExampleSetup"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SDKExampleSetting"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "প্রশাসকের নির্দিষ্ট প্রকাশ্য SDK উদাহরণ পণ্য প্রস্তুত/সক্ষম করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/service/incidents": {
      "get": {
        "description": "",
        "operationId": "get__api_v1_system_service_incidents",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ServiceIncidentList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সব পরিষেবা বিজ্ঞপ্তি পড়ুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      },
      "post": {
        "description": "অ-জরুরি রক্ষণাবেক্ষণে অন্তত 24 ঘণ্টা নোটিশ প্রয়োজন। 24 ঘণ্টার বেশি ধারাবাহিক যাচাইকৃত ঘটনায় প্রকৃত প্রভাবিত পরিশোধিত সময় ক্রেডিট হয়; ওভারল্যাপ সময়ে দ্বিগুণ ক্ষতিপূরণ নয়। সাত দিনের বেশি হলে অব্যবহৃত পরিষেবা রিফান্ডের যোগ্য হতে পারে।",
        "operationId": "post__api_v1_system_service_incidents",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ServiceIncidentInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ServiceIncident"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "রক্ষণাবেক্ষণ প্রকাশ বা ঘটনা সমাধান করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/settings": {
      "get": {
        "operationId": "get_api_v1_system_settings",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SystemSettings"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "get /system/settings",
        "x-platform-admin": true,
        "x-required-role": "owner"
      },
      "patch": {
        "operationId": "patch_api_v1_system_settings",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MailInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/MailSettings"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "patch /system/settings",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/test-mail": {
      "post": {
        "description": "সংরক্ষিত ডেলিভারি পরিষেবা দিয়ে প্রদত্ত প্রাপকের জন্য একটি বাস্তব পরীক্ষামূলক বার্তা স্পষ্টভাবে সারিতে দিন। HTTP 202 সারিতে গৃহীত হওয়া নিশ্চিত করে, ইনবক্সে পৌঁছানো নয়। কাজের অবস্থা অনুসরণ করুন এবং ডেলিভারি সমস্যায় প্রদানকারীর ড্যাশবোর্ড/ইনবক্স দেখুন।",
        "operationId": "post_api_v1_system_test-mail",
        "parameters": [
          {
            "description": "cookie/public-auth লেখার জন্য আবশ্যক; শুধু সমর্থিত Bearer রিসোর্স লেখায় ছাড়",
            "in": "header",
            "name": "X-CSRF-Token",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TestMail"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/MailQueued"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "post /system/test-mail",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/tls": {
      "get": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক ব্রাউজার সেশন। ব্যবস্থাপনা API কী ও টেন্যান্ট মালিক প্রত্যাখ্যাত। এই প্রক্রিয়ার ব্যবহৃত সার্টিফিকেট দেখায়। সার্টিফিকেট PEM বা ব্যক্তিগত কী প্রকাশ হয় না।",
        "operationId": "get__api_v1_system_tls",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/TLSStatus"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল; শুধু প্রকাশ্য সার্টিফিকেট মেটাডেটা ফেরত আসে।"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সক্রিয় HTTPS সার্টিফিকেট পড়ুন"
      },
      "patch": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক ব্রাউজার সেশন। ব্যবস্থাপনা API কী ও টেন্যান্ট মালিক প্রত্যাখ্যাত। MySQL-এ সার্টিফিকেট/কী যাচাই ও এনক্রিপ্ট করে, অডিট ইভেন্ট রেকর্ড করে, তারপর সক্রিয় সার্টিফিকেট বদলায়। নতুন TLS হ্যান্ডশেক অবিলম্বে এটি ব্যবহার করে; বিদ্যমান সংযোগ স্বাভাবিক থাকে। পুনরারম্ভে bootstrap ফাইলের আগে ডেটাবেস সার্টিফিকেট ব্যবহৃত হয়।",
        "operationId": "patch__api_v1_system_tls",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TLSCertificateUpdateInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/TLSCertificateResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল; শুধু প্রকাশ্য সার্টিফিকেট মেটাডেটা ফেরত আসে।"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "HTTPS সার্টিফিকেট অবিলম্বে বদলান"
      }
    },
    "/api/v1/system/tls/check": {
      "post": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক ব্রাউজার সেশন। ব্যবস্থাপনা API কী ও টেন্যান্ট মালিক প্রত্যাখ্যাত। ফরম্যাট, কী শক্তি, কী মিল, হোস্টনাম, বৈধতা ও বিশ্বাসের শৃঙ্খল পরীক্ষা করে। সরাসরি HTTPS সক্ষম থাকতে হবে। সক্রিয় সার্টিফিকেট অপরিবর্তিত।",
        "operationId": "post__api_v1_system_tls_check",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TLSCertificateInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/TLSCertificateInfo"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল; শুধু প্রকাশ্য সার্টিফিকেট মেটাডেটা ফেরত আসে।"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code পরীক্ষা করুন। TLS_KEY_MISMATCH, TLS_DOMAIN_MISMATCH, TLS_EXPIRED, TLS_CHAIN_UNTRUSTED ও TLS_SETTINGS_CONFLICT আগের সার্টিফিকেট বজায় রাখে।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সংরক্ষণ ছাড়া সার্টিফিকেট ও ব্যক্তিগত কী যাচাই করুন"
      }
    },
    "/api/v1/system/translation": {
      "get": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন।",
        "operationId": "get__api_v1_system_translation",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/TranslationSettings"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "API কী প্রকাশ না করে DeepL সেটিং পড়ুন"
      },
      "patch": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। সর্বশেষ GET থেকে expected_version ব্যবহার করুন। কী কখনো ফেরত দেওয়া হয় না।",
        "operationId": "patch__api_v1_system_translation",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TranslationSettingsInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/TranslationSettings"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "এনক্রিপ্টেড DeepL সেটিং সংরক্ষণ করুন"
      }
    },
    "/api/v1/system/translation/check": {
      "post": {
        "description": "শুধু DeepL ভাষা ও ব্যবহার এন্ডপয়েন্ট কল করে; ফোরামের বিষয়বস্তু পাঠানো হয় না।",
        "operationId": "post__api_v1_system_translation_check",
        "parameters": [
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/TranslationCheck"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message দেখুন; request_id অনুরোধ শনাক্ত করে।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সংরক্ষিত API কী যাচাই করে সমর্থিত ভাষা ও ব্যবহার আনুন"
      }
    },
    "/api/v1/system/users": {
      "get": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। অযাচাইকৃত অ্যাকাউন্ট ও দলের সদস্য অন্তর্ভুক্ত; হ্যাশ বা প্রমাণীকরণ টোকেন কখনো ফেরত দেয় না।",
        "operationId": "get__api_v1_system_users",
        "parameters": [
          {
            "description": "ইমেইল, নাম বা ওয়ার্কস্পেসের বড়-ছোট অক্ষর-অসংবেদনশীল আংশিক মিল; ওয়াইল্ডকার্ড অক্ষর এস্কেপ করা হয়।",
            "in": "query",
            "name": "q",
            "schema": {
              "maxLength": 254,
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "status",
            "schema": {
              "enum": [
                "active",
                "disabled"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "role",
            "schema": {
              "enum": [
                "owner",
                "read_only"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "verified",
            "schema": {
              "enum": [
                "true",
                "false"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlatformUserList"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সব নিবন্ধিত ব্যবহারকারী তালিকাভুক্ত করুন"
      }
    },
    "/api/v1/system/users/export.csv": {
      "get": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। সর্বাধিক 10000 মিল রেকর্ড, UTF-8 BOM ও স্প্রেডশিট ফর্মুলা এস্কেপিং। ক্রেডেনশিয়াল নেই।",
        "operationId": "get__api_v1_system_users_export_csv",
        "parameters": [
          {
            "description": "ইমেইল, নাম বা ওয়ার্কস্পেসের বড়-ছোট অক্ষর-অসংবেদনশীল আংশিক মিল; ওয়াইল্ডকার্ড অক্ষর এস্কেপ করা হয়।",
            "in": "query",
            "name": "q",
            "schema": {
              "maxLength": 254,
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "status",
            "schema": {
              "enum": [
                "active",
                "disabled"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "role",
            "schema": {
              "enum": [
                "owner",
                "read_only"
              ],
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "verified",
            "schema": {
              "enum": [
                "true",
                "false"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "CSV সংযুক্তি"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "ফিল্টার করা নিবন্ধিত ব্যবহারকারী CSV হিসেবে এক্সপোর্ট করুন"
      }
    },
    "/api/v1/system/users/{id}": {
      "get": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। ওয়ার্কস্পেস ব্যালেন্স, সর্বশেষ 20 চুক্তি এবং ক্রমসঞ্চিত PayPal পরিশোধ/রিফান্ড মোট মুদ্রা ও পরিবেশ অনুসারে আলাদা।",
        "operationId": "get__api_v1_system_users__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlatformUserDetail"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "গ্রাহক ও ওয়ার্কস্পেস বিবরণ পড়ুন"
      },
      "patch": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। কাজের কারণ ও optimistic সংস্করণ প্রয়োজন। নিষ্ক্রিয় করলে বিদ্যমান সেশন, কী ও লগইন লিঙ্ক প্রত্যাহার হয়। পুনরুদ্ধারে কী ফেরে না। প্ল্যাটফর্ম প্রশাসক অ্যাকাউন্ট সুরক্ষিত।",
        "operationId": "patch__api_v1_system_users__id_",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlatformUserUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlatformUserDetail"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "গ্রাহকের অবস্থা বা ব্যক্তিগত প্রশাসনিক নোট আপডেট করুন"
      }
    },
    "/api/v1/system/users/{id}/data-export": {
      "post": {
        "description": "অ্যাকাউন্ট বন্ধ ও গ্রাহক সময়সীমার পরে উপলব্ধ। প্রশাসকের পাসওয়ার্ড, পরিসর ও নিরীক্ষিত কার্যক্রমের কারণ প্রয়োজন। কোনো ব্যবসায়িক রেকর্ড মোছা হয় না।",
        "operationId": "post__api_v1_system_users__id__data_export",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CustomerDataExportInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/zip": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সংরক্ষিত গ্রাহক রেকর্ড এক্সপোর্ট করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/system/users/{id}/revoke-credentials": {
      "post": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। অ্যাকাউন্ট নিষ্ক্রিয় করে না; গ্রাহক আবার সাইন ইন করতে পারেন। এখানে প্রশাসক ক্রেডেনশিয়াল প্রত্যাহার করা যায় না।",
        "operationId": "post__api_v1_system_users__id__revoke_credentials",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlatformReason"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlatformRevocation"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "বিদ্যমান গ্রাহক সেশন ও API কী প্রত্যাহার করুন"
      }
    },
    "/api/v1/system/waffo": {
      "get": {
        "operationId": "get__api_v1_system_waffo",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WaffoSettings"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "স্বাক্ষর কী ছাড়া Waffo সেটিং পড়ুন",
        "x-licentivo-access": "platform"
      },
      "patch": {
        "operationId": "patch__api_v1_system_waffo",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WaffoSettingsInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WaffoSettings"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "এনক্রিপ্টেড Waffo ক্রেডেনশিয়াল সংরক্ষণ করুন",
        "x-licentivo-access": "platform"
      }
    },
    "/api/v1/system/waffo/check": {
      "post": {
        "operationId": "post__api_v1_system_waffo_check",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WaffoCheck"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "Waffo ক্রেডেনশিয়াল ও সক্রিয় এককালীন পণ্য যাচাই করুন",
        "x-licentivo-access": "platform"
      }
    },
    "/api/v1/system/waffo/orders": {
      "get": {
        "operationId": "get__api_v1_system_waffo_orders",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WaffoOrderList"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "Waffo পরিষেবা পেমেন্ট ও ওয়ালেট টপ-আপ তালিকাভুক্ত করুন",
        "x-licentivo-access": "platform"
      }
    },
    "/api/v1/system/waffo/orders/{id}/reconcile": {
      "post": {
        "operationId": "post__api_v1_system_waffo_orders__id__reconcile",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/WaffoOrderResult"
                    },
                    "request_id": {
                      "description": "স্থানীয় পরিষেবা-পেমেন্ট শনাক্তকারী।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "মূল Waffo পেমেন্ট পুনরুদ্ধার ও মিলন করুন",
        "x-licentivo-access": "platform"
      }
    },
    "/api/v1/system/workspaces/{id}/status": {
      "patch": {
        "description": "শুধু প্ল্যাটফর্ম-প্রশাসক সেশন। স্থগিতাদেশ লগইন, ব্যবস্থাপনা API ও অনলাইন লাইসেন্সিং আটকায় এবং ক্রেডেনশিয়াল প্রত্যাহার করে। চুক্তির মেয়াদ চলতে থাকে। প্ল্যাটফর্ম ওয়ার্কস্পেস সুরক্ষিত; স্বাক্ষরিত অফলাইন ক্যাশ বিদ্যমান মেয়াদ দ্বারা নিয়ন্ত্রিত থাকে।",
        "operationId": "patch__api_v1_system_workspaces__id__status",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlatformWorkspaceUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/PlatformWorkspaceStatus"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "error.code ও error.message পরীক্ষা করুন।"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "সম্পূর্ণ গ্রাহক ওয়ার্কস্পেস স্থগিত বা পুনরুদ্ধার করুন"
      }
    },
    "/api/v1/system/{provider}/orders/{id}/refund": {
      "post": {
        "description": "প্ল্যাটফর্ম প্রশাসক সেশন। পরিশোধিত পরিষেবার জন্য বাতিল প্রয়োজন। অপ্রয়োগকৃত পেমেন্ট ওয়ালেট লেনদেন ছাড়া রিফান্ড হয়। স্থির request_id গেটওয়ে কলের আগে ইন্টেন্ট স্থায়ী রাখে; অজানা ফল জিজ্ঞাসা করে যাচাই হয় এবং অন্ধভাবে আবার পোস্ট হয় না।",
        "operationId": "post__api_v1_system__provider__orders__id__refund",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "provider",
            "required": true,
            "schema": {
              "enum": [
                "waffo",
                "paddle"
              ],
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OriginalRefundInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/OriginalRefundResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "যাচাই, মালিকানা, পরিবেশ, রিফান্ড অবস্থা বা প্রদানকারীর ত্রুটি"
          }
        },
        "security": [
          {
            "session": []
          }
        ],
        "summary": "অব্যবহৃত ক্রেডিট বা অপ্রয়োগকৃত পেমেন্টের মূল-চ্যানেল রিফান্ড শুরু করুন",
        "x-platform-admin": true,
        "x-required-role": "owner"
      }
    },
    "/api/v1/usage": {
      "get": {
        "description": "বর্তমান মাস সক্রিয় ডিভাইস নিবন্ধন দেখায়; আগের মাসগুলো রেকর্ড করা ডিভাইস ব্যবহার ইতিহাস দেখায়। কেনা প্যাকেজের API কোটা নিজস্ব কোটা মাস অনুসরণ করে। রিলিজের পর ডিভাইস ইতিহাস থাকে। বর্তমান দখল ও বিলিং শীর্ষ আলাদা পরিমাপ।",
        "operationId": "get_api_v1_usage",
        "parameters": [
          {
            "description": "UTC স্বাভাবিক মাস; ডিফল্ট বর্তমান",
            "in": "query",
            "name": "month",
            "schema": {
              "description": "UTC মাস YYYY-MM; বাদ দেওয়া কোয়েরি মানে বর্তমান মাস ব্যবহৃত হয়। বিলিং কাজে বন্ধ মাস প্রয়োজন।",
              "pattern": "^[0-9]{4}-[0-9]{2}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "active_devices": 0,
                    "api_calls": 0,
                    "api_period": null,
                    "billable_devices": 0,
                    "estimated_total_cents": 0,
                    "estimated_total_micros": 0,
                    "month": "2026-09",
                    "operations": [],
                    "overage_devices": 0,
                    "period": null,
                    "products": [],
                    "purchased": null,
                    "purchased_active_devices": 0,
                    "sandbox": false,
                    "timezone": "UTC",
                    "warning": "normal"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Usage",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "503": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "DEFAULT_PLAN_DISABLED",
                    "message": "The default allowance plan has not been enabled by the administrator"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ডিফল্ট ভাতা অক্ষম (DEFAULT_PLAN_DISABLED)"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "Current device occupancy, historical device use and metered API usage",
        "x-management-reference": {
          "group": "usage"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/usage/devices": {
      "get": {
        "description": "নির্বাচিত UTC মাসের ডিভাইস ব্যবহার রেকর্ড, ডিভাইস রিলিজের পরও থাকে। এটি কার্যকলাপের ইতিহাস, বর্তমান অনলাইন ডিভাইস তালিকা নয়। বর্তমান দখলের জন্য GET /api/v1/usage ব্যবহার করুন।",
        "operationId": "get_api_v1_usage_devices",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "description": "UTC স্বাভাবিক মাস; ডিফল্ট বর্তমান",
            "in": "query",
            "name": "month",
            "schema": {
              "description": "UTC মাস YYYY-MM; বাদ দেওয়া কোয়েরি মানে বর্তমান মাস ব্যবহৃত হয়। বিলিং কাজে বন্ধ মাস প্রয়োজন।",
              "pattern": "^[0-9]{4}-[0-9]{2}$",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "product_id",
            "schema": {
              "description": "বর্তমান ওয়ার্কস্পেসের পণ্য UUID।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": [
                      {
                        "device_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                        "first_seen_at": "2026-09-01T00:00:00Z",
                        "last_seen_at": "2026-09-30T00:00:00Z",
                        "month": "2026-09",
                        "product_id": "11111111-1111-4111-8111-111111111111"
                      }
                    ],
                    "limit": 25,
                    "offset": 0,
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/UsageDeviceList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ব্যবহৃত ডিভাইস তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "usage"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/usage/export.csv": {
      "get": {
        "description": "নির্বাচিত UTC মাসের ডিভাইস ব্যবহার রেকর্ড, ডিভাইস রিলিজের পরও থাকে। এটি কার্যকলাপের ইতিহাস, বর্তমান অনলাইন ডিভাইস তালিকা নয়। বর্তমান দখলের জন্য GET /api/v1/usage ব্যবহার করুন।",
        "operationId": "get_api_v1_usage_export_csv",
        "parameters": [
          {
            "description": "UTC স্বাভাবিক মাস; ডিফল্ট বর্তমান",
            "in": "query",
            "name": "month",
            "schema": {
              "description": "UTC মাস YYYY-MM; বাদ দেওয়া কোয়েরি মানে বর্তমান মাস ব্যবহৃত হয়। বিলিং কাজে বন্ধ মাস প্রয়োজন।",
              "pattern": "^[0-9]{4}-[0-9]{2}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "text/csv": {
                "example": "month,product_id,device_id,first_seen_utc,last_seen_utc\n",
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ব্যবহার এক্সপোর্ট করুন",
        "x-csv-columns": [
          "month",
          "product_id",
          "device_id",
          "first_seen_utc",
          "last_seen_utc"
        ],
        "x-management-reference": {
          "group": "usage"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/validate": {
      "post": {
        "description": "product_id + license_key + device_id দিয়ে প্রমাণীকৃত। cookie/CSRF/vendor key নেই। activate ছাড়া activation_id প্রয়োজন। প্রতিটি সফল অনুরোধ একটি API কল খরচ করে; idempotent রিপ্লে ও ব্যর্থতা করে না। অতিরিক্ত ব্যবহার ওয়ালেট থেকে পরমাণুভাবে ডেবিট হয় অথবা API_QUOTA_EXCEEDED/API_BALANCE_INSUFFICIENT ফেরত দেয়। যাচাই ও heartbeat পুনঃপ্রচেষ্টা রসিদ 3600 সেকেন্ড পরে মেয়াদোত্তীর্ণ হয়। মূল অনুমোদন বৈধ থাকলে এই সময়ে মিল থাকা অনুরোধ অতিরিক্ত ডেবিট ছাড়া রিপ্লে হয়। সময়সীমার পরে নতুন কী ব্যবহার করুন; আগে ব্যবহৃত কী নতুন অনুরোধ হিসেবে প্রক্রিয়াকৃত হতে পারে। অ্যাক্টিভেশন, ডিঅ্যাক্টিভেশন ও ফিচার ব্যবহারের রসিদ স্থায়ী থাকে। ওয়ার্কস্পেস ডিভাইস কোটা বর্তমান অ্যাক্টিভেশন অনুসরণ করে। রিলিজ ক্ষমতা ফেরত দেয়; ফ্লোটিং লিজের মেয়াদ শেষেও ক্ষমতা ফেরে, তবে অফলাইন সাধারণ নিবন্ধন গণনায় থাকে। কোটা-মাসের বিলিং শীর্ষ ইতিমধ্যে পরিশোধিত ক্ষমতা ছাড়ালেই কেবল ডিভাইস অতিরিক্ত ব্যবহারের চার্জ হয়; রিলিজে আগের চার্জ ফেরত হয় না। API ব্যবহার আলাদা।",
        "operationId": "post_api_v1_validate",
        "parameters": [
          {
            "description": "প্রতিটি কাজের জন্য নতুন কী তৈরি করুন; পুনঃপ্রচেষ্টায় একই কী ও বডি রাখুন। সর্বাধিক 80 অক্ষর, শূন্যস্থান নয়। যাচাই ও heartbeat-এর জন্য ঐচ্ছিক।",
            "in": "header",
            "name": "Idempotency-Key",
            "required": false,
            "schema": {
              "maxLength": 80,
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RuntimeInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/RuntimeResult"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "রানটাইম যাচাই"
      }
    },
    "/api/v1/webhook-deliveries/{id}/attempts": {
      "get": {
        "operationId": "get_api_v1_webhook-deliveries_by_id_attempts",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": null
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/AttemptList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ডেলিভারি প্রচেষ্টা তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "webhooks"
        },
        "x-required-scope": "read"
      }
    },
    "/api/v1/webhook-deliveries/{id}/retry": {
      "post": {
        "operationId": "post_api_v1_webhook-deliveries_by_id_retry",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {},
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ID",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ওয়েবহুক ডেলিভারি পুনঃপ্রচেষ্টা করুন",
        "x-management-reference": {
          "group": "webhooks"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/webhooks": {
      "get": {
        "operationId": "get_api_v1_webhooks",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "event_types": [],
                    "items": [
                      {
                        "created_at": "2026-10-18T00:00:00Z",
                        "enabled": true,
                        "events": [],
                        "id": "33333333-3333-4333-8333-333333333333",
                        "name": "Report app",
                        "updated_at": "2026-10-18T00:00:00Z",
                        "url": "https://merchant.example.com/license-events"
                      }
                    ]
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LicensingWebhookList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ওয়েবহুক তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "webhooks"
        },
        "x-required-scope": "read"
      },
      "post": {
        "operationId": "post_api_v1_webhooks",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "enabled": true,
                "events": [
                  "license.created",
                  "license.renewed"
                ],
                "name": "Order system",
                "url": "https://merchant.example.com/license-events"
              },
              "schema": {
                "$ref": "#/components/schemas/LicensingWebhookInput"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "id": "33333333-3333-4333-8333-333333333333",
                    "secret": "whsec_BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/LicensingWebhookSecret",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ওয়েবহুক সংরক্ষণ করুন",
        "x-management-reference": {
          "group": "webhooks"
        },
        "x-required-role": "owner",
        "x-required-scope": "write"
      }
    },
    "/api/v1/webhooks/{id}/deliveries": {
      "get": {
        "operationId": "get_api_v1_webhooks_by_id_deliveries",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "এই রিসোর্সের অনন্য ID; পাথে সংশ্লিষ্ট রিসোর্স ID ব্যবহার করুন।",
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "default": 25,
              "description": "পৃষ্ঠার আকার, ডিফল্ট 25, সীমা 1–100।",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "default": 0,
              "description": "বাদ দেওয়ার রেকর্ড, ডিফল্ট 0, সীমা 0–100000; পরের পৃষ্ঠার জন্য limit যোগ করুন।",
              "maximum": 100000,
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": {
                    "items": null,
                    "limit": 25,
                    "offset": 0,
                    "total": 1
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/DeliveryList",
                      "description": "সফলতায় ব্যবসায়িক ফল; ব্যর্থতায় পরিবর্তে error ব্যবহার হয়।"
                    },
                    "request_id": {
                      "description": "শীর্ষ-স্তরের HTTP ট্রেস UUID। batch/onboarding ইনপুটে এটি কলার তৈরি idempotency UUID; উদ্দেশ্য দুটি আলাদা।",
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INVALID_INPUT",
                    "message": "Invalid request fields"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "UNAUTHENTICATED",
                    "message": "Please sign in again"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "FORBIDDEN",
                    "message": "This operation requires an owner account"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "NOT_FOUND",
                    "message": "Resource not found"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "METHOD_NOT_ALLOWED",
                    "message": "Method not allowed"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "CONFLICT",
                    "message": "This value already exists"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "JSON_REQUIRED",
                    "message": "Use Content-Type: application/json"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RATE_LIMITED",
                    "message": "Too many attempts; try again later"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "INTERNAL_ERROR",
                    "message": "An unexpected error occurred"
                  },
                  "request_id": "55555555-5555-4555-8555-555555555555"
                },
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [
          {
            "session": []
          },
          {
            "managementKey": []
          }
        ],
        "summary": "ওয়েবহুক ডেলিভারি তালিকাভুক্ত করুন",
        "x-management-reference": {
          "group": "webhooks"
        },
        "x-required-scope": "read"
      }
    },
    "/healthz": {
      "get": {
        "operationId": "get_healthz",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Health"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          }
        },
        "security": [],
        "summary": "প্রক্রিয়ার সচলতা"
      }
    },
    "/readyz": {
      "get": {
        "operationId": "get_readyz",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Health"
                    },
                    "request_id": {
                      "format": "uuid",
                      "type": "string"
                    }
                  },
                  "required": [
                    "data",
                    "request_id"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "সফল"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "docs/error-codes.md দেখুন; প্রযোজ্যতা এন্ডপয়েন্ট নির্ভর"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "ডেটাবেস অনুপলব্ধ"
          }
        },
        "security": [],
        "summary": "ডেটাবেস প্রস্তুতি"
      }
    }
  },
  "servers": [
    {
      "url": "https://www.licentivo.com"
    }
  ]
}