{
  "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": "پرانی ڈیوائس اسناد باطل کرنے کی ایکٹیویشن generation۔",
            "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": "vendor کا مقرر کردہ گاہک لیبل، کسٹمر پورٹل ای میل سے الگ۔",
                  "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": "vendor کا مقرر کردہ گاہک لیبل، کسٹمر پورٹل ای میل سے الگ۔",
            "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": "اگلا reset UTC ISO 8601؛ lifetime میں null۔"
          },
          "used": {
            "description": "اس مدت میں تصدیق شدہ کٹوتی، ریزرویشن شامل نہیں۔",
            "type": "integer"
          }
        },
        "required": [],
        "type": "object"
      },
      "ConsumptionResult": {
        "additionalProperties": false,
        "properties": {
          "activation_id": {
            "description": "آلے کی بندش یا اجرا سیشن UUID؛ آئندہ درخواستوں کے لیے محفوظ کریں، لائسنس key نہیں۔",
            "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": "پروڈکٹ اور hardware شناخت کا SHA-256؛ دستیاب نہ ہو تو خالی، hardware لازمی پالیسی رد کرے گی۔",
            "type": "string"
          },
          "platform": {
            "description": "مقامی OS: windows، linux یا darwin (macOS)۔",
            "enum": [
              "windows",
              "linux",
              "darwin"
            ],
            "type": "string"
          },
          "system_id": {
            "description": "پروڈکٹ اور نظام شناخت کا SHA-256: 64 lowercase hex حروف۔",
            "pattern": "^[0-9a-f]{64}$",
            "type": "string"
          },
          "version": {
            "const": 3,
            "description": "آلے کے fingerprint پروٹوکول کا نسخہ، فی الحال 3۔",
            "type": "integer"
          },
          "virtual_machine": {
            "description": "boolean: SDK نے virtual machine شناخت کی یا نہیں۔",
            "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": "متوقع ڈیوائس بائنڈنگ generation، تنسیخ ٹرانزیکشن کے اندر موازنہ۔",
            "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": "logs کا سرور بنایا HTTP UUID؛ لائسنس یا idempotency ID نہیں۔",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "error",
          "request_id"
        ],
        "type": "object"
      },
      "FeatureReservation": {
        "additionalProperties": false,
        "properties": {
          "consumption": {
            "$ref": "#/components/schemas/Consumption",
            "description": "استعمال رسید: کٹے یونٹ، کل استعمال، باقی کوٹا اور اگلا reset۔"
          },
          "expires_at": {
            "description": "ریزرویشن کا آخری وقت UTC؛ اس سے پہلے تصدیق کریں۔",
            "format": "date-time",
            "type": "string"
          },
          "operation_id": {
            "description": "ریزرویشن کا اصل کام ID؛ دوبارہ کوشش میں وہی رکھیں۔",
            "type": "string"
          },
          "reservation_id": {
            "description": "ریزرویشن ID؛ تصدیق یا منسوخی کے وقت یہی بھیجیں۔",
            "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 لاگ ان assertions کا درست مطلوبہ وصول کنندہ۔",
            "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 origin۔",
            "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 لاگ ان assertions کا درست مطلوبہ وصول کنندہ۔",
            "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 origin۔ HTTPS طے شدہ ہے۔ HTTP کے لیے درخواست کرنے والی API کلید پر allow_http لازم؛ نجی IPs اور اندرونی ہوسٹ نام معاون ہیں۔ اس origin کو کال بیک یا دریافت درخواست نہیں کی جاتی۔",
            "format": "uri",
            "type": "string"
          },
          "offline_seconds": {
            "default": 0,
            "description": "0 کے لیے آن لائن تصدیق ضروری ہے۔ مثبت آف لائن مدت کم از کم 3 × heartbeat_seconds ہونی چاہیے۔ اکاؤنٹس کی مستقل آف لائن اجازتیں غیر فعال ہیں۔",
            "maximum": 86400,
            "minimum": 0,
            "type": "integer"
          },
          "public_keys": {
            "additionalProperties": {
              "description": "پن شدہ canonical 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": "متوقع ڈیوائس بائنڈنگ generation، تنسیخ ٹرانزیکشن کے اندر موازنہ۔",
            "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": "آخری کامیاب activation کا data.activation_id؛ پہلی activate کے علاوہ تصدیق، heartbeat، consume اور علیحدگی میں لازم۔",
            "format": "uuid",
            "type": "string"
          },
          "app_version": {
            "description": "موجودہ نسخہ major.minor.patch، مثلاً 1.0.0۔ maintenance یا 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"
          },
          "device_id": {
            "description": "پروڈکٹ، نظام اور hardware سے SDK کا حساب کردہ 64 lowercase hex SHA-256؛ من مانا مستقل عدد نہ دیں۔",
            "pattern": "^[0-9a-f]{64}$",
            "type": "string"
          },
          "device_name": {
            "description": "dashboard نام، زیادہ سے زیادہ 120 حروف؛ آلے کی شناخت نہیں طے کرتا۔",
            "maxLength": 120,
            "type": "string"
          },
          "device_profile": {
            "$ref": "#/components/schemas/DeviceProfile",
            "description": "SDK کا بنایا مشین profile؛ hardware شناخت، VM رد یا hardware منتقلی کی پالیسی کے مطابق دیں۔"
          },
          "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 صلاحیت کا مذاکراتی عمل۔ موجودہ بائنڈنگ کا ٹکٹ محفوظ نہ ہو تو صرف ان لنک لاگ آؤٹ ٹکٹ مانگیں۔ درست ٹکٹ پہلے محفوظ ہو تو چھوڑ دیں؛ مستحکم حالت کے heartbeat اضافی ٹکٹ تلاش سے بچتے ہیں۔",
            "type": "boolean"
          },
          "reservation_id": {
            "description": "ریزرویشن ID؛ تصدیق یا منسوخی کے وقت یہی بھیجیں۔",
            "format": "uuid",
            "type": "string"
          },
          "reservation_seconds": {
            "default": 900,
            "description": "اختیاری مدت 30–3600 سیکنڈ، پہلے سے 900۔ مدت کا حساب نئے سرے سے شروع ہو تو پہلے ختم ہوتی ہے۔",
            "maximum": 3600,
            "minimum": 30,
            "type": "integer"
          },
          "session_id": {
            "description": "floating میں لازم: ہر چلتے instance کا نیا UUID، اسی کی درخواستوں میں وہی رکھیں۔ device-bound میں اختیاری۔",
            "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": "ریلیز موجودہ ڈیوائس بائنڈنگ generations؛ نئے لاگ ان محفوظ ہیں۔",
            "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 تمام موجودہ اکاؤنٹ سیشن منسوخ اور پرانے توثیقی assertions مسترد کرتا ہے۔",
            "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 تمام موجودہ اکاؤنٹ سیشن منسوخ اور پرانے توثیقی assertions مسترد کرتا ہے۔",
            "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": "دستخط public key UUID؛ پروڈکٹ کے trusted_keys میں ہو۔",
            "format": "uuid",
            "type": "string"
          },
          "payload": {
            "description": "اصل لائسنس JSON بائٹس کا بغیر padding Base64URL۔ ڈی کوڈ کرنا صرف پڑھنے کے لیے ہے؛ دستخط کی تصدیق ضروری ہے۔",
            "type": "string"
          },
          "signature": {
            "description": "Base64URL میں Ed25519 دستخط۔ LicenovaLease/v1 متن، ایک newline اور ڈی کوڈ شدہ payload کے اصل JSON بائٹس کی تصدیق کریں۔ JSON دوبارہ serialize نہ کریں۔ ڈی کوڈ شدہ دستخط 64 بائٹس کا ہے۔",
            "type": "string"
          },
          "version": {
            "const": 1,
            "description": "دستخط envelope پروٹوکول کا نسخہ، فی الحال 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": "vendor کا مقرر کردہ گاہک لیبل، کسٹمر پورٹل ای میل سے الگ۔",
            "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": "پہلی activation سے درست دن؛ مستقل لائسنس میں 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؛ پہلی activation سے پہلے اور مستقل لائسنس میں null۔"
          },
          "first_activated_at": {
            "anyOf": [
              {
                "description": "پہلی کامیاب ایکٹیویشن ٹائم اسٹیمپ؛ پہلے null اور تجدید یا منتقلی سے غیر تبدیل۔",
                "format": "date-time",
                "type": "string"
              },
              {
                "description": "پہلی کامیاب ایکٹیویشن ٹائم اسٹیمپ؛ پہلے null اور تجدید یا منتقلی سے غیر تبدیل۔",
                "type": "null"
              }
            ],
            "description": "پہلی کامیاب activation، UTC ISO 8601؛ پہلے null۔ آلہ بدلنے پر reset نہیں۔"
          },
          "id": {
            "description": "لائسنس ریکارڈ UUID، تلاش، تجدید یا منسوخی کے لیے؛ activation key نہیں۔",
            "format": "uuid",
            "type": "string"
          },
          "key": {
            "description": "lv_lic_ سے شروع مکمل key صرف اجرا پر ایک بار دکھتی ہے۔ فروش نجی طور پر محفوظ رکھ کر گاہک کو دے۔",
            "type": "string"
          },
          "key_prefix": {
            "description": "dashboard شناخت کے لیے key کا آغاز؛ activation میں استعمال نہیں ہو سکتا۔",
            "type": "string"
          }
        },
        "required": [
          "id",
          "key",
          "key_prefix"
        ],
        "type": "object"
      },
      "LicenseUpdate": {
        "additionalProperties": false,
        "properties": {
          "customer": {
            "description": "vendor کا مقرر کردہ گاہک لیبل، کسٹمر پورٹل ای میل سے الگ۔",
            "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": "متوقع ڈیوائس بائنڈنگ generation، تنسیخ ٹرانزیکشن کے اندر موازنہ۔",
            "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 ٹوکن ضروری؛ vendor انتظامی 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 واضح طور پر وقفے وقفے سے heartbeat غیر فعال کرتا ہے؛ ورنہ 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": "ایک مقررہ خریداری/اپ گریڈ ادا کریں، یا سروس IDs کے بغیر رقم اور کرنسی سے والیٹ ٹاپ اپ بنائیں۔ مستحکم 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": "واضح اپ گریڈ overlay کے بعد موجودہ استحقاق۔ خریداری فہرست نقد تاریخ کے لیے اصل plan/base_cents رکھتی ہے؛ موجودہ مؤثر درجہ دکھانے کو یہ فیلڈ استعمال کریں۔",
            "type": "string"
          },
          "effective_plan_name": {
            "description": "واضح اپ گریڈ overlay کے بعد موجودہ استحقاق۔ خریداری فہرست نقد تاریخ کے لیے اصل 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": "گاہک کے موجودہ درجے سے جاری تحفہ ظاہر کرتا ہے۔ تحفہ اصل استحقاق قدر اور صفر نقد ادائیگی رکھتا ہے۔ واضح مکمل کوریج اپ گریڈ ہر غیر ختم شدہ تحفے پر الگ استحقاق overlay لاگو کرتے اور اصل صفر نقد تحفہ ریکارڈ رکھتے ہیں۔",
            "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 کے ہر آئٹم کی مشترکہ ادائیگی۔ ایک بار ایٹمی چارج ہوتی ہے۔ parent کے دیگر تناسبی فیلڈ صرف موجودہ مدت بتاتے ہیں؛ ہر مدت کی اصل قدر، ہدف قدر، باقی سیکنڈ اور انفرادی فرق 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": "اندرونی لاگو استحقاق overlays ایک parent چارج کی طرف اشارہ کرتے ہیں۔ یہ child ریکارڈ گاہک اپ گریڈ تاریخ اور فروخت تعداد سے خارج ہیں۔",
            "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": "آن لائن heartbeat کا وقفہ، سیکنڈ میں۔ 0 باقاعدہ heartbeat بند کرتا ہے؛ آف لائن اجازت الگ ہے۔",
            "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": "ہر ترمیم پر پالیسی revision بڑھتا ہے؛ پرانے لائسنس پر preview کی موجودہ حیثیت جانچتا ہے۔",
            "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 واضح طور پر وقفے وقفے سے heartbeat غیر فعال کرتا ہے؛ ورنہ 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": "آن لائن heartbeat کا وقفہ، سیکنڈ میں۔ 0 باقاعدہ heartbeat بند کرتا ہے؛ آف لائن اجازت الگ ہے۔",
            "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 آلات؛ 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 آزمائشی؛ بلنگ پیکیج کی subscription نہیں۔",
            "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": "vendor کا مقرر کردہ گاہک لیبل، کسٹمر پورٹل ای میل سے الگ۔",
                  "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 واضح طور پر وقفے وقفے سے heartbeat غیر فعال کرتا ہے؛ ورنہ 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؛ آئندہ درخواستوں کے لیے محفوظ کریں، لائسنس key نہیں۔",
            "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": "آخری کامیاب activation کا data.activation_id؛ پہلی activate کے علاوہ تصدیق، heartbeat، consume اور علیحدگی میں لازم۔",
            "format": "uuid",
            "type": "string"
          },
          "app_version": {
            "description": "موجودہ نسخہ major.minor.patch، مثلاً 1.0.0۔ maintenance یا 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"
          },
          "device_id": {
            "description": "پروڈکٹ، نظام اور hardware سے SDK کا حساب کردہ 64 lowercase hex SHA-256؛ من مانا مستقل عدد نہ دیں۔",
            "pattern": "^[0-9a-f]{64}$",
            "type": "string"
          },
          "device_name": {
            "description": "dashboard نام، زیادہ سے زیادہ 120 حروف؛ آلے کی شناخت نہیں طے کرتا۔",
            "maxLength": 120,
            "type": "string"
          },
          "device_profile": {
            "$ref": "#/components/schemas/DeviceProfile",
            "description": "SDK کا بنایا مشین profile؛ hardware شناخت، VM رد یا hardware منتقلی کی پالیسی کے مطابق دیں۔"
          },
          "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": "مکمل گاہک key: lv_lic_ عام؛ lv_tmp_ پہلی تبدیلی redemption؛ پھر 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 صلاحیت کا مذاکراتی عمل۔ موجودہ بائنڈنگ کا ٹکٹ محفوظ نہ ہو تو صرف ان لنک لاگ آؤٹ ٹکٹ مانگیں۔ درست ٹکٹ پہلے محفوظ ہو تو چھوڑ دیں؛ مستحکم حالت کے heartbeat اضافی ٹکٹ تلاش سے بچتے ہیں۔",
            "type": "boolean"
          },
          "reservation_id": {
            "description": "ریزرویشن ID؛ تصدیق یا منسوخی کے وقت یہی بھیجیں۔",
            "format": "uuid",
            "type": "string"
          },
          "reservation_seconds": {
            "default": 900,
            "description": "اختیاری مدت 30–3600 سیکنڈ، پہلے سے 900۔ مدت کا حساب نئے سرے سے شروع ہو تو پہلے ختم ہوتی ہے۔",
            "maximum": 3600,
            "minimum": 30,
            "type": "integer"
          },
          "session_id": {
            "description": "floating میں لازم: ہر چلتے instance کا نیا UUID، اسی کی درخواستوں میں وہی رکھیں۔ device-bound میں اختیاری۔",
            "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": "آن لائن heartbeat کا وقفہ، سیکنڈ میں۔ 0 باقاعدہ heartbeat بند کرتا ہے؛ آف لائن اجازت الگ ہے۔",
            "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؛ آئندہ درخواستوں کے لیے محفوظ کریں، لائسنس key نہیں۔",
            "format": "uuid",
            "type": "string"
          },
          "deactivated": {
            "description": "کامیاب علیحدگی پر true؛ بندش یا سیشن آزاد ہوتا ہے، لائسنس حذف یا مدت reset نہیں۔",
            "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 پر اوپری فیلڈ غائب ہو سکتی ہے؛ signed runtime_policy.heartbeat_seconds مکمل پالیسی قدر ہے۔",
            "type": "integer"
          },
          "lease": {
            "$ref": "#/components/schemas/Lease",
            "description": "سرور signed cache؛ مقرر معتبر public key، پروڈکٹ اور آلہ جانچ کر قبول کریں۔ علیحدگی یا 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": "لائسنس سرور origin، عموماً 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": "کوڈ میں پیسٹ کرنے کے عوامی پروڈکٹ constants؛ گاہک ایکٹیویشن راز نہیں۔",
            "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": "ورک اسپیس IDs کا JSON انکوڈ شدہ array؛ [] عالمی ہے۔",
            "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": "اجازت سیشن سے منسلک دستخط شدہ ڈیوائس بائنڈنگ generation۔",
            "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 leaf سرٹیفکیٹ کے بعد اس کے درمیانی سرٹیفکیٹ ترتیب سے۔ 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 leaf سرٹیفکیٹ کے بعد اس کے درمیانی سرٹیفکیٹ ترتیب سے۔ 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 اس مدت کا فرق ہے؛ مشترکہ رقم صرف parent کوٹ چارج کرتا ہے۔",
        "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": "موجودہ ڈیوائس فہرست میں دکھائی بائنڈنگ generation۔ 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": "ایک مقررہ خریداری/اپ گریڈ ادا کریں، یا سروس IDs کے بغیر رقم اور کرنسی سے والیٹ ٹاپ اپ بنائیں۔ مستحکم 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 استعمال کرتا ہے؛ خریدار شناخت vendor سیشن سے آزاد ہے۔",
        "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": "ur"
  },
  "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 key بنائیں",
        "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 key منسوخ کریں",
        "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 key تبدیل کریں",
        "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": "واپسی چیٹس خارج ہیں۔ گاہک صرف مجاز ورک اسپیس ٹکٹ دیکھتے ہیں؛ اراکین اپنے۔ ہر منتظم کا آزاد read watermark ہے۔",
        "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": "صرف آخری دکھائے پیغام تک پڑھے ہوئے نشان زد ہوتے ہیں۔ بعد میں آنے والے غیر پڑھے رہتے ہیں اور تاخیر سے رسید watermark پیچھے نہیں کر سکتی۔",
        "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": "اجرا کا heartbeat"
      }
    },
    "/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": "وصولی تسلیم کرنے سے پہلے مستقل محفوظ کریں۔ مختلف باڈی والے ڈپلیکیٹ IDs متصادم ہیں۔ ورکر مطلق میعاد اور مسلسل بڑھتے مجموعی ورژن ٹرانزیکشن میں لاگو، پرانے ورژن نظر انداز اور دستی جائزے سے پہلے ناکامی زیادہ سے زیادہ 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": "دستخط key تبدیل کریں",
        "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": "صرف عالمی اطلاعات عوامی ہیں؛ ہدف ورک اسپیس IDs ظاہر نہیں ہوتیں۔",
        "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 حالت پرانی تنسیخ کی کامیاب تکمیل ہے۔ SDKs اس درخواست سے پہلے مقامی استعمال روکتے اور رن ٹائم اسناد صاف کرتے ہیں۔",
        "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": "واپسی چیٹس خارج ہیں۔ گاہک صرف مجاز ورک اسپیس ٹکٹ دیکھتے ہیں؛ اراکین اپنے۔ ہر منتظم کا آزاد read watermark ہے۔",
        "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": "صرف آخری دکھائے پیغام تک پڑھے ہوئے نشان زد ہوتے ہیں۔ بعد میں آنے والے غیر پڑھے رہتے ہیں اور تاخیر سے رسید watermark پیچھے نہیں کر سکتی۔",
        "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": "ہدف ورک اسپیس پر ترتیب وار کارروائی کرتا ہے۔ منظوری دستیاب والیٹ رقم محفوظ، مستحکم فراہم کنندہ درخواست IDs سے اصل راستے کی واپسی مختص، اور متفقہ متبادل کی ضرورت والا بیلنس برقرار رکھتی ہے۔ 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 concurrency کے ساتھ چینلز ایٹمی طور پر فعال یا غیر فعال کریں",
        "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 منفرد فعال گاہک صارف IDs۔ ایک ورک اسپیس کے صارفین کو ایک معاہدہ ملتا ہے۔ ہر آئٹم اس گاہک کا موجودہ مؤثر پیکیج یا منتخب ماحول میں آخری ختم شدہ پیکیج اپناتا ہے۔ مخلوط درجے کے بیچ ہر آئٹم کا اصل پلان اور فائدہ قدر واپس کرتے ہیں۔ 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": "ای میل، نام یا ورک اسپیس کا بڑے چھوٹے حروف سے آزاد جزوی ملان؛ وائلڈ کارڈ حروف escape کیے جاتے ہیں۔",
            "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 اور اسپریڈ شیٹ فارمولا escaping۔ اسناد نہیں۔",
        "operationId": "get__api_v1_system_users_export_csv",
        "parameters": [
          {
            "description": "ای میل، نام یا ورک اسپیس کا بڑے چھوٹے حروف سے آزاد جزوی ملان؛ وائلڈ کارڈ حروف escape کیے جاتے ہیں۔",
            "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"
    }
  ]
}