{
  "openapi": "3.1.0",
  "info": {
    "title": "HIVE API",
    "description": "![Image](images/logo.png)\n# Documentazione delle API per il portale di Hive\n\n## Autenticazione\nL'autenticazione alle API avviene attraverso una API Key (Refresh Token) che può essere generata dal portale.\nLa generazione avviene nella sezione **Profilo Utente > API Keys** del portale Hive.\nUna volta completato il processo, verranno forniti il clientId e la API Key.\n\n### Ottenimento del Token\nPer ottenere un access token, effettuare una chiamata POST al seguente endpoint:\n\n[`/auth/api-key/login`](#/Authorization/post_auth_api_key_login)\n\n\n#### Durata dei token\n- **Access Token**: valido per 24 ore\n- **Refresh Token (API Key)**: valido per 10 anni\n\n### Utilizzo dell'Access Token\nL'access token ottenuto deve essere incluso nell'header di ogni richiesta successiva come segue:\n\n```\nAuthorization: Bearer {access_token}\n```\n\n# Moduli\n\n## Elenco Moduli\nDi seguito i moduli disponibili in questa documentazione:\n\n- Authorization\n- Audit Logs\n- Statuses\n- Carriers\n- Services\n- Circuits\n- Actions Runtime\n- Customers\n- Coverage\n- Numbers\n  - Numbers/Order\n  - Numbers/New Number\n  - Numbers/Portabilities\n- Regulatory\n",
    "version": "1.0.12",
    "contact": {
      "email": "sviluppo@hive-service.com"
    }
  },
  "servers": [
    {
      "url": "https://api.eis.it",
      "description": "Production server"
    }
  ],
  "tags": [
    {
      "name": "Authorization",
      "description": "Endpoints for obtaining and refreshing JWT tokens for API access."
    },
    {
      "name": "Audit Logs",
      "description": "Endpoints related to retrieving audit logs for customer activities."
    },
    {
      "name": "Statuses",
      "description": "Endpoints related to retrieving all statuses."
    },
    {
      "name": "Carriers",
      "description": "Endpoints related to carrier management."
    },
    {
      "name": "Services",
      "description": "Endpoints for retrieving service catalogs, organization services, options, and IP class profiles."
    },
    {
      "name": "Circuits",
      "description": "Endpoints related to circuit management and details."
    },
    {
      "name": "Actions Runtime",
      "description": "Runtime discovery and execution of actions available for API objects, including DSS trunks."
    },
    {
      "name": "Stats",
      "description": "Endpoints related to statistics and usage data."
    },
    {
      "name": "VoIP DSS",
      "x-displayName": "VoIP DSS",
      "description": "Endpoints related to DSS trunks, gateways, numbers, CDR and statistics."
    },
    {
      "name": "Customers",
      "description": "Endpoints related to customer management."
    },
    {
      "name": "Coverage",
      "description": "Endpoints related coverage."
    },
    {
      "name": "Numbers",
      "description": "Endpoints related to number resources."
    },
    {
      "name": "Numbers/Order",
      "description": "Endpoints related to numbering orders."
    },
    {
      "name": "Numbers/New Number",
      "description": "Endpoints related to native new number orders."
    },
    {
      "name": "Numbers/Portabilities",
      "description": "Endpoints related to portability orders."
    },
    {
      "name": "Regulatory",
      "description": "Endpoints related to regulatory management."
    }
  ],
  "externalDocs": {
    "description": "Find out more about our solutions",
    "url": "https://wiki.eis.it"
  },
  "paths": {
    "/auth/api-key/login": {
      "post": {
        "tags": [
          "Authorization"
        ],
        "summary": "Obtain JWT Access Tokens using the API Refresh Token",
        "description": "Generate a new JWT access token by providing a valid API key.",
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientId": {
                    "type": "string",
                    "description": "The client identifier"
                  },
                  "clientSecret": {
                    "type": "string",
                    "description": "The API Key (client secret)"
                  }
                },
                "required": [
                  "clientId",
                  "clientSecret"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tokens generated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "access_token": {
                      "type": "string",
                      "description": "JWT access token"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Invalid API key"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/audit-logs/list/{organizationId}": {
      "get": {
        "tags": [
          "Audit Logs"
        ],
        "summary": "Get all Audit Logs",
        "description": "Retrieve the complete list of audit logs for a specific organization.",
        "parameters": [
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "long"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of audit logs retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AuditLog"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Organization not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/status/list": {
      "get": {
        "tags": [
          "Statuses"
        ],
        "summary": "Get all Statuses",
        "description": "Retrieve the complete list of statuses, optionally filtered by module.",
        "parameters": [
          {
            "name": "module",
            "in": "query",
            "description": "Filter statuses by a specific module.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "voiporder",
                "numbers",
                "market",
                "circuits"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of statuses retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Status"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/status/{id}": {
      "get": {
        "tags": [
          "Statuses"
        ],
        "summary": "Get Status by ID",
        "description": "Retrieve detailed information for a specific status using its unique ID.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Status retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Status"
                }
              }
            }
          },
          "404": {
            "description": "Status not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/carrier/list": {
      "get": {
        "tags": [
          "Carriers"
        ],
        "summary": "Get all Carriers",
        "description": "Retrieve the complete list of carriers.",
        "responses": {
          "200": {
            "description": "List of carriers retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Carrier"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/stats/getdailyminutes/{organizationId}": {
      "get": {
        "tags": [
          "Stats"
        ],
        "summary": "Get Partner Daily Minutes",
        "description": "Retrieve daily minutes statistics for a specific organization.",
        "parameters": [
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Daily minutes statistics retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Stats_DailyMinutes"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Organization not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Trunks",
        "description": "Retrieve the list of DSS trunks.",
        "responses": {
          "200": {
            "description": "DSS trunks retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssTrunk"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/{trunkId}/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Trunk by ID",
        "description": "Retrieve a DSS trunk by trunk ID and organization ID.",
        "parameters": [
          {
            "name": "trunkId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunk retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DssTrunk"
                }
              }
            }
          },
          "404": {
            "description": "DSS trunk not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/customer/{customerId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Trunks by Customer",
        "description": "Retrieve DSS trunks for a specific customer.",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunks retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssTrunk"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Customer not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/allcountries/{trunkId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Trunk Countries",
        "description": "Retrieve countries enabled for a DSS trunk.",
        "parameters": [
          {
            "name": "trunkId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunk countries retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DssCountry"
                }
              }
            }
          },
          "404": {
            "description": "DSS trunk not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/numbers/{trunkId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get Numbers by Trunk ID",
        "description": "Retrieve numbers associated with a DSS trunk.",
        "parameters": [
          {
            "name": "trunkId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunk numbers retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssNumber"
                  }
                }
              }
            }
          },
          "404": {
            "description": "DSS trunk not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/registered/all": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get Registered DSS Trunks",
        "description": "Retrieve registered DSS trunks.",
        "responses": {
          "200": {
            "description": "Registered DSS trunks retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssRegisteredTrunk"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/registered/{trunkId}/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get Registered DSS Trunk by ID",
        "description": "Retrieve a registered DSS trunk by trunk ID and organization ID.",
        "parameters": [
          {
            "name": "trunkId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching DSS registrations retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssRegisteredTrunk"
                  }
                }
              }
            }
          },
          "404": {
            "description": "DSS trunk not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Gateways",
        "description": "Retrieve the list of DSS gateways.",
        "responses": {
          "200": {
            "description": "DSS gateways retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssGateway"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/{gatewayId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Gateway by ID",
        "description": "Retrieve a DSS gateway by ID.",
        "parameters": [
          {
            "name": "gatewayId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS gateway retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DssGatewayDetail"
                }
              }
            }
          },
          "404": {
            "description": "DSS gateway not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/customer/{customerId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Gateways by Customer",
        "description": "Retrieve DSS gateways for a specific customer.",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS gateways retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssGateway"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Customer not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/allcountries/{gatewayId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Gateway Countries",
        "description": "Retrieve countries enabled for a DSS gateway.",
        "parameters": [
          {
            "name": "gatewayId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS gateway countries retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DssCountry"
                }
              }
            }
          },
          "404": {
            "description": "DSS gateway not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/numbers/{gatewayId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get Numbers by Gateway ID",
        "description": "Retrieve numbers associated with a DSS gateway.",
        "parameters": [
          {
            "name": "gatewayId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS gateway numbers retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssNumber"
                  }
                }
              }
            }
          },
          "404": {
            "description": "DSS gateway not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/cdr/": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS CDR",
        "description": "Retrieve DSS CDR records using organization, trunk type and start time filters.",
        "parameters": [
          {
            "name": "organizationId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "idTrunk",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "typeTrunk",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "startTime",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS CDR records retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssCdr"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/stats/": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Stats Dashboard",
        "description": "Retrieve the DSS statistics dashboard.",
        "responses": {
          "200": {
            "description": "DSS statistics dashboard retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DssStats"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/stats/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Stats Dashboard by Organization",
        "description": "Retrieve the DSS statistics dashboard for a specific organization.",
        "parameters": [
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS statistics dashboard retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DssStats"
                }
              }
            }
          },
          "404": {
            "description": "Organization not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/stats/trunk/{trunkId}/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Trunk Stats",
        "description": "Retrieve DSS statistics for a trunk or gateway in a time range.",
        "parameters": [
          {
            "name": "trunkId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "startTime",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "endTime",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunk statistics retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssStatsItem"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/number/{numberId}/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get Trunk or Gateway by Number ID",
        "description": "Retrieve the DSS trunk or gateway associated with a number.",
        "parameters": [
          {
            "name": "numberId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunk or gateway retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DssNumberRoute"
                }
              }
            }
          },
          "404": {
            "description": "Number not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/available-number/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get Available DSS Numbers",
        "description": "Retrieve available DSS numbers for a specific organization.",
        "parameters": [
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Available DSS numbers retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/NumberDetail"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Organization not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/add": {
      "post": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Create a DSS Trunk",
        "deprecated": true,
        "description": "Deprecated. Use `POST /v1/voip/dss/trunks` to provision the DSS trunk from a preset. This legacy endpoint creates a trunk and optionally associates initial numbers and destinations.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NewTrunkRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "DSS trunk created successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/changecustomer": {
      "post": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Change DSS Trunk Customer",
        "description": "Change the customer associated with a DSS trunk.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangeCustomerTrunk"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "DSS trunk customer changed successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChangeCustomerTrunk"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/resetpassword": {
      "post": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Reset DSS Trunk Password",
        "description": "Reset the authentication password of a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. When omitted, the authenticated user's organization is used."
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunk password reset successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "DSS trunk not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/country": {
      "post": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable a DSS Trunk Destination",
        "description": "Enable a country destination for a DSS trunk.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrunkCountryRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Operation completed successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/country/massive/{idTrunk}/{continent}": {
      "post": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable DSS Trunk Destinations by Continent",
        "description": "Enable all supported country destinations in a continent for a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "continent",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Continent identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunk destinations enabled successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/add": {
      "post": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Create a DSS Gateway",
        "deprecated": true,
        "description": "Deprecated. Use `POST /v1/voip/dss/trunks` to provision the DSS resource from a preset. This legacy endpoint creates a DSS gateway directly.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NewGatewayRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "DSS gateway created successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/changecustomer": {
      "post": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Change DSS Gateway Customer",
        "description": "Change the customer associated with a DSS gateway.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangeCustomerGateway"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "DSS gateway customer changed successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChangeCustomerGateway"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/country": {
      "post": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable a DSS Gateway Destination",
        "description": "Enable a country destination for a DSS gateway.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GatewayCountryRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Operation completed successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/country/active-all": {
      "post": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable All DSS Gateway Destinations",
        "description": "Enable all supported country destinations for DSS gateways.",
        "responses": {
          "200": {
            "description": "DSS gateway destinations enabled successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DssCountry"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/addnumber": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Associate a Number with a DSS Trunk",
        "description": "Associate an available number with a DSS trunk.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrunkNumberRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Number associated with DSS trunk successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/country/setpremium": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable Premium Traffic for a DSS Trunk Destination",
        "description": "Enable premium traffic for a DSS trunk country destination.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrunkCountryRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/country/removepremium": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable Premium Traffic for a DSS Trunk Destination",
        "description": "Disable premium traffic for a DSS trunk country destination.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrunkCountryRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/disablecheckprefix/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable DSS Trunk Prefix Checking",
        "description": "Disable prefix checking for a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/enablecheckprefix/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable DSS Trunk Prefix Checking",
        "description": "Enable prefix checking for a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/enabletoinru/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable To In RU for a DSS Trunk",
        "description": "Enable To In RU handling for a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/disabletoinru/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable To In RU for a DSS Trunk",
        "description": "Disable To In RU handling for a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/setbk/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable Permanent Backup for a DSS Trunk",
        "description": "Enable permanent backup routing for a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/removebk/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable Permanent Backup for a DSS Trunk",
        "description": "Disable permanent backup routing for a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/block/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Block a DSS Trunk",
        "description": "Block traffic on a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/unblock/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Unblock a DSS Trunk",
        "description": "Unblock traffic on a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/enabledi/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable Dual Identity for a DSS Trunk",
        "description": "Enable dual identity for a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/disabledi/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable Dual Identity for a DSS Trunk",
        "description": "Disable dual identity for a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/channel/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Trunk Channels",
        "description": "Update the maximum number of concurrent channels for a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "maxChannel"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/bknumber/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Trunk Backup Number",
        "description": "Update the backup number for a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "bkNumber"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/credit/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Trunk Traffic Limit",
        "description": "Update the traffic credit limit for a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "trafficLimit"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/name/{idTrunk}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Rename a DSS Trunk",
        "description": "Update the display name of a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "nome"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/addnumber": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Associate a Number with a DSS Gateway",
        "description": "Associate an available number with a DSS gateway.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GatewayNumberRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Number associated with DSS gateway successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/country/setpremium": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable Premium Traffic for a DSS Gateway Destination",
        "description": "Enable premium traffic for a DSS gateway country destination.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GatewayCountryRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/country/removepremium": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable Premium Traffic for a DSS Gateway Destination",
        "description": "Disable premium traffic for a DSS gateway country destination.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GatewayCountryRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/enabledi/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable Dual Identity for a DSS Gateway",
        "description": "Enable dual identity for a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/disabledi/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable Dual Identity for a DSS Gateway",
        "description": "Disable dual identity for a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/disablecheckprefix/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable DSS Gateway Prefix Checking",
        "description": "Disable prefix checking for a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/enablecheckprefix/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable DSS Gateway Prefix Checking",
        "description": "Enable prefix checking for a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/setbk/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable Permanent Backup for a DSS Gateway",
        "description": "Enable permanent backup routing for a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/removebk/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable Permanent Backup for a DSS Gateway",
        "description": "Disable permanent backup routing for a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/block/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Block a DSS Gateway",
        "description": "Block traffic on a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/unblock/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Unblock a DSS Gateway",
        "description": "Unblock traffic on a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/channel/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Gateway Channels",
        "description": "Update the maximum number of concurrent channels for a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "maxChannel"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/bknumber/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Gateway Backup Number",
        "description": "Update the backup number for a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "bkNumber"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/credit/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Gateway Traffic Limit",
        "description": "Update the traffic credit limit for a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "trafficLimit"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/name/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Rename a DSS Gateway",
        "description": "Update the display name of a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "nome"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/primaryip/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Gateway Primary IP",
        "description": "Update the primary IP address and port of a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/GatewayIpRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "ipAddress"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/secondaryip/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Gateway Secondary IP",
        "description": "Update the secondary IP address and port of a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/GatewayIpRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "secondaryIP"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/ip/{idGtw}/{organizationId}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Gateway IP Settings",
        "description": "Update the primary and secondary IP settings of a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GatewayIpRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/delete/{idTrunk}/{organizationId}": {
      "delete": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Delete a DSS Trunk",
        "description": "Delete a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS trunk deleted successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/deletenumber": {
      "delete": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disassociate a Number from a DSS Trunk",
        "description": "Disassociate a number from a DSS trunk. This operation requires a request body.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrunkNumberRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Number disassociated from DSS trunk successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/country/{idTrunk}/{iso}/{organizationId}": {
      "delete": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Remove a DSS Trunk Destination",
        "description": "Remove a country destination from a DSS trunk.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "iso",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Country ISO code"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS trunk destination removed successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/delete/{idGtw}/{organizationId}": {
      "delete": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Delete a DSS Gateway",
        "description": "Delete a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS gateway deleted successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/deletenumber": {
      "delete": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disassociate a Number from a DSS Gateway",
        "description": "Disassociate a number from a DSS gateway. This operation requires a request body.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GatewayNumberRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Number disassociated from DSS gateway successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/country/{idGtw}/{iso}/{organizationId}": {
      "delete": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Remove a DSS Gateway Destination",
        "description": "Remove a country destination from a DSS gateway.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "iso",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Country ISO code"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization identifier. The API also provides an alternative route without this path segment; that route uses the authenticated user's organization."
          }
        ],
        "responses": {
          "204": {
            "description": "DSS gateway destination removed successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/service": {
      "get": {
        "operationId": "getServicesByType",
        "tags": [
          "Services"
        ],
        "summary": "Get Services by Type",
        "description": "Retrieve organization services for a service type. When `id` is provided, the result is restricted to that service identifier.",
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "description": "Optional service identifier."
          },
          {
            "name": "typeId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Service type identifier."
          },
          {
            "name": "forDirect",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "Accepted for compatibility; the current implementation does not apply this value."
          },
          {
            "name": "forSub",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "Accepted for compatibility; the current implementation does not apply this value."
          }
        ],
        "responses": {
          "200": {
            "description": "Services retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ServiceOrg"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Missing or invalid parameters"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/activable": {
      "get": {
        "operationId": "getActivableServices",
        "tags": [
          "Services"
        ],
        "summary": "Get Activable Services",
        "description": "List the service profiles available for activation by the selected organization.",
        "parameters": [
          {
            "name": "organizationId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": 0
            },
            "description": "Organization identifier. Omit it or pass `0` to use the authenticated user's organization. Selecting a descendant organization requires the `subpartner_view` authority."
          },
          {
            "name": "typeId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Service type identifier. Omit it to list profiles across all service types."
          }
        ],
        "responses": {
          "200": {
            "description": "Activable service profiles. Returns an empty array when no profiles match.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ActivableServiceResponse"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters or organization not found"
          },
          "403": {
            "description": "Forbidden - Access to the requested organization is denied"
          }
        }
      }
    },
    "/v1/service/options/activable": {
      "get": {
        "operationId": "getActivableServiceOptions",
        "tags": [
          "Services"
        ],
        "summary": "Get Activable Service Options",
        "description": "List the options available for activation by the selected organization. Each option includes the associated profile ID in `serviceId`.",
        "parameters": [
          {
            "name": "organizationId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": 0
            },
            "description": "Organization identifier. Omit it or pass `0` to use the authenticated user's organization. Selecting a descendant organization requires the `subpartner_view` authority."
          },
          {
            "name": "serviceId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Filter by an organization service profile ID returned by `GET /v1/service/activable`. Omit it to list options across all activable profiles."
          }
        ],
        "responses": {
          "200": {
            "description": "Activable service options. Returns an empty array when no options match or the specified profile is outside the organization's activable catalog.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ActivableServiceOptionResponse"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters or organization not found"
          },
          "403": {
            "description": "Forbidden - Access to the requested organization is denied"
          }
        }
      }
    },
    "/v1/service/all": {
      "get": {
        "operationId": "getAllServicesByType",
        "tags": [
          "Services"
        ],
        "summary": "Get All Services by Type",
        "description": "Retrieve all organization services for a service type. Requires the `service_edit` authority.",
        "parameters": [
          {
            "name": "typeId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Service type identifier."
          },
          {
            "name": "forDirect",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "Accepted for compatibility; the current implementation does not apply this value."
          },
          {
            "name": "forSub",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "Accepted for compatibility; the current implementation does not apply this value."
          }
        ],
        "responses": {
          "200": {
            "description": "Services retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ServiceOrg"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Missing or invalid parameters"
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/type": {
      "get": {
        "operationId": "getServiceTypes",
        "tags": [
          "Services"
        ],
        "summary": "Get Service Types",
        "description": "Retrieve all service types or a specific service type when `id` is provided.",
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "description": "Optional service type identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "Service types retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ServiceType"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid service type identifier"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/carrier": {
      "get": {
        "operationId": "getServicesByCarrier",
        "tags": [
          "Services"
        ],
        "summary": "Get Services by Carrier",
        "description": "Retrieve organization services matching a carrier and carrier type.",
        "parameters": [
          {
            "name": "carrierId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Carrier identifier."
          },
          {
            "name": "carrierType",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Carrier-specific service classification."
          }
        ],
        "responses": {
          "200": {
            "description": "Services retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ServiceOrg"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Missing or invalid parameters"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/filter": {
      "get": {
        "operationId": "filterServiceCatalog",
        "tags": [
          "Services"
        ],
        "summary": "Filter Service Catalog Entries",
        "description": "Retrieve catalog entries for a service type and provider, optionally filtering by name. Requires the `service_view` authority.",
        "parameters": [
          {
            "name": "typeId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Service type identifier."
          },
          {
            "name": "providerId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Service provider identifier."
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Optional case-insensitive name filter."
          }
        ],
        "responses": {
          "200": {
            "description": "Service catalog entries retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ServiceList"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Missing or invalid parameters"
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/org/list": {
      "get": {
        "operationId": "getOrganizationServices",
        "tags": [
          "Services"
        ],
        "summary": "Get Organization Services",
        "description": "Retrieve services visible to the authenticated user's organization. Requires the `service_view` authority.",
        "responses": {
          "200": {
            "description": "Organization services retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ServiceOrg"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/org/filter": {
      "get": {
        "operationId": "filterOrganizationServices",
        "tags": [
          "Services"
        ],
        "summary": "Filter Organization Services",
        "description": "Retrieve organization services, optionally filtering by carrier type. Requires the `service_view` authority.",
        "parameters": [
          {
            "name": "carrierType",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Optional carrier-specific service classification."
          }
        ],
        "responses": {
          "200": {
            "description": "Organization services retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ServiceOrg"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/org/{id}/{organizationId}": {
      "get": {
        "operationId": "getOrganizationService",
        "tags": [
          "Services"
        ],
        "summary": "Get an Organization Service",
        "description": "Retrieve a configured service by its identifier and organization. Requires the `service_view` authority.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization service identifier."
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "Organization service retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceOrg"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "404": {
            "description": "Organization service not found"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/org/ip-classes": {
      "get": {
        "operationId": "getProviderIpClasses",
        "tags": [
          "Services"
        ],
        "summary": "Get IP Classes by Provider",
        "description": "Retrieve IPv4 and IPv6 service profiles available for a provider. Requires the `circuits_view` authority.",
        "parameters": [
          {
            "name": "providerId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Service provider identifier."
          },
          {
            "name": "organizationId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": 0
            },
            "description": "Organization identifier. Use `0` to resolve it from the authenticated user."
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Optional IP class type filter."
          }
        ],
        "responses": {
          "200": {
            "description": "IP class catalog retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IpClassCatalogResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Missing or invalid parameters"
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "404": {
            "description": "Service provider not found"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/org/{profileId}/ip-classes": {
      "get": {
        "operationId": "getProfileIpClasses",
        "tags": [
          "Services"
        ],
        "summary": "Get IP Classes by Profile",
        "description": "Retrieve IPv4 and IPv6 service profiles related to an organization service profile. Requires the `circuits_view` authority.",
        "parameters": [
          {
            "name": "profileId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization service profile identifier."
          },
          {
            "name": "organizationId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": 0
            },
            "description": "Organization identifier. Use `0` to resolve it from the authenticated user."
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Optional IP class type filter."
          }
        ],
        "responses": {
          "200": {
            "description": "IP class catalog retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IpClassCatalogResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Missing or invalid parameters"
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "404": {
            "description": "Organization service profile not found"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/org/option/{serviceId}/all": {
      "get": {
        "operationId": "getOrganizationServiceOptions",
        "tags": [
          "Services"
        ],
        "summary": "Get Organization Service Options",
        "description": "Retrieve all configured organization options for a service. Requires the `service_view` authority.",
        "parameters": [
          {
            "name": "serviceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization service identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "Organization service options retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ServiceOrgOption"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/org/option/{optionOrgId}/{organizationId}": {
      "get": {
        "operationId": "getOrganizationServiceOption",
        "tags": [
          "Services"
        ],
        "summary": "Get an Organization Service Option",
        "description": "Retrieve a configured service option by identifier and organization. Requires the `service_view` authority.",
        "parameters": [
          {
            "name": "optionOrgId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Organization service option identifier."
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "Organization service option retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceOrgOption"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "404": {
            "description": "Organization service option not found"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/option/{serviceId}/all": {
      "get": {
        "operationId": "getServiceCatalogOptions",
        "tags": [
          "Services"
        ],
        "summary": "Get Catalog Options for a Service",
        "description": "Retrieve all original catalog options belonging to a service. Requires the `service_view` authority.",
        "parameters": [
          {
            "name": "serviceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Service catalog entry identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "Service options retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ServiceOption"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/option/{optionId}": {
      "get": {
        "operationId": "getServiceCatalogOption",
        "tags": [
          "Services"
        ],
        "summary": "Get a Catalog Service Option",
        "description": "Retrieve an original catalog option by identifier. Requires the `service_view` authority.",
        "parameters": [
          {
            "name": "optionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Service option identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "Service option retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceOption"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "404": {
            "description": "Service option not found"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/service/org/option/add": {
      "post": {
        "operationId": "addOrganizationServiceOption",
        "tags": [
          "Services"
        ],
        "summary": "Add an organization service option",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ServiceRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Organization service option created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceOrgOption"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "403": {
            "description": "Insufficient permissions"
          }
        }
      }
    },
    "/v1/service/org/option/edit": {
      "put": {
        "operationId": "updateOrganizationServiceOption",
        "tags": [
          "Services"
        ],
        "summary": "Update an organization service option",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ServiceRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Organization service option updated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceOrgOption"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "403": {
            "description": "Insufficient permissions"
          }
        }
      }
    },
    "/v1/service/org/option/delete/{serviceOrgOptionId}/{organizationId}": {
      "delete": {
        "operationId": "deleteOrganizationServiceOption",
        "tags": [
          "Services"
        ],
        "summary": "Delete an organization service option",
        "parameters": [
          {
            "name": "serviceOrgOptionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Organization service option deleted"
          },
          "403": {
            "description": "Insufficient permissions"
          }
        }
      }
    },
    "/v1/service/org/add": {
      "post": {
        "operationId": "addOrganizationService",
        "tags": [
          "Services"
        ],
        "summary": "Add an organization service",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ServiceRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Organization service created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceOrg"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "403": {
            "description": "Insufficient permissions"
          }
        }
      }
    },
    "/v1/service/org/edit": {
      "put": {
        "operationId": "updateOrganizationService",
        "tags": [
          "Services"
        ],
        "summary": "Update an organization service",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ServiceRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Organization service updated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceOrg"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "403": {
            "description": "Insufficient permissions"
          }
        }
      }
    },
    "/v1/service/org/delete/{id}/{organizationId}": {
      "delete": {
        "operationId": "deleteOrganizationService",
        "tags": [
          "Services"
        ],
        "summary": "Delete an organization service",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Organization service deleted"
          },
          "403": {
            "description": "Insufficient permissions"
          }
        }
      }
    },
    "/v1/voip/dss/trunk-presets": {
      "get": {
        "operationId": "getDssTrunkPresets",
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Trunk Presets",
        "description": "Retrieve the DSS trunk presets visible to the authenticated user's organization. Requires the `trunksip_view` authority.",
        "responses": {
          "200": {
            "description": "DSS trunk presets retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TrunkPresetResponse"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/voip/dss/trunk-presets/{organizationId}": {
      "get": {
        "operationId": "getDssTrunkPresetsByOrganization",
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Trunk Presets by Organization",
        "description": "Retrieve the DSS trunk presets visible to a specific organization. Requires the `trunksip_view` authority.",
        "parameters": [
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunk presets retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TrunkPresetResponse"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "404": {
            "description": "Organization not found"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/voip/dss/trunks": {
      "post": {
        "operationId": "createDssPresetTrunk",
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Create a DSS Trunk from a Preset",
        "description": "Provision a DSS trunk using a visible preset and the supplied field values. Requires the `trunksip_add` authority.\n\nThe response includes an `actionObject`. Use its module, organization, object type, object identifier, and context to discover and execute the runtime actions available for the new trunk.\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePresetTrunkRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "DSS trunk provisioned successfully.",
            "headers": {
              "Cache-Control": {
                "description": "Prevents storage of sensitive or one-time provisioning outputs.",
                "schema": {
                  "type": "string",
                  "example": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreatePresetTrunkResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid preset parameters"
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "404": {
            "description": "Preset, customer, or organization not found"
          },
          "409": {
            "description": "Provisioning conflict or organization not associated with DSS"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/actions/runtime/modules/{moduleId}/organizations/{organizationId}/objects/{objectType}/{objectId}": {
      "get": {
        "operationId": "getRuntimeActions",
        "tags": [
          "Actions Runtime"
        ],
        "summary": "Get Available Runtime Actions",
        "description": "Resolve an API object and return the action groups currently available to the authenticated user.\n\nFor a DSS trunk, copy the values from the trunk's `actionObject`: use `DSS_TRUNK` as `objectType`, the trunk identifier as `objectId`, and pass its context entries as query parameters prefixed with `context.`. In particular, `context.presetId` is required.\n",
        "parameters": [
          {
            "name": "moduleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            },
            "description": "Module identifier from `actionObject.moduleId`."
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1
            },
            "description": "Organization identifier from `actionObject.organizationId`."
          },
          {
            "name": "objectType",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "example": "DSS_TRUNK"
            },
            "description": "Runtime object type from `actionObject.objectType`."
          },
          {
            "name": "objectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Object identifier from `actionObject.objectId`."
          },
          {
            "name": "context.presetId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1
            },
            "description": "DSS preset identifier from `actionObject.context.presetId`."
          }
        ],
        "responses": {
          "200": {
            "description": "Runtime actions retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionRuntimeResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid object or context"
          },
          "403": {
            "description": "Forbidden - Missing module or action authority"
          },
          "404": {
            "description": "Runtime object, provisioning, or preset not found"
          },
          "409": {
            "description": "Multiple provisionings are associated with the object"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/actions/runtime/executions": {
      "post": {
        "operationId": "executeRuntimeAction",
        "tags": [
          "Actions Runtime"
        ],
        "summary": "Execute a Runtime Action",
        "description": "Execute an action returned by the runtime discovery endpoint against the supplied `actionObject`. For DSS trunks, preserve the complete object reference and its `presetId` context.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExecuteActionRuntimeRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Runtime action executed successfully.",
            "headers": {
              "Cache-Control": {
                "description": "Prevents storage of sensitive or one-time action outputs.",
                "schema": {
                  "type": "string",
                  "example": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExecuteActionRuntimeResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid action object or parameters"
          },
          "403": {
            "description": "Forbidden - Missing module or action authority"
          },
          "404": {
            "description": "Runtime object, action, provisioning, or preset not found"
          },
          "409": {
            "description": "Action cannot be executed in the current object state"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/circuits/": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get all Circuits",
        "description": "Retrieve the complete list of circuits.",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Circuit"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Circuit by Order ID",
        "description": "Retrieve circuit information for a specific order ID.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Circuit"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/customer/{customerId}": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Circuit by Customer ID",
        "description": "Retrieve circuit information for a specific customer ID.",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "$ref": "#/components/schemas/Circuit"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}/{organizationId}/details": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Circuit Details by Order ID and Organization ID",
        "description": "Retrieve detailed information for a specific circuit using its order ID and organization ID.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "long"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Circuit_Detail"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/migration/carrier/{carrierId}": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Circuit by Carrier ID",
        "description": "Retrieve circuit information for a specific carrier ID.",
        "parameters": [
          {
            "name": "carrierId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/order/ipv4": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Circuit by Order ID with IPv4",
        "description": "Retrieve circuit information for a specific order ID, including IPv4 details.",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ServiceOrg"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/order/ipv6": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Circuit by Order ID with IPv6",
        "description": "Retrieve circuit information for a specific order ID, including IPv6 details.",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ServiceOrg"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}/{organizationId}/ping": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Ping Circuit by Order ID and Organization ID",
        "description": "Ping a specific circuit using its order ID and organization ID.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "long"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Circuit_ping"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}/{organizationId}/connectionlog": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Connection Log for Circuit by Order ID and Organization ID",
        "description": "Retrieve connection log information for a specific circuit using its order ID and organization ID.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "long"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Circuit_logs"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}/{organizationId}/ngasp/alignment": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get NGASP Alignment for Circuit by Order ID and Organization ID",
        "description": "Retrieve NGASP alignment information for a specific circuit using its order ID and organization ID.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "long"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Circuit_NGASP"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}/{organizationId}/charts/bandwidth/{xdslType}": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Bandwidth Chart for Circuit by Order ID and Organization ID",
        "description": "Retrieve bandwidth chart information for a specific circuit using its order ID and organization ID.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "long"
            }
          },
          {
            "name": "xdslType",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}/{organizationId}/ipclass": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get IP Class for Circuit by Order ID and Organization ID",
        "description": "Retrieve IP class  information for a specific circuit using its order ID and organization ID.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "long"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Circuit_IPClasses"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/coverage/manual/getcity": {
      "get": {
        "tags": [
          "Coverage"
        ],
        "summary": "Get City Information by City Name",
        "description": "Retrieve city information including province, postal code, and other details by city name.",
        "parameters": [
          {
            "name": "city",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The city name to search for"
          }
        ],
        "responses": {
          "200": {
            "description": "City information retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CoverageCity"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid city parameter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "City not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/coverage/manual/getaddress": {
      "get": {
        "tags": [
          "Coverage"
        ],
        "summary": "Get Address Information by City ID and Address",
        "description": "Retrieve address details for a specific city using the city ID and address name.",
        "parameters": [
          {
            "name": "idCity",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The unique city identifier"
          },
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The address or street name to search for"
          }
        ],
        "responses": {
          "200": {
            "description": "Address information retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CoverageAddress"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Address not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/coverage/manual/getstreetnumber": {
      "get": {
        "tags": [
          "Coverage"
        ],
        "summary": "Get Street Number Information by Address ID and Street Number",
        "description": "Retrieve street number and toponomastico information for a specific address.",
        "parameters": [
          {
            "name": "idAddress",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The unique address identifier"
          },
          {
            "name": "streetNumber",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The street number to search for"
          }
        ],
        "responses": {
          "200": {
            "description": "Street number information retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CoverageStreetNumber"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Street number not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/coverage/validate": {
      "post": {
        "tags": [
          "Coverage"
        ],
        "summary": "Validate Address Information",
        "description": "Validate city, address, and street number information in a single request.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CoverageValidateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Address validation completed successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CoverageValidateResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/orders/customer/{idCustomer}": {
      "get": {
        "tags": [
          "Numbers/Order"
        ],
        "summary": "Get Number Order by Customer ID",
        "description": "Retrieve a numbering order by its customer ID. If the organization is not specified, the authenticated user's organization is used.",
        "parameters": [
          {
            "name": "idCustomer",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The customer identifier"
          },
          {
            "name": "type",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Service type identifier used to filter the number orders. This parameter is required; omitting it returns HTTP 400."
          }
        ],
        "responses": {
          "200": {
            "description": "Number order retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/NumberOrder"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Missing or invalid `type` query parameter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Order not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/orders/customer/{idCustomer}/{organizationId}": {
      "get": {
        "tags": [
          "Numbers/Order"
        ],
        "summary": "Get Number Order by Customer ID and Organization ID",
        "description": "Retrieve a numbering order by its customer ID and organization ID.",
        "parameters": [
          {
            "name": "idCustomer",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The customer identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The organization identifier"
          },
          {
            "name": "type",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "Service type identifier used to filter the number orders. This parameter is required; omitting it returns HTTP 400."
          }
        ],
        "responses": {
          "200": {
            "description": "Number order retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/NumberOrder"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Missing or invalid `type` query parameter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Order not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/orders/{idOrder}": {
      "get": {
        "tags": [
          "Numbers/Order"
        ],
        "summary": "Get Number Order by Order ID",
        "description": "Retrieve a single numbering order by its order ID. If the organization is not specified, the authenticated user's partner organization is used.",
        "parameters": [
          {
            "name": "idOrder",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The order identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Number order retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NumberOrder"
                }
              }
            }
          },
          "404": {
            "description": "Order not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/orders/{idOrder}/{organizationId}": {
      "get": {
        "tags": [
          "Numbers/Order"
        ],
        "summary": "Get Number Order by Order ID and Organization ID",
        "description": "Retrieve a single numbering order by its order ID and organization ID.",
        "parameters": [
          {
            "name": "idOrder",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The order identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The organization identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Number order retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NumberOrder"
                }
              }
            }
          },
          "404": {
            "description": "Order not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/orders/{idOrder}/{organizationId}/history": {
      "get": {
        "tags": [
          "Numbers/Order"
        ],
        "summary": "Get Number Order History",
        "description": "Retrieve the full history of a numbering order by order ID and organization ID.",
        "parameters": [
          {
            "name": "idOrder",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The order identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The organization identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Number order history retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/NumberOrderHistoryItem"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Order not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/orders/new-numbers/optimized": {
      "get": {
        "tags": [
          "Numbers/New Number"
        ],
        "summary": "Get All Native New Number Orders",
        "description": "Retrieve all native new number orders.",
        "responses": {
          "200": {
            "description": "Native new number orders retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/NumberNewOrderItem"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/orders/new-number": {
      "post": {
        "tags": [
          "Numbers/New Number"
        ],
        "summary": "Create a Native New Number Order",
        "description": "Create a new native number order.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NumberNewOrderRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "New number order created successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/orders/portabilities/optimized": {
      "get": {
        "tags": [
          "Numbers/Portabilities"
        ],
        "summary": "Get All Portability Orders",
        "description": "Retrieve all portability orders.",
        "responses": {
          "200": {
            "description": "Portability orders retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/NumberPortabilityItem"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/orders/migration-code": {
      "post": {
        "tags": [
          "Numbers/Portabilities"
        ],
        "summary": "Check Migration Code",
        "description": "Validate the migration code and return the carrier and routing details.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NumberMigrationCodeRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Migration code checked successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NumberMigrationCodeResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/orders/reschedule": {
      "post": {
        "tags": [
          "Numbers/Portabilities"
        ],
        "summary": "Reschedule a Portability Order",
        "description": "Reschedule a portability order by changing its DAC date.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NumberRescheduleRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Portability order rescheduled successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/orders/cancel/{idOrder}/{organizationId}": {
      "delete": {
        "tags": [
          "Numbers/Portabilities"
        ],
        "summary": "Cancel a Portability Order",
        "description": "Cancel an existing portability order by order ID and organization ID.",
        "parameters": [
          {
            "name": "idOrder",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The order identifier to cancel"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The organization identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Portability order cancelled successfully."
          },
          "404": {
            "description": "Order not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/orders/number-portability": {
      "post": {
        "tags": [
          "Numbers/Portabilities"
        ],
        "summary": "Create a New Portability Order",
        "description": "Create a new portability order.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NumberPortabilityCreateRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Portability order created successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/optimized": {
      "get": {
        "tags": [
          "Numbers"
        ],
        "summary": "Get Numbers",
        "description": "Retrieve an optimized list of numbers.",
        "responses": {
          "200": {
            "description": "Numbers retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/NumberItem"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/{idNumber}": {
      "get": {
        "tags": [
          "Numbers"
        ],
        "summary": "Get Number by ID",
        "description": "Retrieve detailed number information by number ID.",
        "parameters": [
          {
            "name": "idNumber",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The number identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Number retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NumberDetail"
                }
              }
            }
          },
          "404": {
            "description": "Number not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/customer/{customerId}": {
      "get": {
        "tags": [
          "Numbers"
        ],
        "summary": "Get Numbers by Customer ID",
        "description": "Retrieve all numbers associated with a customer.",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The customer identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Numbers retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/NumberDetail"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Customer not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/activate": {
      "post": {
        "tags": [
          "Numbers"
        ],
        "summary": "Activate a Number",
        "description": "Activate a number using the selected VoIP platform, organization, DBU data, and optional provider-specific trunk settings.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NumberActivateRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Number activated successfully."
          },
          "400": {
            "description": "The number is already active or deleted, or the request is invalid.\n\nWhen the number is already active or deleted, the response body is:\n\n```json\n{\n  \"status\": \"BAD_REQUEST\",\n  \"message\": \"Number already active or deleted\",\n  \"errors\": \"Number already active or deleted\"\n}\n```\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/terminate": {
      "post": {
        "tags": [
          "Numbers"
        ],
        "summary": "Terminate a Number",
        "description": "Terminate a number for the specified organization.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NumberTerminateRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Number terminated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Number not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/coverage/getcoverage": {
      "get": {
        "tags": [
          "Coverage"
        ],
        "summary": "Get Available Circuit Technologies",
        "deprecated": true,
        "description": "Deprecated. Use `/v1/coverage/shared` for shared-access coverage or `/v1/coverage/dedicated` for dedicated-access coverage. Retrieve all active circuit technologies for the specified street, building, and optional technology filter.",
        "parameters": [
          {
            "name": "streetEgon",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The EGON code of the street"
          },
          {
            "name": "streetNumber",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The street number"
          },
          {
            "name": "mainEgon",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The EGON code of the main connection point"
          },
          {
            "name": "technology",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "adsl",
                "fttcab",
                "fttc",
                "ftth",
                "ftthome"
              ]
            },
            "description": "Optional technology filter. If omitted, all available technologies are returned."
          }
        ],
        "responses": {
          "200": {
            "description": "Coverage technologies retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CoverageTechnologyItem"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/coverage/shared": {
      "get": {
        "operationId": "getSharedCoverage",
        "tags": [
          "Coverage"
        ],
        "summary": "Get Shared Circuit Coverage",
        "description": "Retrieve shared-access circuit coverage for the specified address. The optional technology filter accepts the aliases normalized by the API.",
        "parameters": [
          {
            "name": "streetEgon",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The EGON code of the street"
          },
          {
            "name": "mainEgon",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The EGON code of the main connection point"
          },
          {
            "name": "streetNumber",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The street number"
          },
          {
            "name": "technology",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "adsl",
                "fttcab",
                "fttc",
                "ftth",
                "ftthome"
              ]
            },
            "description": "Optional technology filter. If omitted, all shared technologies are returned."
          }
        ],
        "responses": {
          "200": {
            "description": "Shared circuit coverage retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CoverageTechnologyItem"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters or unsupported technology",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/coverage/dedicated": {
      "get": {
        "operationId": "getDedicatedCoverage",
        "tags": [
          "Coverage"
        ],
        "summary": "Get Dedicated Circuit Coverage",
        "description": "Retrieve dedicated-access circuit coverage for the specified address.",
        "parameters": [
          {
            "name": "streetEgon",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The EGON code of the street"
          },
          {
            "name": "mainEgon",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The EGON code of the main connection point"
          },
          {
            "name": "streetNumber",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The street number"
          }
        ],
        "responses": {
          "200": {
            "description": "Dedicated circuit coverage retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CoverageTechnologyItem"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - Invalid parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/dad/minimum": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Verify Minimum Date Selectable",
        "description": "Verify the minimum selectable DAD date using a date and offset.",
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Minimum selectable date verified successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Circuit_MinimumDate"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/dad/holiday": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Verify Holiday",
        "description": "Verify whether the provided date is a holiday.",
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Holiday verification completed successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Circuit_verifyHoliday"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/stats/count": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Circuits Count",
        "description": "Retrieve the total number of circuits.",
        "responses": {
          "200": {
            "description": "Circuits count retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "active": {
                      "type": "integer"
                    },
                    "ko": {
                      "type": "integer"
                    },
                    "delivering": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/activate": {
      "post": {
        "tags": [
          "Circuits"
        ],
        "summary": "Activate Circuit",
        "description": "Create an activation request for a new circuit.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CircuitActivateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Circuit activation requested successfully."
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/migrate": {
      "post": {
        "tags": [
          "Circuits"
        ],
        "summary": "Migrate Circuit",
        "description": "Create a migration request for an existing circuit.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CircuitMigrateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Circuit migration requested successfully."
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/terminate": {
      "post": {
        "tags": [
          "Circuits"
        ],
        "summary": "Terminate Circuit",
        "description": "Terminate a circuit by ID and organization ID.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CircuitTerminateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Circuit terminated successfully."
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/migration/checkmc": {
      "post": {
        "tags": [
          "Circuits"
        ],
        "summary": "Check Migration Code",
        "description": "Validate a migration code for the provided carrier.",
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/CircuitMigrationCheckMcRequest"
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/CircuitMigrationCheckMcRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Migration code checked successfully."
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/migration/validate-cow": {
      "post": {
        "tags": [
          "Circuits"
        ],
        "summary": "Validate COW",
        "description": "Validate a COW code.",
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/CircuitValidateCowRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "COW validated successfully."
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/migration/validate-cor": {
      "post": {
        "tags": [
          "Circuits"
        ],
        "summary": "Validate COR",
        "description": "Validate a COR code using the related COW code.",
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/CircuitValidateCorRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "COR validated successfully."
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/newipclass": {
      "post": {
        "tags": [
          "Circuits"
        ],
        "summary": "Add New IP Class",
        "description": "Add a new IP class to a circuit.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CircuitNewIpClassRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "IP class added successfully."
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/change/profile": {
      "post": {
        "tags": [
          "Circuits"
        ],
        "summary": "Change Circuit Profile",
        "description": "Change the profile and MCR of a circuit.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CircuitChangeProfileRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Circuit profile changed successfully."
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/change/sla": {
      "post": {
        "tags": [
          "Circuits"
        ],
        "summary": "Change Circuit SLA",
        "description": "Change the SLA of a circuit.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CircuitChangeSlaRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Circuit SLA changed successfully."
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/change-status": {
      "post": {
        "tags": [
          "Circuits"
        ],
        "summary": "Change Circuit Status",
        "description": "Change the status of a circuit order.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CircuitChangeStatusRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Circuit status changed successfully."
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/change/appointment-date": {
      "post": {
        "tags": [
          "Circuits"
        ],
        "summary": "Change Appointment Date",
        "description": "Change the appointment date of a circuit.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CircuitChangeAppointmentDateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Appointment date changed successfully."
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/change/complete-date": {
      "post": {
        "tags": [
          "Circuits"
        ],
        "summary": "Change Complete Date",
        "description": "Change the complete date of a circuit.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CircuitChangeCompleteDateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Complete date changed successfully."
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/deleteipclass": {
      "delete": {
        "tags": [
          "Circuits"
        ],
        "summary": "Delete IP Class",
        "description": "Delete an IP class from a circuit.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CircuitDeleteIpClassRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "IP class deleted successfully."
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/customers/": {
      "get": {
        "tags": [
          "Customers"
        ],
        "summary": "Get all Customers",
        "description": "Retrieve the complete list of customers.",
        "responses": {
          "200": {
            "description": "List of customers retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Customer"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/customers/organization/{organizationId}": {
      "get": {
        "tags": [
          "Customers"
        ],
        "summary": "Get Customers by Organization ID",
        "description": "Retrieve customers associated with a specific organization ID.",
        "parameters": [
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of customers retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Customer"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Organization not found"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/customers/{customerId}": {
      "get": {
        "tags": [
          "Customers"
        ],
        "summary": "Get Customer by ID",
        "description": "Retrieve detailed information for a specific customer using its unique ID.",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Customer retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Customer"
                }
              }
            }
          },
          "404": {
            "description": "Customer not found"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/customers/{id}/{organizationId}/branches": {
      "get": {
        "tags": [
          "Customers"
        ],
        "summary": "Get Customer Branches",
        "description": "Elenca le branch visibili della sede principale. Richiede customers_view. Restituisce 404 anche quando non ci sono branch visibili.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Operazione completata.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Customer"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Richiesta non valida o gerarchia delle sedi incompatibile."
          },
          "401": {
            "description": "Autenticazione richiesta."
          },
          "403": {
            "description": "Permessi insufficienti."
          },
          "404": {
            "description": "Anagrafica non trovata o non visibile."
          }
        }
      }
    },
    "/v1/customers/update/{id}/{organizationId}/main-customer/branches": {
      "put": {
        "tags": [
          "Customers"
        ],
        "summary": "Add Customer Branches",
        "description": "Collega anagrafiche esistenti alla sede principale indicata da id, mantenendo le altre branch. Richiede customers_edit. secondaryCustomerIds deve essere non vuoto, senza duplicati e senza id della sede principale. Le anagrafiche devono appartenere alla stessa organizzazione e non avere proprie branch. Il collegamento può spostare una branch da un’altra sede. Con multisede abilitato la partita IVA deve coincidere con quella della sede principale. Operazione transazionale.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateMainCustomerBranchesRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Operazione completata.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Customer"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Richiesta non valida o gerarchia delle sedi incompatibile."
          },
          "401": {
            "description": "Autenticazione richiesta."
          },
          "403": {
            "description": "Permessi insufficienti."
          },
          "404": {
            "description": "Anagrafica non trovata o non visibile."
          }
        }
      }
    },
    "/v1/customers/{id}/{organizationId}/main-customer/branches/check-duplicates": {
      "post": {
        "tags": [
          "Customers"
        ],
        "summary": "Check Customer Branches",
        "description": "Controlla duplicati e incompatibilità senza modificare le anagrafiche. Richiede customers_view. Inviare secondaryCustomerIds come array, anche vuoto. canProceed è un controllo preliminare e non garantisce il successo di una successiva modifica.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateMainCustomerBranchesRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Operazione completata.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerBranchesCheckResponse"
                }
              }
            }
          },
          "400": {
            "description": "Richiesta non valida o gerarchia delle sedi incompatibile."
          },
          "401": {
            "description": "Autenticazione richiesta."
          },
          "403": {
            "description": "Permessi insufficienti."
          },
          "404": {
            "description": "Anagrafica non trovata o non visibile."
          }
        }
      }
    },
    "/v1/customers/update/{id}/{organizationId}/main-customer/branches/replace": {
      "put": {
        "tags": [
          "Customers"
        ],
        "summary": "Replace Customer Branches",
        "description": "Sostituisce l’intero elenco delle branch. Richiede customers_edit. Le branch escluse diventano HEADQUARTERS e perdono mainCustomerId. secondaryCustomerIds omesso, null o vuoto tenta di scollegarle tutte. Le regole multisede possono impedire lo scollegamento, ad esempio per partita IVA già usata da una sede principale. In caso di errore la transazione viene annullata.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateMainCustomerBranchesRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Operazione completata.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Customer"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Richiesta non valida o gerarchia delle sedi incompatibile."
          },
          "401": {
            "description": "Autenticazione richiesta."
          },
          "403": {
            "description": "Permessi insufficienti."
          },
          "404": {
            "description": "Anagrafica non trovata o non visibile."
          }
        }
      }
    },
    "/v1/customers/update/{id}/{organizationId}/main-customer": {
      "put": {
        "tags": [
          "Customers"
        ],
        "summary": "Set Customer Main Office",
        "description": "Collega la branch identificata da id alla sede indicata nel body. Richiede customers_edit. Le sedi devono appartenere alla stessa organizzazione; la sede principale non può essere una branch e id non può avere proprie branch. Con multisede abilitato la partita IVA deve coincidere. mainCustomerId omesso o null tenta lo scollegamento.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateMainCustomerRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Operazione completata.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Customer"
                }
              }
            }
          },
          "400": {
            "description": "Richiesta non valida o gerarchia delle sedi incompatibile."
          },
          "401": {
            "description": "Autenticazione richiesta."
          },
          "403": {
            "description": "Permessi insufficienti."
          },
          "404": {
            "description": "Anagrafica non trovata o non visibile."
          }
        }
      },
      "delete": {
        "tags": [
          "Customers"
        ],
        "summary": "Remove Customer Main Office",
        "description": "Scollega la branch identificata da id dalla sede principale e la rende HEADQUARTERS. Richiede customers_edit. Le regole multisede possono impedire lo scollegamento, ad esempio per partita IVA già usata da una sede principale.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Collegamento rimosso."
          },
          "400": {
            "description": "Richiesta non valida o gerarchia delle sedi incompatibile."
          },
          "401": {
            "description": "Autenticazione richiesta."
          },
          "403": {
            "description": "Permessi insufficienti."
          },
          "404": {
            "description": "Anagrafica non trovata o non visibile."
          }
        }
      }
    },
    "/v1/customers/add": {
      "post": {
        "tags": [
          "Customers"
        ],
        "summary": "Add a new Customer",
        "description": "Create a new customer with the provided details.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddCustomerRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Customer created successfully"
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/customers/delete/{idCustomer}": {
      "delete": {
        "tags": [
          "Customers"
        ],
        "summary": "Delete Customer",
        "description": "Delete a customer by its unique ID.",
        "parameters": [
          {
            "name": "idCustomer",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Customer deleted successfully"
          },
          "404": {
            "description": "Customer not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/customers/regulatorydatabaseinfo/{customerId}": {
      "get": {
        "tags": [
          "Regulatory"
        ],
        "summary": "Get Regulatory Database Info by Customer ID",
        "description": "Retrieve regulatory database information for a specific customer using its unique ID.",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Regulatory database info retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RegulatoryDatabaseInfo"
                }
              }
            }
          },
          "404": {
            "description": "Customer not found"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/customers/reginfo/add": {
      "post": {
        "tags": [
          "Regulatory"
        ],
        "summary": "Add Regulatory Database Info",
        "description": "Create regulatory database information for a customer with the provided details.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegulatoryDatabaseInfo"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Regulatory database info created successfully"
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/customers/update/{customerId}/details": {
      "put": {
        "tags": [
          "Customers"
        ],
        "summary": "Update Customer Details",
        "description": "Update the details of an existing customer using its unique ID.",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCustomerRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Customer details updated successfully"
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Customer not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/customers/update/{customerId}/address": {
      "put": {
        "tags": [
          "Customers"
        ],
        "summary": "Update Customer Address",
        "description": "Update the address of an existing customer using its unique ID.",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCustomerAddressRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Customer address updated successfully"
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Customer not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/customers/reginfo/edit": {
      "put": {
        "tags": [
          "Regulatory"
        ],
        "summary": "Edit Regulatory Database Info",
        "description": "Update regulatory database information for a customer with the provided details.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegulatoryDatabaseInfo"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Regulatory database info updated successfully"
          },
          "400": {
            "description": "Bad request - invalid input data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Customer not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}/{organizationId}": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Circuit by Order ID",
        "description": "Retrieve circuit information for a specific order ID. The organization is selected explicitly through the `organizationId` path parameter.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Circuit"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}/details": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Circuit Details by Order ID",
        "description": "Retrieve detailed information for a specific circuit using its order ID. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Circuit_Detail"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}/ping": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Ping Circuit by Order ID",
        "description": "Ping a specific circuit using its order ID. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Circuit_ping"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}/connectionlog": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Connection Log for Circuit by Order ID",
        "description": "Retrieve connection log information for a specific circuit using its order ID. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Circuit_logs"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}/ngasp/alignment": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get NGASP Alignment for Circuit by Order ID",
        "description": "Retrieve NGASP alignment information for a specific circuit using its order ID. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Circuit_NGASP"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}/charts/bandwidth/{xdslType}": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Bandwidth Chart for Circuit by Order ID",
        "description": "Retrieve bandwidth chart information for a specific circuit using its order ID. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "xdslType",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/{orderId}/ipclass": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get IP Class for Circuit by Order ID",
        "description": "Retrieve IP class  information for a specific circuit using its order ID. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Circuit_IPClasses"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/circuits/customer/{customerId}/{organizationId}": {
      "get": {
        "tags": [
          "Circuits"
        ],
        "summary": "Get Circuit by Customer ID",
        "description": "Retrieve circuit information for a specific customer ID. The organization is selected explicitly through the `organizationId` path parameter.",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "$ref": "#/components/schemas/Circuit"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/{idNumber}/{organizationId}": {
      "get": {
        "tags": [
          "Numbers"
        ],
        "summary": "Get Number by ID",
        "description": "Retrieve detailed number information by number ID. The organization is selected explicitly through the `organizationId` path parameter.",
        "parameters": [
          {
            "name": "idNumber",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The number identifier"
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "Number retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NumberDetail"
                }
              }
            }
          },
          "404": {
            "description": "Number not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/numbers/orders/{idOrder}/history": {
      "get": {
        "tags": [
          "Numbers/Order"
        ],
        "summary": "Get Number Order History",
        "description": "Retrieve the full history of a numbering order by order ID. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idOrder",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "The order identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Number order history retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/NumberOrderHistoryItem"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Order not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/available-number": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get Available DSS Numbers",
        "description": "Retrieve available DSS numbers. The organization is resolved from the authenticated user.",
        "responses": {
          "200": {
            "description": "Available DSS numbers retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/NumberDetail"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Organization not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/number/{numberId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get Trunk or Gateway by Number ID",
        "description": "Retrieve the DSS trunk or gateway associated with a number. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "numberId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunk or gateway retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DssNumberRoute"
                }
              }
            }
          },
          "404": {
            "description": "Number not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/delete/{idTrunk}": {
      "delete": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Delete a DSS Trunk",
        "description": "Delete a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS trunk deleted successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/registered/all/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get Registered DSS Trunks",
        "description": "Retrieve registered DSS trunks. The organization is selected explicitly through the `organizationId` path parameter.",
        "parameters": [
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "Registered DSS trunks retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssRegisteredTrunk"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/registered/{trunkId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get Registered DSS Trunk by ID",
        "description": "Retrieve a registered DSS trunk by trunk ID. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "trunkId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Matching DSS registrations retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssRegisteredTrunk"
                  }
                }
              }
            }
          },
          "404": {
            "description": "DSS trunk not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/customer/{customerId}/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Trunks by Customer",
        "description": "Retrieve DSS trunks for a specific customer. The organization is selected explicitly through the `organizationId` path parameter.",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunks retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssTrunk"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Customer not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/{trunkId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Trunk by ID",
        "description": "Retrieve a DSS trunk by trunk ID. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "trunkId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunk retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DssTrunk"
                }
              }
            }
          },
          "404": {
            "description": "DSS trunk not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/allcountries/{trunkId}/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Trunk Countries",
        "description": "Retrieve countries enabled for a DSS trunk. The organization is selected explicitly through the `organizationId` path parameter.",
        "parameters": [
          {
            "name": "trunkId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunk countries retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DssCountry"
                }
              }
            }
          },
          "404": {
            "description": "DSS trunk not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/country/{idTrunk}/{iso}": {
      "delete": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Remove a DSS Trunk Destination",
        "description": "Remove a country destination from a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          },
          {
            "name": "iso",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Country ISO code"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS trunk destination removed successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/disablecheckprefix/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable DSS Trunk Prefix Checking",
        "description": "Disable prefix checking for a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/enablecheckprefix/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable DSS Trunk Prefix Checking",
        "description": "Enable prefix checking for a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/enabletoinru/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable To In RU for a DSS Trunk",
        "description": "Enable To In RU handling for a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/disabletoinru/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable To In RU for a DSS Trunk",
        "description": "Disable To In RU handling for a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/channel/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Trunk Channels",
        "description": "Update the maximum number of concurrent channels for a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "maxChannel"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/bknumber/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Trunk Backup Number",
        "description": "Update the backup number for a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "bkNumber"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/credit/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Trunk Traffic Limit",
        "description": "Update the traffic credit limit for a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "trafficLimit"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/setbk/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable Permanent Backup for a DSS Trunk",
        "description": "Enable permanent backup routing for a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/removebk/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable Permanent Backup for a DSS Trunk",
        "description": "Disable permanent backup routing for a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/block/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Block a DSS Trunk",
        "description": "Block traffic on a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/unblock/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Unblock a DSS Trunk",
        "description": "Unblock traffic on a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/enabledi/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable Dual Identity for a DSS Trunk",
        "description": "Enable dual identity for a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/disabledi/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable Dual Identity for a DSS Trunk",
        "description": "Disable dual identity for a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/settings/name/{idTrunk}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Rename a DSS Trunk",
        "description": "Update the display name of a DSS trunk. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idTrunk",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS trunk identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "nome"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/trunk/numbers/{trunkId}/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get Numbers by Trunk ID",
        "description": "Retrieve numbers associated with a DSS trunk. The organization is selected explicitly through the `organizationId` path parameter.",
        "parameters": [
          {
            "name": "trunkId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "DSS trunk numbers retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssNumber"
                  }
                }
              }
            }
          },
          "404": {
            "description": "DSS trunk not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/delete/{idGtw}": {
      "delete": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Delete a DSS Gateway",
        "description": "Delete a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS gateway deleted successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/{gatewayId}/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Gateway by ID",
        "description": "Retrieve a DSS gateway by ID. The organization is selected explicitly through the `organizationId` path parameter.",
        "parameters": [
          {
            "name": "gatewayId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "DSS gateway retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DssGatewayDetail"
                }
              }
            }
          },
          "404": {
            "description": "DSS gateway not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/customer/{customerId}/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Gateways by Customer",
        "description": "Retrieve DSS gateways for a specific customer. The organization is selected explicitly through the `organizationId` path parameter.",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "DSS gateways retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssGateway"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Customer not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/allcountries/{gatewayId}/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get DSS Gateway Countries",
        "description": "Retrieve countries enabled for a DSS gateway. The organization is selected explicitly through the `organizationId` path parameter.",
        "parameters": [
          {
            "name": "gatewayId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "DSS gateway countries retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DssCountry"
                }
              }
            }
          },
          "404": {
            "description": "DSS gateway not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/country/{idGtw}/{iso}": {
      "delete": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Remove a DSS Gateway Destination",
        "description": "Remove a country destination from a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          },
          {
            "name": "iso",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Country ISO code"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS gateway destination removed successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/enabledi/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable Dual Identity for a DSS Gateway",
        "description": "Enable dual identity for a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/disabledi/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable Dual Identity for a DSS Gateway",
        "description": "Disable dual identity for a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/disablecheckprefix/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable DSS Gateway Prefix Checking",
        "description": "Disable prefix checking for a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/enablecheckprefix/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable DSS Gateway Prefix Checking",
        "description": "Enable prefix checking for a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/channel/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Gateway Channels",
        "description": "Update the maximum number of concurrent channels for a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "maxChannel"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/bknumber/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Gateway Backup Number",
        "description": "Update the backup number for a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "bkNumber"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/credit/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Gateway Traffic Limit",
        "description": "Update the traffic credit limit for a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "trafficLimit"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/setbk/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Enable Permanent Backup for a DSS Gateway",
        "description": "Enable permanent backup routing for a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/removebk/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Disable Permanent Backup for a DSS Gateway",
        "description": "Disable permanent backup routing for a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/block/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Block a DSS Gateway",
        "description": "Block traffic on a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/unblock/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Unblock a DSS Gateway",
        "description": "Unblock traffic on a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/name/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Rename a DSS Gateway",
        "description": "Update the display name of a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TrunkSettingsRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "nome"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/primaryip/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Gateway Primary IP",
        "description": "Update the primary IP address and port of a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/GatewayIpRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "ipAddress"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/secondaryip/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Gateway Secondary IP",
        "description": "Update the secondary IP address and port of a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/GatewayIpRequest"
                  },
                  {
                    "type": "object",
                    "required": [
                      "secondaryIP"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/settings/ip/{idGtw}": {
      "put": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Update DSS Gateway IP Settings",
        "description": "Update the primary and secondary IP settings of a DSS gateway. The organization is resolved from the authenticated user.",
        "parameters": [
          {
            "name": "idGtw",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "DSS gateway identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GatewayIpRequest"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "DSS resource updated successfully."
          },
          "400": {
            "description": "Bad request - Invalid parameters or missing required fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Insufficient permissions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "404": {
            "description": "Requested DSS resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    },
    "/v1/voip/dss/gtw/numbers/{gatewayId}/{organizationId}": {
      "get": {
        "tags": [
          "VoIP DSS"
        ],
        "summary": "Get Numbers by Gateway ID",
        "description": "Retrieve numbers associated with a DSS gateway. The organization is selected explicitly through the `organizationId` path parameter.",
        "parameters": [
          {
            "name": "gatewayId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "organizationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Organization identifier."
          }
        ],
        "responses": {
          "200": {
            "description": "DSS gateway numbers retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DssNumber"
                  }
                }
              }
            }
          },
          "404": {
            "description": "DSS gateway not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiGeneralMessage"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ApiGeneralMessage": {
        "type": "object",
        "description": "Standard error response returned by the API.",
        "properties": {
          "status": {
            "type": "string",
            "description": "HTTP status name."
          },
          "message": {
            "type": "string",
            "description": "Human-readable error message."
          },
          "errors": {
            "description": "Additional error details. It can be a message, a list of validation errors, or a structured object.",
            "type": [
              "string",
              "array",
              "object"
            ],
            "items": {
              "type": "string"
            },
            "additionalProperties": true
          }
        },
        "required": [
          "status",
          "message",
          "errors"
        ]
      },
      "AuditLog": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "user_id": {
            "type": "integer"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "emailAddress": {
            "type": "string"
          },
          "organization_id": {
            "type": "integer"
          },
          "organizationName": {
            "type": "string"
          },
          "parentOrganizationId": {
            "type": "integer"
          },
          "requestType": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "module": {
            "type": "string"
          },
          "action": {
            "type": "string"
          },
          "entityId": {
            "type": "string"
          },
          "fullUrl": {
            "type": "string"
          },
          "payload": {
            "type": "string"
          },
          "timestamp": {
            "type": "string"
          },
          "responseCode": {
            "type": [
              "integer",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "responsePayload": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "Status": {
        "type": "object",
        "description": "Status detail record from database",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Primary key (Auto-increment)",
            "example": 1
          },
          "code": {
            "type": "string",
            "maxLength": 50,
            "nullable": true,
            "description": "Status code identifier",
            "example": "PROC_01"
          },
          "description": {
            "type": "string",
            "maxLength": 100,
            "nullable": true,
            "description": "Full description of the status",
            "example": "Processing started"
          },
          "finishStatus": {
            "type": "boolean",
            "nullable": true,
            "default": false,
            "description": "Indicates if the status is a final state (true) or an intermediate state (false)",
            "example": true
          }
        }
      },
      "Carrier": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "Stats_DailyMinutes": {
        "type": "object",
        "description": "Daily traffic statistics returned by `StatsController` (`PartnerDailyStats`).",
        "properties": {
          "total": {
            "type": "number",
            "format": "double"
          },
          "inbound": {
            "type": "number",
            "format": "double"
          },
          "outbound": {
            "type": "number",
            "format": "double"
          },
          "time": {
            "type": "integer"
          },
          "sbcId": {
            "type": "integer"
          },
          "organizationId": {
            "type": "integer",
            "format": "int64"
          }
        },
        "required": [
          "total",
          "inbound",
          "outbound",
          "time",
          "sbcId",
          "organizationId"
        ]
      },
      "ActionObjectReference": {
        "type": "object",
        "properties": {
          "moduleId": {
            "type": "integer",
            "minimum": 1,
            "description": "Identifier of the module that owns the object."
          },
          "organizationId": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "description": "Organization that owns the object."
          },
          "objectType": {
            "type": "string",
            "minLength": 1,
            "description": "Runtime object type. DSS trunks use `DSS_TRUNK`."
          },
          "objectId": {
            "type": "string",
            "minLength": 1,
            "description": "Object identifier represented as a string."
          },
          "context": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Resolver context. DSS trunks include the `presetId` entry."
          }
        },
        "required": [
          "moduleId",
          "organizationId",
          "objectType",
          "objectId",
          "context"
        ]
      },
      "DssTrunk": {
        "type": "object",
        "description": "DSS registered SIP trunk as returned by `VoipController` (`Subscriber`).",
        "properties": {
          "trunkType": {
            "type": "string",
            "const": "REGISTER"
          },
          "id": {
            "type": "integer"
          },
          "sbcId": {
            "type": "integer"
          },
          "nome": {
            "type": "string"
          },
          "username": {
            "type": "string"
          },
          "maxChannel": {
            "type": "integer"
          },
          "trafficLimit": {
            "type": [
              "integer",
              "null"
            ]
          },
          "traffic_consumed": {
            "type": "number",
            "format": "double"
          },
          "permanentBk": {
            "type": "boolean"
          },
          "bkNumber": {
            "type": [
              "string",
              "null"
            ]
          },
          "blocked": {
            "type": "boolean"
          },
          "dualIdentity": {
            "type": "boolean"
          },
          "to_in_ru": {
            "type": "boolean"
          },
          "checkPrefix": {
            "type": "boolean"
          },
          "mainNumber": {
            "type": [
              "string",
              "null"
            ]
          },
          "lcrId": {
            "type": "integer"
          },
          "domain": {
            "type": "string"
          },
          "organizationId": {
            "type": "integer"
          },
          "partnerName": {
            "type": "string"
          },
          "registration": {
            "type": "boolean"
          },
          "idCustomer": {
            "type": "integer"
          },
          "customerName": {
            "type": "string"
          },
          "companyName": {
            "type": "string"
          },
          "presetId": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          },
          "actionObject": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ActionObjectReference"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "trunkType",
          "id",
          "sbcId",
          "maxChannel",
          "traffic_consumed",
          "permanentBk",
          "blocked",
          "dualIdentity",
          "to_in_ru",
          "checkPrefix",
          "lcrId",
          "organizationId",
          "registration",
          "idCustomer"
        ]
      },
      "DssCountry": {
        "type": "object",
        "properties": {
          "world": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "states": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "iso": {
                        "type": "string"
                      },
                      "premium": {
                        "type": "boolean"
                      },
                      "visible": {
                        "type": "boolean"
                      },
                      "active": {
                        "type": "boolean"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "DssNumber": {
        "type": "object",
        "properties": {
          "idNumbers": {
            "type": "integer"
          },
          "trunkId": {
            "type": "string"
          },
          "tipo": {
            "type": "string"
          },
          "orgId": {
            "type": "integer"
          },
          "tipoNumerazione": {
            "type": "string"
          },
          "details": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer"
              },
              "created_time": {
                "type": "string"
              },
              "activationDate": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "ceasedDate": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "statoBK": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "numeroBK": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "permanente": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "destination_old": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "canali": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "dbu": {
                "type": "boolean"
              },
              "dbuCategory": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "dbuQualification": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "dbuOccupation": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "dbuEmail": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "dbuAdditionalAddress": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "dbuNote": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "paperDirectories": {
                "type": "boolean"
              },
              "informationServices": {
                "type": "boolean"
              },
              "derivedSearch": {
                "type": "boolean"
              },
              "emailAdvertising": {
                "type": "boolean"
              },
              "taxCodeAggregation": {
                "type": "boolean"
              },
              "phoneAdvertising": {
                "type": "boolean"
              },
              "otherAdvertisingChannels": {
                "type": "boolean"
              },
              "etnaInserted": {
                "type": "boolean"
              },
              "anagrafica": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "organizationId": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  },
                  "ragioneSociale": {
                    "type": "string"
                  },
                  "rappresentante": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "indirizzo": {
                    "type": "string"
                  },
                  "civico": {
                    "type": "string"
                  },
                  "indSedLeg": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "civicoSedLeg": {
                    "type": "string"
                  },
                  "comuneSedLeg": {
                    "type": "string"
                  },
                  "provinciaSedLeg": {
                    "type": "string"
                  },
                  "regioneSedLeg": {
                    "type": "string"
                  },
                  "capSedLeg": {
                    "type": "string"
                  },
                  "comune": {
                    "type": "string"
                  },
                  "provincia": {
                    "type": "string"
                  },
                  "regione": {
                    "type": "string"
                  },
                  "country": {
                    "type": "string"
                  },
                  "cap": {
                    "type": "string"
                  },
                  "tel": {
                    "type": "string"
                  },
                  "fiscalCode": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "company": {
                    "type": "boolean"
                  },
                  "userid": {
                    "type": "integer"
                  },
                  "mainCustomer": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "createDate": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "associated_users": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "userId": {
                          "type": "integer"
                        },
                        "emailAddress": {
                          "type": "string"
                        },
                        "firstName": {
                          "type": "string"
                        },
                        "lastName": {
                          "type": "string"
                        },
                        "type": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "integer"
                            },
                            "name": {
                              "type": "string"
                            }
                          }
                        },
                        "organizationId": {
                          "type": "integer"
                        },
                        "parentOrganizationId": {
                          "type": "integer"
                        },
                        "organizationName": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "egonCodeAddress": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "egonCodeCity": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "egonCodeMain": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "rawAddress": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "piva": {
                    "type": "string"
                  },
                  "ptoponomastica": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "mainCustomerInfo": {
                    "type": [
                      "object",
                      "null"
                    ]
                  }
                }
              },
              "organization": {
                "type": "object",
                "properties": {
                  "organizationId": {
                    "type": "integer"
                  },
                  "userId": {
                    "type": "integer"
                  },
                  "userName": {
                    "type": "string"
                  },
                  "createDate": {
                    "type": "string"
                  },
                  "modifiedDate": {
                    "type": "string"
                  },
                  "parentOrganizationId": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  },
                  "type_": {
                    "type": "string"
                  },
                  "sbcId": {
                    "type": "integer"
                  },
                  "documentation_URL": {
                    "type": "string"
                  },
                  "support_URL": {
                    "type": "string"
                  },
                  "status_URL": {
                    "type": "string"
                  },
                  "redirect_URL": {
                    "type": "string"
                  },
                  "notificationEmailFromAddress": {
                    "type": "string"
                  },
                  "customerId": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "manualCoverage": {
                    "type": "boolean"
                  },
                  "coverageIntegration": {
                    "type": "integer"
                  }
                }
              },
              "creator": {
                "type": "object",
                "properties": {
                  "userId": {
                    "type": "integer"
                  },
                  "ssoId": {
                    "type": "string"
                  },
                  "createDate": {
                    "type": "string"
                  },
                  "modifiedDate": {
                    "type": "string"
                  },
                  "emailAddress": {
                    "type": "string"
                  },
                  "firstName": {
                    "type": "string"
                  },
                  "lastName": {
                    "type": "string"
                  },
                  "hasToChangePassword": {
                    "type": "boolean"
                  },
                  "type": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer"
                      },
                      "name": {
                        "type": "string"
                      }
                    }
                  },
                  "organizationId": {
                    "type": "integer"
                  },
                  "parentOrganizationId": {
                    "type": "integer"
                  },
                  "organizationName": {
                    "type": "string"
                  }
                }
              },
              "voipPlatform": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "attributes": {
                    "type": [
                      "object",
                      "null"
                    ]
                  }
                }
              },
              "status": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "code": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "finishStatus": {
                    "type": "boolean"
                  }
                }
              },
              "order": {
                "type": [
                  "object",
                  "null"
                ]
              },
              "service": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "serviceList": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer"
                      },
                      "name": {
                        "type": "string"
                      },
                      "serviceProvider": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "description": {
                            "type": "string"
                          }
                        }
                      },
                      "carrier": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "name": {
                            "type": "string"
                          }
                        }
                      },
                      "type": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer"
                          },
                          "name": {
                            "type": "string"
                          }
                        }
                      },
                      "supplierProductId": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    }
                  },
                  "organizationId": {
                    "type": "integer"
                  },
                  "integration": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer"
                      },
                      "name": {
                        "type": "string"
                      }
                    }
                  },
                  "name": {
                    "type": "string"
                  },
                  "forDirect": {
                    "type": "boolean"
                  },
                  "forSub": {
                    "type": "boolean"
                  },
                  "carrierType": {
                    "type": "string"
                  },
                  "offsetDays": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "attributes": {
                    "type": [
                      "object",
                      "null"
                    ]
                  }
                }
              },
              "dn": {
                "type": "string"
              },
              "tipo": {
                "type": "string"
              },
              "tipoSP": {
                "type": "string"
              },
              "codiceMigrazione": {
                "type": "string"
              },
              "ipgateway": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "isTWT": {
                "type": [
                  "boolean",
                  "null"
                ]
              }
            }
          }
        }
      },
      "DssRegisteredTrunk": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "username": {
            "type": "string"
          },
          "ruid": {
            "type": "string"
          },
          "contact": {
            "type": "string"
          },
          "received": {
            "type": [
              "string",
              "null"
            ]
          },
          "expires": {
            "type": "string"
          },
          "last_modified": {
            "type": "string"
          },
          "q": {
            "type": "integer"
          },
          "callid": {
            "type": "string"
          },
          "cseq": {
            "type": "integer"
          },
          "user_agent": {
            "type": "string"
          },
          "socket": {
            "type": "string"
          },
          "server_id": {
            "type": "integer"
          }
        }
      },
      "DssGateway": {
        "type": "object",
        "description": "DSS IP-to-IP gateway as returned by `VoipController` (`Gateway`).",
        "properties": {
          "trunkType": {
            "type": "string",
            "const": "IP_TO_IP"
          },
          "id": {
            "type": "integer"
          },
          "sbcId": {
            "type": "integer"
          },
          "nome": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "ipAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "port": {
            "type": [
              "string",
              "null"
            ]
          },
          "maxChannel": {
            "type": "integer"
          },
          "secondaryIP": {
            "type": [
              "string",
              "null"
            ]
          },
          "portSecondary": {
            "type": [
              "string",
              "null"
            ]
          },
          "trafficLimit": {
            "type": [
              "integer",
              "null"
            ]
          },
          "traffic_consumed": {
            "type": "number",
            "format": "double"
          },
          "permanentBk": {
            "type": "boolean"
          },
          "bkNumber": {
            "type": [
              "string",
              "null"
            ]
          },
          "blocked": {
            "type": "boolean"
          },
          "dualIdentity": {
            "type": "boolean"
          },
          "checkPrefix": {
            "type": "boolean"
          },
          "lcrId": {
            "type": "integer"
          },
          "nome_partner": {
            "type": [
              "string",
              "null"
            ]
          },
          "organizationId": {
            "type": "integer"
          },
          "partnerName": {
            "type": [
              "string",
              "null"
            ]
          },
          "idCustomer": {
            "type": "integer"
          },
          "customerName": {
            "type": [
              "string",
              "null"
            ]
          },
          "companyName": {
            "type": [
              "string",
              "null"
            ]
          },
          "presetId": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          },
          "actionObject": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ActionObjectReference"
              },
              {
                "type": "null"
              }
            ]
          },
          "addressLabel": {
            "type": [
              "string",
              "null"
            ]
          },
          "lockedFields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "trunkType",
          "id",
          "sbcId",
          "nome",
          "maxChannel",
          "traffic_consumed",
          "permanentBk",
          "blocked",
          "dualIdentity",
          "checkPrefix",
          "lcrId",
          "organizationId",
          "idCustomer"
        ]
      },
      "DssGatewayDetail": {
        "type": "object",
        "description": "Detailed DSS IP-to-IP gateway returned by the single-gateway endpoints.",
        "properties": {
          "trunkType": {
            "type": "string",
            "const": "IP_TO_IP"
          },
          "id": {
            "type": "integer"
          },
          "sbcId": {
            "type": "integer"
          },
          "nome": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "ipAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "port": {
            "type": [
              "string",
              "null"
            ]
          },
          "maxChannel": {
            "type": "integer"
          },
          "secondaryIP": {
            "type": [
              "string",
              "null"
            ]
          },
          "portSecondary": {
            "type": [
              "string",
              "null"
            ]
          },
          "trafficLimit": {
            "type": [
              "integer",
              "null"
            ]
          },
          "traffic_consumed": {
            "type": "number",
            "format": "double"
          },
          "permanentBk": {
            "type": "boolean"
          },
          "bkNumber": {
            "type": [
              "string",
              "null"
            ]
          },
          "blocked": {
            "type": "boolean"
          },
          "dualIdentity": {
            "type": "boolean"
          },
          "checkPrefix": {
            "type": "boolean"
          },
          "lcrId": {
            "type": "integer"
          },
          "nome_partner": {
            "type": [
              "string",
              "null"
            ]
          },
          "organizationId": {
            "type": "integer"
          },
          "partnerName": {
            "type": [
              "string",
              "null"
            ]
          },
          "idCustomer": {
            "type": "integer"
          },
          "customerName": {
            "type": [
              "string",
              "null"
            ]
          },
          "companyName": {
            "type": [
              "string",
              "null"
            ]
          },
          "presetId": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          },
          "actionObject": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ActionObjectReference"
              },
              {
                "type": "null"
              }
            ]
          },
          "addressLabel": {
            "type": [
              "string",
              "null"
            ]
          },
          "lockedFields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "terminationUri": {
            "type": [
              "string",
              "null"
            ],
            "description": "SIP termination endpoint. Currently populated only for Elastic SIP Trunks."
          }
        },
        "required": [
          "trunkType",
          "id",
          "sbcId",
          "nome",
          "maxChannel",
          "traffic_consumed",
          "permanentBk",
          "blocked",
          "dualIdentity",
          "checkPrefix",
          "lcrId",
          "organizationId",
          "idCustomer"
        ]
      },
      "DssCdr": {
        "type": "object",
        "description": "Call detail record returned by `VoipController` (`Cdr`).",
        "properties": {
          "id": {
            "type": "integer"
          },
          "start_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Format: dd/MM/yyyy HH:mm:ss"
          },
          "end_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Format: dd/MM/yyyy HH:mm:ss"
          },
          "duration": {
            "type": "integer"
          },
          "to_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "from_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "callid": {
            "type": [
              "string",
              "null"
            ]
          },
          "created_time": {
            "type": [
              "string",
              "null"
            ]
          },
          "typeCall": {
            "type": [
              "string",
              "null"
            ]
          },
          "direction": {
            "type": [
              "string",
              "null"
            ]
          },
          "idTrunk": {
            "type": "integer"
          },
          "typeTrunk": {
            "type": [
              "string",
              "null"
            ]
          },
          "sbcId": {
            "type": "integer"
          },
          "organizationId": {
            "type": "integer",
            "format": "int64"
          },
          "partner": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "duration",
          "idTrunk",
          "sbcId",
          "organizationId"
        ]
      },
      "DssStats": {
        "type": "object",
        "description": "Aggregate DSS dashboard returned by `getDssStats`.",
        "properties": {
          "topUsage": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "integer"
                },
                "name": {
                  "type": "string"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "GATEWAY",
                    "SUBSCRIBER"
                  ]
                },
                "trafficLimit": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "trafficConsumed": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "format": "double"
                },
                "usagePercentage": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "format": "double"
                },
                "blocked": {
                  "type": "boolean"
                },
                "customerName": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "partnerName": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "organizationId": {
                  "type": "integer"
                }
              }
            }
          },
          "subscribersBlocked": {
            "type": "integer"
          },
          "subscribersNotRegistered": {
            "type": "integer"
          },
          "subscribersRegistered": {
            "type": "integer"
          },
          "gatewaysBlocked": {
            "type": "integer"
          },
          "gatewaysNotBlocked": {
            "type": "integer"
          },
          "totalSubscribers": {
            "type": "integer"
          },
          "totalGateways": {
            "type": "integer"
          }
        },
        "required": [
          "topUsage",
          "subscribersBlocked",
          "subscribersNotRegistered",
          "subscribersRegistered",
          "gatewaysBlocked",
          "gatewaysNotBlocked",
          "totalSubscribers",
          "totalGateways"
        ]
      },
      "DssStatsItem": {
        "type": "object",
        "description": "Time-series DSS trunk statistic returned by `getTrunkStats`.",
        "properties": {
          "time": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "timeUnix": {
            "type": "integer",
            "format": "int64"
          },
          "sbcId": {
            "type": "integer"
          },
          "trunkId": {
            "type": [
              "integer",
              "null"
            ]
          },
          "trunkType": {
            "type": [
              "string",
              "null"
            ]
          },
          "totalChannel": {
            "type": "integer"
          },
          "outboundChannel": {
            "type": "integer"
          },
          "inboundChannel": {
            "type": "integer"
          },
          "callSetup": {
            "type": "integer"
          },
          "activeCall": {
            "type": "integer"
          },
          "completedCall": {
            "type": "integer"
          },
          "confirmedCall": {
            "type": "integer"
          }
        },
        "required": [
          "timeUnix",
          "sbcId",
          "totalChannel",
          "outboundChannel",
          "inboundChannel",
          "callSetup",
          "activeCall",
          "completedCall",
          "confirmedCall"
        ]
      },
      "DssNumberRoute": {
        "type": "object",
        "description": "DSS trunk or gateway associated with the requested number.",
        "properties": {
          "idTrunk": {
            "type": "string",
            "description": "Identifier of the associated trunk or gateway."
          },
          "typeTrunk": {
            "type": "string",
            "description": "Type of the associated trunk or gateway.",
            "enum": [
              "trunk",
              "gtw"
            ]
          },
          "idNumber": {
            "type": "string",
            "description": "Identifier of the requested number."
          }
        },
        "required": [
          "idTrunk",
          "typeTrunk",
          "idNumber"
        ],
        "additionalProperties": false,
        "example": {
          "idTrunk": "42",
          "typeTrunk": "trunk",
          "idNumber": "123"
        }
      },
      "Organization": {
        "type": "object",
        "properties": {
          "organizationId": {
            "type": "integer"
          },
          "userId": {
            "type": "integer",
            "nullable": true
          },
          "userName": {
            "type": "string",
            "nullable": true
          },
          "createDate": {
            "type": "string",
            "nullable": true
          },
          "modifiedDate": {
            "type": "string",
            "nullable": true
          },
          "parentOrganizationId": {
            "type": "integer",
            "nullable": true
          },
          "name": {
            "type": "string"
          },
          "sbcId": {
            "type": "integer",
            "nullable": true
          },
          "notificationEmailFromAddress": {
            "type": "string"
          },
          "customerId": {
            "type": "integer",
            "nullable": true
          }
        }
      },
      "User": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "integer"
          },
          "ssoId": {
            "type": "string"
          },
          "createDate": {
            "type": "string"
          },
          "modifiedDate": {
            "type": "string"
          },
          "emailAddress": {
            "type": "string"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "hasToChangePassword": {
            "type": "boolean"
          },
          "organizationId": {
            "type": "integer"
          },
          "parentOrganizationId": {
            "type": "integer"
          }
        }
      },
      "Customer": {
        "type": "object",
        "description": "Customer master record returned by `CustomersController` (`Anagrafiche`).",
        "properties": {
          "id": {
            "type": "integer"
          },
          "organizationId": {
            "type": "integer",
            "format": "int64"
          },
          "name": {
            "type": "string"
          },
          "ragioneSociale": {
            "type": "string"
          },
          "rappresentante": {
            "type": [
              "string",
              "null"
            ]
          },
          "ptoponomastica": {
            "type": [
              "string",
              "null"
            ]
          },
          "indirizzo": {
            "type": [
              "string",
              "null"
            ]
          },
          "civico": {
            "type": [
              "string",
              "null"
            ]
          },
          "indSedLeg": {
            "type": [
              "string",
              "null"
            ]
          },
          "civicoSedLeg": {
            "type": [
              "string",
              "null"
            ]
          },
          "comuneSedLeg": {
            "type": [
              "string",
              "null"
            ]
          },
          "provinciaSedLeg": {
            "type": [
              "string",
              "null"
            ]
          },
          "regioneSedLeg": {
            "type": [
              "string",
              "null"
            ]
          },
          "capSedLeg": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 5
          },
          "comune": {
            "type": [
              "string",
              "null"
            ]
          },
          "provincia": {
            "type": [
              "string",
              "null"
            ]
          },
          "regione": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "cap": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 5
          },
          "tel": {
            "type": [
              "string",
              "null"
            ]
          },
          "vatNumber": {
            "type": [
              "string",
              "null"
            ],
            "description": "Also accepted as `pIva` or `piva` on input."
          },
          "fiscalCode": {
            "type": [
              "string",
              "null"
            ]
          },
          "company": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "userid": {
            "type": "integer",
            "format": "int64"
          },
          "mainCustomer": {
            "type": [
              "integer",
              "null"
            ]
          },
          "mainCustomerId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "ID della sede principale, null per una sede principale. Nome canonico restituito dal backend; mainCustomer è un alias legacy in input."
          },
          "type": {
            "type": "string",
            "enum": [
              "HEADQUARTERS",
              "BRANCH"
            ],
            "description": "Tipo di sede dell'anagrafica."
          },
          "createDate": {
            "type": [
              "string",
              "null"
            ],
            "description": "Format: dd/MM/yyyy HH:mm"
          },
          "organization": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Organization"
              },
              {
                "type": "null"
              }
            ]
          },
          "user": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/User"
              },
              {
                "type": "null"
              }
            ]
          },
          "associated_users": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/User"
            }
          },
          "egonCodeAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "egonCodeCity": {
            "type": [
              "string",
              "null"
            ]
          },
          "egonCodeMain": {
            "type": [
              "string",
              "null"
            ]
          },
          "rawAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "mainCustomerInfo": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "integer"
              },
              "name": {
                "type": "string"
              },
              "ragioneSociale": {
                "type": "string"
              }
            }
          }
        },
        "required": [
          "id",
          "organizationId",
          "name",
          "ragioneSociale",
          "userid"
        ]
      },
      "NumberOrder": {
        "type": "object",
        "description": "Order information for the Numbers module.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The unique order identifier"
          },
          "tipo": {
            "type": "string",
            "description": "The order type"
          },
          "codeOrderOlo": {
            "type": "string",
            "nullable": true,
            "description": "The OLO order code"
          },
          "idOrderOlo": {
            "type": "integer",
            "nullable": true,
            "description": "The OLO order identifier"
          },
          "note": {
            "type": "string",
            "nullable": true,
            "description": "Additional notes for the order"
          },
          "quantity": {
            "type": "integer",
            "description": "The ordered quantity"
          },
          "region": {
            "type": "string",
            "nullable": true,
            "description": "The region associated with the order"
          },
          "province": {
            "type": "string",
            "nullable": true,
            "description": "The province associated with the order"
          },
          "city": {
            "type": "string",
            "nullable": true,
            "description": "The city associated with the order"
          },
          "prefix": {
            "type": "string",
            "nullable": true,
            "description": "The number prefix"
          },
          "created_time": {
            "type": "string",
            "nullable": true,
            "description": "The order creation date"
          },
          "organization": {
            "type": "object",
            "description": "The organization associated with the order",
            "properties": {
              "organizationId": {
                "type": "integer",
                "description": "The organization identifier"
              },
              "userId": {
                "type": "integer",
                "nullable": true,
                "description": "The user identifier"
              },
              "userName": {
                "type": "string",
                "nullable": true,
                "description": "The user full name"
              },
              "createDate": {
                "type": "string",
                "nullable": true,
                "description": "The organization creation date"
              },
              "modifiedDate": {
                "type": "string",
                "nullable": true,
                "description": "The organization last modification date"
              },
              "parentOrganizationId": {
                "type": "integer",
                "nullable": true,
                "description": "The parent organization identifier"
              },
              "name": {
                "type": "string",
                "description": "The organization name"
              },
              "type_": {
                "type": "string",
                "nullable": true,
                "description": "The organization type"
              },
              "sbcId": {
                "type": "integer",
                "nullable": true,
                "description": "The SBC identifier"
              },
              "documentation_URL": {
                "type": "string",
                "nullable": true,
                "description": "The documentation URL"
              },
              "support_URL": {
                "type": "string",
                "nullable": true,
                "description": "The support URL"
              },
              "status_URL": {
                "type": "string",
                "nullable": true,
                "description": "The status URL"
              },
              "redirect_URL": {
                "type": "string",
                "nullable": true,
                "description": "The redirect URL"
              },
              "notificationEmailFromAddress": {
                "type": "string",
                "nullable": true,
                "description": "The notification sender email address"
              },
              "customerId": {
                "type": "integer",
                "nullable": true,
                "description": "The customer identifier"
              },
              "manualCoverage": {
                "type": "boolean",
                "nullable": true,
                "description": "Whether manual coverage is enabled"
              },
              "coverageIntegration": {
                "type": "integer",
                "nullable": true,
                "description": "The coverage integration mode"
              }
            }
          },
          "service": {
            "type": "object",
            "description": "The service associated with the order",
            "properties": {
              "id": {
                "type": "integer",
                "description": "The service identifier"
              },
              "serviceList": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer",
                    "description": "The service list identifier"
                  },
                  "name": {
                    "type": "string",
                    "description": "The service list name"
                  },
                  "serviceProvider": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer",
                        "description": "The service provider identifier"
                      },
                      "description": {
                        "type": "string",
                        "description": "The service provider description"
                      }
                    }
                  },
                  "carrier": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer",
                        "description": "The carrier identifier"
                      },
                      "name": {
                        "type": "string",
                        "description": "The carrier name"
                      }
                    }
                  },
                  "type": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer",
                        "description": "The service type identifier"
                      },
                      "name": {
                        "type": "string",
                        "description": "The service type name"
                      }
                    }
                  },
                  "supplierProductId": {
                    "type": "integer",
                    "nullable": true,
                    "description": "The supplier product identifier"
                  }
                }
              },
              "organizationId": {
                "type": "integer",
                "description": "The organization identifier"
              },
              "integration": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer",
                    "description": "The integration identifier"
                  },
                  "name": {
                    "type": "string",
                    "description": "The integration name"
                  }
                }
              },
              "name": {
                "type": "string",
                "description": "The service name"
              },
              "forDirect": {
                "type": "boolean",
                "description": "Whether the service is available for direct sales"
              },
              "forSub": {
                "type": "boolean",
                "description": "Whether the service is available for sub-dealers"
              },
              "carrierType": {
                "type": "string",
                "description": "The carrier type"
              },
              "offsetDays": {
                "type": "integer",
                "nullable": true,
                "description": "The service offset in days"
              },
              "attributes": {
                "nullable": true,
                "description": "The service attributes"
              }
            }
          },
          "customer": {
            "type": "object",
            "description": "The customer associated with the order",
            "properties": {
              "id": {
                "type": "integer",
                "description": "The customer identifier"
              },
              "organizationId": {
                "type": "integer",
                "description": "The organization identifier"
              },
              "name": {
                "type": "string",
                "description": "The customer display name"
              },
              "ragioneSociale": {
                "type": "string",
                "description": "The legal company name"
              },
              "rappresentante": {
                "type": "string",
                "nullable": true,
                "description": "The company representative"
              },
              "indirizzo": {
                "type": "string",
                "description": "The address"
              },
              "civico": {
                "type": "string",
                "description": "The street number"
              },
              "indSedLeg": {
                "type": "string",
                "description": "The registered office address"
              },
              "civicoSedLeg": {
                "type": "string",
                "nullable": true,
                "description": "The registered office street number"
              },
              "comuneSedLeg": {
                "type": "string",
                "nullable": true,
                "description": "The registered office city"
              },
              "provinciaSedLeg": {
                "type": "string",
                "nullable": true,
                "description": "The registered office province"
              },
              "regioneSedLeg": {
                "type": "string",
                "nullable": true,
                "description": "The registered office region"
              },
              "capSedLeg": {
                "type": "string",
                "nullable": true,
                "description": "The registered office postal code"
              },
              "comune": {
                "type": "string",
                "description": "The city"
              },
              "provincia": {
                "type": "string",
                "description": "The province"
              },
              "regione": {
                "type": "string",
                "description": "The region"
              },
              "country": {
                "type": "string",
                "description": "The country code"
              },
              "cap": {
                "type": "string",
                "description": "The postal code"
              },
              "tel": {
                "type": "string",
                "nullable": true,
                "description": "The phone number"
              },
              "fiscalCode": {
                "type": "string",
                "nullable": true,
                "description": "The fiscal code"
              },
              "company": {
                "type": "boolean",
                "description": "Whether the customer is a company"
              },
              "userid": {
                "type": "integer",
                "description": "The user identifier"
              },
              "mainCustomer": {
                "nullable": true,
                "description": "The main customer reference"
              },
              "createDate": {
                "type": "string",
                "nullable": true,
                "description": "The creation date"
              },
              "organization": {
                "type": "object",
                "description": "The organization linked to the customer",
                "properties": {
                  "organizationId": {
                    "type": "integer",
                    "description": "The organization identifier"
                  },
                  "name": {
                    "type": "string",
                    "description": "The organization name"
                  },
                  "documentation_URL": {
                    "type": "string",
                    "nullable": true,
                    "description": "The documentation URL"
                  },
                  "support_URL": {
                    "type": "string",
                    "nullable": true,
                    "description": "The support URL"
                  },
                  "status_URL": {
                    "type": "string",
                    "nullable": true,
                    "description": "The status URL"
                  },
                  "redirect_URL": {
                    "type": "string",
                    "nullable": true,
                    "description": "The redirect URL"
                  },
                  "notificationEmailFromAddress": {
                    "type": "string",
                    "nullable": true,
                    "description": "The notification sender email address"
                  },
                  "customerId": {
                    "type": "integer",
                    "nullable": true,
                    "description": "The customer identifier"
                  },
                  "manualCoverage": {
                    "type": "boolean",
                    "nullable": true,
                    "description": "Whether manual coverage is enabled"
                  },
                  "coverageIntegration": {
                    "type": "integer",
                    "nullable": true,
                    "description": "The coverage integration mode"
                  }
                }
              },
              "user": {
                "type": "object",
                "description": "The user linked to the customer",
                "properties": {
                  "userId": {
                    "type": "integer",
                    "description": "The user identifier"
                  },
                  "emailAddress": {
                    "type": "string",
                    "description": "The email address"
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user first name"
                  },
                  "lastName": {
                    "type": "string",
                    "description": "The user last name"
                  },
                  "type": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer",
                        "description": "The user type identifier"
                      },
                      "name": {
                        "type": "string",
                        "description": "The user type name"
                      }
                    }
                  },
                  "organizationId": {
                    "type": "integer",
                    "description": "The organization identifier"
                  },
                  "parentOrganizationId": {
                    "type": "integer",
                    "description": "The parent organization identifier"
                  },
                  "organizationName": {
                    "type": "string",
                    "description": "The organization name"
                  }
                }
              },
              "associated_users": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Associated users list"
              },
              "egonCodeAddress": {
                "type": "string",
                "nullable": true,
                "description": "The EGON code for the address"
              },
              "egonCodeCity": {
                "type": "string",
                "nullable": true,
                "description": "The EGON code for the city"
              },
              "egonCodeMain": {
                "type": "string",
                "nullable": true,
                "description": "The main EGON code"
              },
              "rawAddress": {
                "type": "string",
                "nullable": true,
                "description": "The raw address value"
              },
              "piva": {
                "type": "string",
                "description": "The VAT number"
              },
              "ptoponomastica": {
                "type": "string",
                "nullable": true,
                "description": "The street type"
              },
              "mainCustomerInfo": {
                "nullable": true,
                "description": "The main customer information"
              }
            }
          },
          "npDetails": {
            "nullable": true,
            "description": "Additional numbering plan details"
          },
          "status": {
            "type": "object",
            "description": "The order status",
            "properties": {
              "id": {
                "type": "integer",
                "description": "The status identifier"
              },
              "code": {
                "type": "string",
                "nullable": true,
                "description": "The status code"
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "The status description"
              },
              "finishStatus": {
                "type": "boolean",
                "nullable": true,
                "description": "Whether the status is a final status"
              }
            }
          }
        },
        "required": [
          "id",
          "tipo",
          "quantity",
          "organization",
          "service",
          "customer",
          "status"
        ]
      },
      "NumberDetail": {
        "type": "object",
        "description": "Detailed number information.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The unique number identifier"
          },
          "created_time": {
            "type": "string",
            "nullable": true
          },
          "activationDate": {
            "type": "string",
            "nullable": true
          },
          "ceasedDate": {
            "type": "string",
            "nullable": true
          },
          "statoBK": {
            "type": "string",
            "nullable": true
          },
          "numeroBK": {
            "type": "string",
            "nullable": true
          },
          "permanente": {
            "type": "boolean",
            "nullable": true
          },
          "destination_old": {
            "type": "string",
            "nullable": true
          },
          "canali": {
            "type": "string",
            "nullable": true
          },
          "dbu": {
            "type": "boolean"
          },
          "dbuCategory": {
            "type": "integer"
          },
          "dbuQualification": {
            "type": "string"
          },
          "dbuOccupation": {
            "type": "string"
          },
          "dbuEmail": {
            "type": "string"
          },
          "dbuAdditionalAddress": {
            "type": "string"
          },
          "dbuNote": {
            "type": "string"
          },
          "paperDirectories": {
            "type": "boolean"
          },
          "informationServices": {
            "type": "boolean"
          },
          "derivedSearch": {
            "type": "boolean"
          },
          "emailAdvertising": {
            "type": "boolean"
          },
          "taxCodeAggregation": {
            "type": "boolean"
          },
          "phoneAdvertising": {
            "type": "boolean"
          },
          "otherAdvertisingChannels": {
            "type": "boolean"
          },
          "etnaInserted": {
            "type": "boolean"
          },
          "anagrafica": {
            "$ref": "#/components/schemas/Customer"
          },
          "organization": {
            "$ref": "#/components/schemas/Organization"
          },
          "creator": {
            "$ref": "#/components/schemas/User"
          },
          "voipPlatform": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer"
              },
              "name": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "attributes": {
                "type": "object"
              }
            }
          },
          "status": {
            "$ref": "#/components/schemas/Status"
          },
          "order": {
            "$ref": "#/components/schemas/NumberOrder"
          },
          "service": {
            "type": "object"
          },
          "codiceMigrazione": {
            "type": "string",
            "nullable": true
          },
          "tipo": {
            "type": "string",
            "nullable": true
          },
          "tipoSP": {
            "type": "string",
            "nullable": true
          },
          "dn": {
            "type": "string",
            "nullable": true
          },
          "ipgateway": {
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "id",
          "created_time",
          "organization",
          "status",
          "order"
        ]
      },
      "NewTrunkCountry": {
        "type": "object",
        "description": "Destination enabled while creating a DSS trunk.",
        "properties": {
          "iso": {
            "type": "string",
            "description": "Country ISO code",
            "example": "IT"
          },
          "premiumAvailable": {
            "type": "boolean",
            "description": "Whether premium traffic is enabled"
          }
        },
        "required": [
          "iso"
        ]
      },
      "NewTrunkRequest": {
        "type": "object",
        "description": "Request payload for creating a DSS trunk.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Trunk name",
            "example": "Main trunk"
          },
          "channel": {
            "type": "integer",
            "minimum": 1,
            "description": "Maximum number of concurrent channels",
            "example": 10
          },
          "idCustomer": {
            "type": "integer",
            "minimum": 1,
            "description": "Customer identifier",
            "example": 123
          },
          "organizationId": {
            "type": "integer",
            "description": "Organization identifier",
            "example": 10
          },
          "domainId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "DSS domain identifier",
            "example": 4
          },
          "singleNumber": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the trunk uses a single number"
          },
          "numberId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number to associate when singleNumber is enabled",
            "example": 456
          },
          "trafficLimit": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "description": "Traffic credit limit"
          },
          "bkNumber": {
            "type": [
              "string",
              "null"
            ],
            "description": "Backup number",
            "example": "+390212345678"
          },
          "blocked": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Initial blocked state"
          },
          "permanentBk": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether permanent backup routing is enabled"
          },
          "dualIdentity": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether dual identity is enabled"
          },
          "toInRu": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether To In RU is enabled"
          },
          "checkPrefix": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether prefix checking is enabled"
          },
          "countries": {
            "type": [
              "array",
              "null"
            ],
            "description": "Initial enabled destinations.",
            "items": {
              "$ref": "#/components/schemas/NewTrunkCountry"
            }
          }
        },
        "required": [
          "name",
          "channel",
          "idCustomer"
        ]
      },
      "ChangeCustomerTrunk": {
        "type": "object",
        "description": "Request and response payload for changing a DSS trunk customer.",
        "properties": {
          "idCustomer": {
            "type": "integer",
            "description": "New customer identifier",
            "example": 123
          },
          "idTrunk": {
            "type": "integer",
            "description": "DSS trunk identifier",
            "example": 45
          },
          "organizationId": {
            "type": "integer",
            "description": "Organization identifier",
            "example": 10
          }
        },
        "required": [
          "idCustomer",
          "idTrunk",
          "organizationId"
        ]
      },
      "TrunkCountryRequest": {
        "type": "object",
        "description": "Request payload for managing a DSS trunk destination.",
        "properties": {
          "idTrunk": {
            "type": "integer",
            "description": "DSS trunk identifier",
            "example": 45
          },
          "organizationId": {
            "type": "integer",
            "description": "Organization identifier",
            "example": 10
          },
          "sbcId": {
            "type": "integer",
            "description": "Session border controller identifier",
            "example": 2
          },
          "iso": {
            "type": "string",
            "description": "Country ISO code",
            "example": "IT"
          },
          "premium_available": {
            "type": "string",
            "description": "Premium traffic availability value"
          }
        },
        "required": [
          "idTrunk",
          "iso"
        ]
      },
      "NewGatewayRequest": {
        "type": "object",
        "description": "Request payload for creating a DSS gateway.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Gateway name",
            "example": "Primary gateway"
          },
          "channel": {
            "type": "integer",
            "description": "Maximum number of concurrent channels",
            "example": 10
          },
          "idCustomer": {
            "type": "integer",
            "description": "Customer identifier",
            "example": 123
          },
          "organizationId": {
            "type": "integer",
            "description": "Organization identifier",
            "example": 10
          },
          "sbcId": {
            "type": "integer",
            "description": "Session border controller identifier",
            "example": 2
          },
          "ipAddress": {
            "type": "string",
            "description": "Primary IP address",
            "example": "192.0.2.10"
          },
          "port": {
            "type": "integer",
            "description": "Primary SIP port",
            "example": 5060
          },
          "secondaryIpAddress": {
            "type": "string",
            "description": "Secondary IP address",
            "example": "192.0.2.11"
          },
          "portSecondary": {
            "type": "integer",
            "description": "Secondary SIP port",
            "example": 5060
          },
          "dualIdentity": {
            "type": "boolean",
            "description": "Whether dual identity is enabled"
          },
          "webex": {
            "type": "boolean",
            "description": "Whether Webex integration is enabled"
          }
        },
        "required": [
          "name",
          "channel"
        ]
      },
      "ChangeCustomerGateway": {
        "type": "object",
        "description": "Request and response payload for changing a DSS gateway customer.",
        "properties": {
          "idCustomer": {
            "type": "integer",
            "description": "New customer identifier",
            "example": 123
          },
          "idGtw": {
            "type": "integer",
            "description": "DSS gateway identifier",
            "example": 45
          },
          "organizationId": {
            "type": "integer",
            "description": "Organization identifier",
            "example": 10
          }
        },
        "required": [
          "idCustomer",
          "idGtw",
          "organizationId"
        ]
      },
      "GatewayCountryRequest": {
        "type": "object",
        "description": "Request payload for managing a DSS gateway destination.",
        "properties": {
          "idGtw": {
            "type": "integer",
            "description": "DSS gateway identifier",
            "example": 45
          },
          "idOrganization": {
            "type": "integer",
            "description": "Organization identifier",
            "example": 10
          },
          "iso": {
            "type": "string",
            "description": "Country ISO code",
            "example": "IT"
          },
          "premium_available": {
            "type": "string",
            "description": "Premium traffic availability value"
          }
        },
        "required": [
          "idGtw",
          "idOrganization",
          "iso"
        ]
      },
      "TrunkNumberRequest": {
        "type": "object",
        "description": "Request payload for associating or disassociating a number from a DSS trunk.",
        "properties": {
          "idNumber": {
            "type": "integer",
            "description": "Number identifier",
            "example": 456
          },
          "idTrunk": {
            "type": "integer",
            "description": "DSS trunk identifier",
            "example": 45
          },
          "organizationId": {
            "type": "integer",
            "description": "Organization identifier",
            "example": 10
          }
        },
        "required": [
          "idNumber",
          "idTrunk",
          "organizationId"
        ]
      },
      "TrunkSettingsRequest": {
        "type": "object",
        "description": "DSS trunk or gateway settings payload. Each endpoint uses the property relevant to that operation.",
        "properties": {
          "maxChannel": {
            "type": "integer",
            "description": "Maximum number of concurrent channels",
            "example": 10
          },
          "trafficLimit": {
            "type": "integer",
            "description": "Traffic credit limit",
            "example": 1000
          },
          "bkNumber": {
            "type": "string",
            "description": "Backup number",
            "example": "+390212345678"
          },
          "nome": {
            "type": "string",
            "description": "Trunk or gateway name",
            "example": "Main trunk"
          }
        }
      },
      "GatewayNumberRequest": {
        "type": "object",
        "description": "Request payload for associating or disassociating a number from a DSS gateway.",
        "properties": {
          "idNumber": {
            "type": "integer",
            "description": "Number identifier",
            "example": 456
          },
          "idGtw": {
            "type": "integer",
            "description": "DSS gateway identifier",
            "example": 45
          },
          "organizationId": {
            "type": "integer",
            "description": "Organization identifier",
            "example": 10
          }
        },
        "required": [
          "idNumber",
          "idGtw",
          "organizationId"
        ]
      },
      "GatewayIpRequest": {
        "type": "object",
        "description": "Request payload for updating DSS gateway IP settings.",
        "properties": {
          "ipAddress": {
            "type": "string",
            "description": "Primary IP address",
            "example": "192.0.2.10"
          },
          "port": {
            "type": "string",
            "description": "Primary SIP port",
            "example": "5060"
          },
          "secondaryIP": {
            "type": "string",
            "description": "Secondary IP address",
            "example": "192.0.2.11"
          },
          "portSecondary": {
            "type": "string",
            "description": "Secondary SIP port",
            "example": "5060"
          }
        },
        "example": {
          "ipAddress": "192.0.2.10",
          "port": "5060",
          "secondaryIP": "192.0.2.11",
          "portSecondary": "5060"
        }
      },
      "ServiceProvider": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Service provider identifier."
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "Service provider name."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1000,
            "description": "Service provider description."
          }
        }
      },
      "Carrier-2": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Carrier identifier."
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "Carrier name."
          }
        }
      },
      "ServiceType": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Service type identifier."
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "Service type name."
          }
        }
      },
      "ServiceList": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Service catalog entry identifier."
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "Service catalog entry name."
          },
          "serviceProvider": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ServiceProvider"
              },
              {
                "type": "null"
              }
            ]
          },
          "carrier": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Carrier-2"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ServiceType"
              },
              {
                "type": "null"
              }
            ]
          },
          "supplierProductId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 200,
            "description": "Product identifier used by the supplier."
          }
        }
      },
      "ServiceOrg": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Organization service identifier."
          },
          "serviceList": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ServiceList"
              },
              {
                "type": "null"
              }
            ]
          },
          "organizationId": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Organization owning the configured service."
          },
          "integration": {
            "type": [
              "object",
              "null"
            ],
            "description": "Integration summary exposed for the service.",
            "properties": {
              "id": {
                "type": "integer"
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 300,
            "description": "Organization-specific service name."
          },
          "forDirect": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the service is available for direct customers."
          },
          "forSub": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the service is available for subpartners."
          },
          "carrierType": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 50,
            "description": "Carrier-specific service classification."
          },
          "offsetDays": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Service scheduling offset in days."
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Provider-specific service attributes."
          }
        }
      },
      "ActivableServiceResponse": {
        "type": "object",
        "required": [
          "id",
          "name",
          "typeId",
          "typeName",
          "carrierName"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "format": "int32",
            "description": "Organization service profile identifier."
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Display name configured for the selected organization, or the profile name when no display name is configured."
          },
          "typeId": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Service type identifier."
          },
          "typeName": {
            "type": [
              "string",
              "null"
            ],
            "description": "Service type name."
          },
          "carrierName": {
            "type": [
              "string",
              "null"
            ],
            "description": "Carrier name."
          }
        }
      },
      "ActivableServiceOptionResponse": {
        "type": "object",
        "required": [
          "id",
          "serviceId",
          "name",
          "type"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "format": "int32",
            "description": "Organization service option identifier."
          },
          "serviceId": {
            "type": "integer",
            "format": "int32",
            "description": "Associated organization service profile identifier. Matches the profile `id` returned by `GET /v1/service/activable`."
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Option name."
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Option type."
          }
        }
      },
      "ServiceOrgSummary": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "IpClassCatalogResponse": {
        "type": "object",
        "properties": {
          "ipServiceProvider": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "ipv4": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ServiceOrgSummary"
            }
          },
          "ipv6": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ServiceOrgSummary"
            }
          }
        },
        "required": [
          "ipv4",
          "ipv6"
        ],
        "$defs": {
          "ServiceOrgSummary": {
            "type": "object",
            "properties": {
              "id": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      },
      "ServiceOrgOption": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Organization service option identifier."
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100
          },
          "forDirect": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "forSub": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 10
          },
          "serviceOption": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "integer"
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "serviceOrg": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "integer"
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "organization": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "organizationId": {
                "type": "integer",
                "format": "int64"
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      },
      "ServiceOption": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Service option identifier."
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 200
          },
          "supplierProductId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 200
          },
          "optionType": {
            "type": "integer",
            "description": "Option type identifier."
          },
          "supplierOptionId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 200
          },
          "service": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ServiceList"
              },
              {
                "type": "null"
              }
            ]
          }
        }
      },
      "ServiceRequest": {
        "type": "object",
        "description": "Input model used by `ServiceController` to create or update organization services and their options.",
        "properties": {
          "id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "serviceListId": {
            "type": [
              "integer",
              "null"
            ]
          },
          "serviceOrgId": {
            "type": [
              "integer",
              "null"
            ]
          },
          "organizationId": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          },
          "integrationId": {
            "type": [
              "integer",
              "null"
            ]
          },
          "optionId": {
            "type": [
              "integer",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "offsetDays": {
            "type": [
              "integer",
              "null"
            ]
          },
          "carrierType": {
            "type": [
              "string",
              "null"
            ]
          },
          "attributes": {
            "type": [
              "object",
              "array",
              "string",
              "number",
              "boolean",
              "null"
            ]
          },
          "type": {
            "type": [
              "string",
              "null"
            ]
          },
          "forDirect": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "forSub": {
            "type": [
              "boolean",
              "null"
            ]
          }
        },
        "example": {
          "serviceListId": 12,
          "organizationId": 10,
          "integrationId": 34,
          "optionId": 56,
          "name": "Managed service",
          "offsetDays": 0,
          "carrierType": "EIS",
          "attributes": {
            "enabled": true
          },
          "type": "connectivity",
          "forDirect": true,
          "forSub": false
        }
      },
      "Field": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "resolverType": {
            "type": [
              "string",
              "null"
            ]
          },
          "required": {
            "type": "boolean"
          },
          "overridable": {
            "type": "boolean"
          },
          "sensitive": {
            "type": "boolean"
          },
          "exposeOnCreate": {
            "type": "boolean"
          },
          "displayOrder": {
            "type": "integer"
          },
          "config": {
            "description": "Preset-specific field configuration."
          }
        },
        "required": [
          "key",
          "label",
          "type",
          "source",
          "required",
          "overridable",
          "sensitive",
          "exposeOnCreate",
          "displayOrder"
        ]
      },
      "Output": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "fieldType": {
            "type": "string"
          },
          "sensitive": {
            "type": "boolean"
          },
          "oneTime": {
            "type": "boolean"
          },
          "copyable": {
            "type": "boolean"
          },
          "displayOrder": {
            "type": "integer"
          }
        },
        "required": [
          "key",
          "label",
          "fieldType",
          "sensitive",
          "oneTime",
          "copyable",
          "displayOrder"
        ]
      },
      "TrunkPresetResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "code": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "revision": {
            "type": "integer"
          },
          "fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Field"
            }
          },
          "outputs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Output"
            }
          }
        },
        "required": [
          "id",
          "code",
          "label",
          "revision",
          "fields",
          "outputs"
        ],
        "$defs": {
          "Field": {
            "type": "object",
            "properties": {
              "key": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "type": {
                "type": "string"
              },
              "source": {
                "type": "string"
              },
              "resolverType": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "required": {
                "type": "boolean"
              },
              "overridable": {
                "type": "boolean"
              },
              "sensitive": {
                "type": "boolean"
              },
              "exposeOnCreate": {
                "type": "boolean"
              },
              "displayOrder": {
                "type": "integer"
              },
              "config": {
                "description": "Preset-specific field configuration."
              }
            },
            "required": [
              "key",
              "label",
              "type",
              "source",
              "required",
              "overridable",
              "sensitive",
              "exposeOnCreate",
              "displayOrder"
            ]
          },
          "Output": {
            "type": "object",
            "properties": {
              "key": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "fieldType": {
                "type": "string"
              },
              "sensitive": {
                "type": "boolean"
              },
              "oneTime": {
                "type": "boolean"
              },
              "copyable": {
                "type": "boolean"
              },
              "displayOrder": {
                "type": "integer"
              }
            },
            "required": [
              "key",
              "label",
              "fieldType",
              "sensitive",
              "oneTime",
              "copyable",
              "displayOrder"
            ]
          }
        }
      },
      "CreatePresetTrunkRequest": {
        "type": "object",
        "properties": {
          "presetId": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "idCustomer": {
            "type": "integer",
            "minimum": 1
          },
          "organizationId": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "default": 0,
            "description": "Organization identifier. Use `0` to resolve it from the authenticated user."
          },
          "parameters": {
            "type": "object",
            "additionalProperties": true,
            "description": "Values for the configurable preset fields."
          }
        },
        "required": [
          "presetId",
          "idCustomer"
        ]
      },
      "CreatePresetTrunkResponse": {
        "type": "object",
        "properties": {
          "presetId": {
            "type": "integer",
            "format": "int64"
          },
          "presetCode": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "additionalProperties": true,
            "description": "Public provisioning outputs. Sensitive or one-time values may be included."
          },
          "actionObject": {
            "$ref": "#/components/schemas/ActionObjectReference"
          }
        },
        "required": [
          "presetId",
          "presetCode",
          "label",
          "status",
          "data",
          "actionObject"
        ]
      },
      "Field-2": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "fieldType": {
            "type": "string"
          },
          "required": {
            "type": "boolean"
          },
          "sensitive": {
            "type": "boolean"
          },
          "displayOrder": {
            "type": "integer"
          },
          "config": {
            "description": "Action-specific field configuration."
          }
        },
        "required": [
          "key",
          "label",
          "fieldType",
          "required",
          "sensitive",
          "displayOrder"
        ]
      },
      "Action": {
        "type": "object",
        "properties": {
          "actionId": {
            "type": "integer",
            "format": "int64"
          },
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "displayOrder": {
            "type": "integer"
          },
          "fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Field-2"
            }
          },
          "outputs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Output"
            }
          }
        },
        "required": [
          "actionId",
          "key",
          "label",
          "displayOrder",
          "fields",
          "outputs"
        ]
      },
      "ActionRuntimeResponse": {
        "type": "object",
        "properties": {
          "target": {
            "type": "object",
            "properties": {
              "moduleId": {
                "type": "integer"
              },
              "organizationId": {
                "type": "integer",
                "format": "int64"
              },
              "objectType": {
                "type": "string"
              },
              "objectId": {
                "type": "string"
              },
              "context": {
                "type": "object",
                "additionalProperties": {
                  "type": "string"
                }
              },
              "data": {
                "type": "object",
                "additionalProperties": true
              }
            },
            "required": [
              "moduleId",
              "organizationId",
              "objectType",
              "objectId",
              "context",
              "data"
            ]
          },
          "groups": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "actions": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Action"
                  }
                }
              },
              "required": [
                "code",
                "label",
                "actions"
              ]
            }
          }
        },
        "required": [
          "target",
          "groups"
        ],
        "$defs": {
          "Action": {
            "type": "object",
            "properties": {
              "actionId": {
                "type": "integer",
                "format": "int64"
              },
              "key": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "displayOrder": {
                "type": "integer"
              },
              "fields": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Field-2"
                }
              },
              "outputs": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Output"
                }
              }
            },
            "required": [
              "actionId",
              "key",
              "label",
              "displayOrder",
              "fields",
              "outputs"
            ]
          },
          "Field-2": {
            "type": "object",
            "properties": {
              "key": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "fieldType": {
                "type": "string"
              },
              "required": {
                "type": "boolean"
              },
              "sensitive": {
                "type": "boolean"
              },
              "displayOrder": {
                "type": "integer"
              },
              "config": {
                "description": "Action-specific field configuration."
              }
            },
            "required": [
              "key",
              "label",
              "fieldType",
              "required",
              "sensitive",
              "displayOrder"
            ]
          },
          "Output": {
            "type": "object",
            "properties": {
              "key": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "fieldType": {
                "type": "string"
              },
              "sensitive": {
                "type": "boolean"
              },
              "oneTime": {
                "type": "boolean"
              },
              "copyable": {
                "type": "boolean"
              },
              "displayOrder": {
                "type": "integer"
              }
            },
            "required": [
              "key",
              "label",
              "fieldType",
              "sensitive",
              "oneTime",
              "copyable",
              "displayOrder"
            ]
          }
        }
      },
      "ExecuteActionRuntimeRequest": {
        "type": "object",
        "properties": {
          "actionId": {
            "type": "integer",
            "format": "int64",
            "minimum": 1
          },
          "actionObject": {
            "$ref": "#/components/schemas/ActionObjectReference"
          },
          "parameters": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Values requested by the selected action fields."
          }
        },
        "required": [
          "actionId",
          "actionObject"
        ]
      },
      "ExecuteActionRuntimeResponse": {
        "type": "object",
        "properties": {
          "executionId": {
            "type": "string"
          },
          "actionId": {
            "type": "integer",
            "format": "int64"
          },
          "label": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "additionalProperties": true,
            "description": "Public action outputs. Sensitive or one-time values may be included."
          }
        },
        "required": [
          "executionId",
          "actionId",
          "label",
          "status",
          "data"
        ]
      },
      "Circuit": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "supplierId": {
            "type": "string"
          },
          "supplierProcedureId": {
            "type": [
              "string",
              "null"
            ]
          },
          "resourceId": {
            "type": [
              "string",
              "null"
            ]
          },
          "accountSupplier": {
            "type": "string"
          },
          "insertDate": {
            "type": "string"
          },
          "dad": {
            "type": "string"
          },
          "appointmentDate": {
            "type": [
              "string",
              "null"
            ],
            "description": "Format: dd/MM/yyyy HH:mm"
          },
          "type": {
            "type": "string"
          },
          "completeDate": {
            "type": [
              "string",
              "null"
            ]
          },
          "residentialContext": {
            "type": [
              "string",
              "null"
            ]
          },
          "stair": {
            "type": [
              "string",
              "null"
            ]
          },
          "floor": {
            "type": [
              "string",
              "null"
            ]
          },
          "unit": {
            "type": [
              "string",
              "null"
            ]
          },
          "idBuilding": {
            "type": [
              "string",
              "null"
            ]
          },
          "egonCode": {
            "type": [
              "string",
              "null"
            ]
          },
          "timeSlot": {
            "type": "string"
          },
          "firtNameRef": {
            "type": "string"
          },
          "lastNameRef": {
            "type": "string"
          },
          "fixedNumberRef": {
            "type": "string"
          },
          "mobileNumberRef": {
            "type": "string"
          },
          "emailRef": {
            "type": "string"
          },
          "productName": {
            "type": "string"
          },
          "koHistory": {
            "type": [
              "string",
              "null"
            ]
          },
          "cow": {
            "type": [
              "string",
              "null"
            ]
          },
          "cor": {
            "type": [
              "string",
              "null"
            ]
          },
          "cos": {
            "type": [
              "string",
              "null"
            ]
          },
          "contrChar": {
            "type": [
              "string",
              "null"
            ]
          },
          "donating": {
            "type": [
              "string",
              "null"
            ]
          },
          "donatingSocieta": {
            "type": [
              "string",
              "null"
            ]
          },
          "publicIpv4": {
            "type": "boolean"
          },
          "publicIpv6": {
            "type": "boolean"
          },
          "organization": {
            "type": "object",
            "properties": {
              "organizationId": {
                "type": "integer"
              },
              "userId": {
                "type": "integer"
              },
              "userName": {
                "type": "string"
              },
              "createDate": {
                "type": "string"
              },
              "modifiedDate": {
                "type": "string"
              },
              "parentOrganizationId": {
                "type": "integer"
              },
              "name": {
                "type": "string"
              },
              "type_": {
                "type": "string"
              },
              "sbcId": {
                "type": "integer"
              },
              "documentation_URL": {
                "type": "string"
              },
              "support_URL": {
                "type": "string"
              },
              "status_URL": {
                "type": "string"
              },
              "redirect_URL": {
                "type": "string"
              },
              "notificationEmailFromAddress": {
                "type": "string"
              },
              "customerId": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "user": {
            "type": "object",
            "properties": {
              "userId": {
                "type": "integer"
              },
              "ssoId": {
                "type": "string"
              },
              "createDate": {
                "type": "string"
              },
              "modifiedDate": {
                "type": "string"
              },
              "emailAddress": {
                "type": "string"
              },
              "firstName": {
                "type": "string"
              },
              "lastName": {
                "type": "string"
              },
              "hasToChangePassword": {
                "type": "boolean"
              },
              "type": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  }
                }
              },
              "organizationId": {
                "type": "integer"
              },
              "parentOrganizationId": {
                "type": "integer"
              },
              "organizationName": {
                "type": "string"
              }
            }
          },
          "customer": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer"
              },
              "organizationId": {
                "type": "integer"
              },
              "name": {
                "type": "string"
              },
              "ragioneSociale": {
                "type": "string"
              },
              "rappresentante": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "indirizzo": {
                "type": "string"
              },
              "civico": {
                "type": "string"
              },
              "indSedLeg": {
                "type": "string"
              },
              "civicoSedLeg": {
                "type": "string"
              },
              "comuneSedLeg": {
                "type": "string"
              },
              "provinciaSedLeg": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "regioneSedLeg": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "capSedLeg": {
                "type": "string"
              },
              "comune": {
                "type": "string"
              },
              "provincia": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "regione": {
                "type": "string"
              },
              "cap": {
                "type": "string"
              },
              "tel": {
                "type": "string"
              },
              "fiscalCode": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "isActive": {
                "type": "string"
              },
              "userid": {
                "type": "integer"
              },
              "customerPortal": {
                "type": "boolean"
              },
              "associated_users": {
                "type": "array"
              },
              "piva": {
                "type": "string"
              },
              "ptoponomastica": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "status": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer"
              },
              "code": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "finishStatus": {
                "type": "boolean"
              }
            }
          },
          "profile": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer"
              },
              "serviceList": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  },
                  "serviceProvider": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer"
                      },
                      "description": {
                        "type": "string"
                      }
                    }
                  },
                  "carrier": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer"
                      },
                      "name": {
                        "type": "string"
                      }
                    }
                  },
                  "type": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer"
                      },
                      "name": {
                        "type": "string"
                      }
                    }
                  },
                  "supplierProductId": {
                    "type": "string"
                  }
                }
              },
              "organizationId": {
                "type": "integer"
              },
              "integration": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  }
                }
              },
              "name": {
                "type": "string"
              },
              "forDirect": {
                "type": "boolean"
              },
              "forSub": {
                "type": "boolean"
              },
              "carrierType": {
                "type": "string"
              },
              "offsetDays": {
                "type": "integer"
              }
            }
          },
          "mcr": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ServiceOrgOption"
              },
              {
                "type": "null"
              }
            ]
          },
          "sla": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ServiceOrgOption"
              },
              {
                "type": "null"
              }
            ]
          },
          "drt": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ServiceOrgOption"
              },
              {
                "type": "null"
              }
            ]
          },
          "ipV4": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ServiceOrg"
              },
              {
                "type": "null"
              }
            ]
          },
          "ipV6": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ServiceOrg"
              },
              {
                "type": "null"
              }
            ]
          }
        }
      },
      "Circuit_Detail": {
        "type": "object",
        "properties": {
          "orderId": {
            "type": "integer"
          },
          "organizationId": {
            "type": "integer"
          },
          "mc": {
            "type": "string"
          },
          "hid": {
            "type": "integer"
          },
          "resourceId": {
            "type": "string"
          },
          "xdslTypeId": {
            "type": "integer"
          },
          "appointmentDate": {
            "type": "string"
          },
          "technicalData": {
            "type": "object",
            "properties": {
              "username": {
                "type": "string"
              },
              "password": {
                "type": "string"
              },
              "userVlan": {
                "type": "string"
              },
              "cvlanCode": {
                "type": "string"
              },
              "td": {
                "type": "string"
              }
            }
          },
          "statusHistory": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "note": {
                  "type": "string"
                }
              }
            }
          },
          "contactHistory": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "nameRef": {
                  "type": "string"
                },
                "lastNameRef": {
                  "type": "string"
                },
                "tlcAccount": {
                  "type": "string"
                },
                "contactDate": {
                  "type": "string"
                }
              }
            }
          },
          "timeline": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string"
                },
                "requestId": {
                  "type": "string"
                },
                "active": {
                  "type": "boolean"
                },
                "inUse": {
                  "type": "boolean"
                },
                "type": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "Circuit_ping": {
        "type": "object",
        "properties": {
          "ping": {
            "type": "string"
          }
        }
      },
      "Circuit_logs": {
        "type": "object",
        "properties": {
          "connectionState": {
            "type": "boolean"
          },
          "lastUpdate": {
            "type": "string"
          },
          "logs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "username": {
                  "type": "string"
                },
                "ipAddress": {
                  "type": "string"
                },
                "startTime": {
                  "type": "string"
                },
                "sessionTime": {
                  "type": "string"
                },
                "endTime": {
                  "type": "string"
                },
                "kbytesIn": {
                  "type": "string"
                },
                "kbytesOut": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "Circuit_NGASP": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "Circuit_IPClasses": {
        "type": "object",
        "properties": {
          "orderCode": {
            "type": "string"
          },
          "ipAddress": {
            "type": "string"
          },
          "netMask": {
            "type": "string"
          },
          "desc": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "pppipAddress": {
            "type": "string"
          }
        }
      },
      "CoverageCity": {
        "type": "object",
        "properties": {
          "city": {
            "type": "string",
            "description": "The name of the city"
          },
          "province": {
            "type": "string",
            "description": "The province abbreviation"
          },
          "provinceComplete": {
            "type": "string",
            "description": "The complete province name"
          },
          "zipcode": {
            "type": "string",
            "description": "The postal code"
          },
          "phonePrefix": {
            "type": "string",
            "description": "The telephone prefix for the city"
          },
          "region": {
            "type": "string",
            "description": "The region name"
          },
          "egonCode": {
            "type": "string",
            "description": "The EGON code identifier"
          },
          "idCity": {
            "type": "string",
            "description": "The unique city identifier"
          }
        },
        "required": [
          "city",
          "province",
          "provinceComplete",
          "zipcode",
          "phonePrefix",
          "region",
          "egonCode",
          "idCity"
        ]
      },
      "CoverageAddress": {
        "type": "object",
        "properties": {
          "street": {
            "type": "string",
            "description": "The street name"
          },
          "name": {
            "type": "string",
            "description": "The address name"
          },
          "egonCode": {
            "type": "string",
            "description": "The EGON code identifier"
          },
          "toponym": {
            "type": "string",
            "description": "The toponym type (e.g., VIA, VIALE, PIAZZA)"
          },
          "idAddress": {
            "type": "string",
            "description": "The unique address identifier"
          }
        },
        "required": [
          "street",
          "name",
          "egonCode",
          "toponym",
          "idAddress"
        ]
      },
      "CoverageStreetNumber": {
        "type": "object",
        "properties": {
          "idStreetNumber": {
            "type": "string",
            "description": "The unique street number identifier"
          },
          "addressId": {
            "type": "string",
            "description": "The associated address identifier"
          },
          "number": {
            "type": "string",
            "description": "The street number"
          },
          "toponomastico": {
            "type": "string",
            "description": "The toponomastico reference (same as number or with additional info)"
          }
        },
        "required": [
          "idStreetNumber",
          "addressId",
          "number",
          "toponomastico"
        ]
      },
      "CoverageValidateRequest": {
        "type": "object",
        "properties": {
          "city": {
            "type": "string",
            "description": "The city name to validate"
          },
          "address": {
            "type": "string",
            "description": "The address or street name to validate"
          },
          "number": {
            "type": "string",
            "description": "The street number to validate"
          },
          "province": {
            "type": "string",
            "description": "The province name or abbreviation to validate"
          }
        },
        "required": [
          "city",
          "address",
          "number",
          "province"
        ]
      },
      "CoverageValidateResponse": {
        "type": "object",
        "properties": {
          "city": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "The city name"
              },
              "province": {
                "type": "string",
                "description": "The province name"
              },
              "provinceISO3166": {
                "type": "string",
                "description": "The province ISO 3166 code"
              },
              "zipCode": {
                "type": "string",
                "description": "The postal code range"
              },
              "phonePrefix": {
                "type": "string",
                "description": "The telephone prefix for the city"
              },
              "region": {
                "type": "string",
                "description": "The region name"
              },
              "egonCode": {
                "type": "string",
                "description": "The EGON code identifier for the city"
              },
              "idCity": {
                "type": "string",
                "nullable": true,
                "description": "The unique city identifier (may be null)"
              }
            },
            "required": [
              "name",
              "province",
              "provinceISO3166",
              "zipCode",
              "phonePrefix",
              "region",
              "egonCode"
            ]
          },
          "address": {
            "type": "object",
            "properties": {
              "streetType": {
                "type": "string",
                "description": "The full street name with type (e.g., VIA TEVERE)"
              },
              "name": {
                "type": "string",
                "description": "The address name"
              },
              "egonCode": {
                "type": "string",
                "description": "The EGON code identifier for the address"
              },
              "toponym": {
                "type": "string",
                "description": "The toponym type (e.g., VIA, VIALE, PIAZZA)"
              }
            },
            "required": [
              "streetType",
              "name",
              "egonCode",
              "toponym"
            ]
          },
          "streetNumber": {
            "type": "string",
            "description": "The validated street number"
          },
          "egonCode": {
            "type": "string",
            "description": "The EGON code identifier for the street number"
          },
          "validCity": {
            "type": "boolean",
            "description": "Whether the city is valid"
          },
          "validAddress": {
            "type": "boolean",
            "description": "Whether the address is valid"
          },
          "validStreetNumber": {
            "type": "boolean",
            "description": "Whether the street number is valid"
          },
          "valid": {
            "type": "boolean",
            "description": "Overall validity indicator (true if all validations pass)"
          }
        },
        "required": [
          "city",
          "address",
          "streetNumber",
          "egonCode",
          "validCity",
          "validAddress",
          "validStreetNumber",
          "valid"
        ]
      },
      "NumberOrderHistoryItem": {
        "type": "object",
        "description": "History entry for a numbering order.",
        "properties": {
          "date": {
            "type": "string",
            "description": "The history entry timestamp"
          },
          "description": {
            "type": "string",
            "description": "The history event description"
          },
          "note": {
            "type": "string",
            "nullable": true,
            "description": "Additional notes for the history entry"
          },
          "causal": {
            "type": "string",
            "nullable": true,
            "description": "The causal or reason associated with the event"
          },
          "code": {
            "type": [
              "string",
              "null"
            ]
          },
          "customTimeline": {
            "type": "boolean"
          },
          "timelineId": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "required": [
          "date",
          "description",
          "customTimeline"
        ]
      },
      "NumberNewOrderItem": {
        "type": "object",
        "description": "Order information for native new number orders.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The unique order identifier"
          },
          "status": {
            "$ref": "#/components/schemas/Status"
          },
          "service": {
            "type": "string",
            "description": "The service name"
          },
          "customerName": {
            "type": "string",
            "description": "The customer name"
          },
          "ragioneSociale": {
            "type": [
              "string",
              "null"
            ],
            "description": "Customer legal name"
          },
          "type": {
            "type": "string",
            "description": "The order type"
          },
          "createdDate": {
            "type": "string",
            "description": "The order creation date"
          },
          "organizationId": {
            "type": "integer",
            "description": "The organization identifier"
          },
          "organizationName": {
            "type": "string",
            "description": "The organization name"
          },
          "quantity": {
            "type": "integer",
            "description": "The ordered quantity"
          },
          "region": {
            "type": "string",
            "nullable": true,
            "description": "The region associated with the order"
          },
          "province": {
            "type": "string",
            "nullable": true,
            "description": "The province associated with the order"
          },
          "city": {
            "type": "string",
            "nullable": true,
            "description": "The city associated with the order"
          }
        },
        "required": [
          "id",
          "status",
          "service",
          "customerName",
          "type",
          "createdDate",
          "organizationId",
          "organizationName",
          "quantity"
        ]
      },
      "NumberNewOrderRequest": {
        "type": "object",
        "description": "Request payload for creating a native new number order.",
        "properties": {
          "idService": {
            "type": "integer",
            "description": "The service identifier"
          },
          "idCustomer": {
            "type": "integer",
            "description": "The customer identifier"
          },
          "organizationId": {
            "type": "integer",
            "description": "The organization identifier"
          }
        },
        "required": [
          "idService",
          "idCustomer",
          "organizationId"
        ]
      },
      "NumberPortabilityItem": {
        "type": "object",
        "description": "Order information for portability orders.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The unique order identifier"
          },
          "status": {
            "$ref": "#/components/schemas/Status"
          },
          "service": {
            "type": "string",
            "description": "The service name"
          },
          "direction": {
            "type": "string",
            "description": "The portability direction"
          },
          "customerName": {
            "type": "string",
            "description": "The customer name"
          },
          "ragioneSociale": {
            "type": [
              "string",
              "null"
            ],
            "description": "Customer legal name"
          },
          "dn": {
            "type": "string",
            "description": "The directory number"
          },
          "lineType": {
            "type": "string",
            "description": "The line type"
          },
          "createdDate": {
            "type": "string",
            "description": "The order creation date"
          },
          "dac": {
            "type": "string",
            "description": "The DAC date"
          },
          "organizationId": {
            "type": "integer",
            "description": "The organization identifier"
          },
          "organizationName": {
            "type": "string",
            "description": "The organization name"
          }
        },
        "required": [
          "id",
          "status",
          "service",
          "direction",
          "customerName",
          "dn",
          "lineType",
          "createdDate",
          "dac",
          "organizationId",
          "organizationName"
        ]
      },
      "NumberMigrationCodeRequest": {
        "type": "object",
        "description": "Request payload for checking a migration code.",
        "properties": {
          "cow": {
            "type": "string",
            "description": "The COW code"
          },
          "cor": {
            "type": "string",
            "description": "The COR code"
          },
          "cos": {
            "type": "string",
            "description": "The COS code"
          },
          "controlCode": {
            "type": "string",
            "description": "The control code"
          }
        },
        "required": [
          "cow",
          "cor",
          "cos",
          "controlCode"
        ]
      },
      "NumberMigrationCodeResponse": {
        "type": "object",
        "description": "Response payload for a migration code check.",
        "properties": {
          "cow": {
            "type": "string",
            "description": "The COW code"
          },
          "cor": {
            "type": "string",
            "description": "The COR code"
          },
          "cos": {
            "type": "string",
            "description": "The COS code"
          },
          "controlCode": {
            "type": "string",
            "description": "The control code"
          },
          "donor": {
            "type": "object",
            "description": "The donor carrier information",
            "properties": {
              "description": {
                "type": "string",
                "description": "The donor carrier description"
              },
              "code": {
                "type": "string",
                "description": "The donor carrier code"
              },
              "idCarrier": {
                "type": "string",
                "description": "The donor carrier identifier"
              }
            },
            "required": [
              "description",
              "code",
              "idCarrier"
            ]
          },
          "donating": {
            "type": "object",
            "description": "The donating carrier information",
            "properties": {
              "description": {
                "type": "string",
                "description": "The donating carrier description"
              },
              "code": {
                "type": "string",
                "description": "The donating carrier code"
              },
              "idCarrier": {
                "type": "string",
                "description": "The donating carrier identifier"
              }
            },
            "required": [
              "description",
              "code",
              "idCarrier"
            ]
          },
          "routingNumber": {
            "type": "string",
            "description": "The generated routing number"
          },
          "completeCode": {
            "type": "string",
            "description": "The complete migration code"
          },
          "valid": {
            "type": "boolean",
            "description": "Whether the migration code is valid"
          }
        },
        "required": [
          "cow",
          "cor",
          "cos",
          "controlCode",
          "donor",
          "donating",
          "routingNumber",
          "completeCode",
          "valid"
        ]
      },
      "NumberRescheduleRequest": {
        "type": "object",
        "description": "Request payload for rescheduling a portability order.",
        "properties": {
          "organizationId": {
            "type": "integer",
            "format": "int64",
            "description": "The organization identifier (long)"
          },
          "orderId": {
            "type": "integer",
            "description": "The portability order identifier (int)"
          },
          "new_dac": {
            "type": "string",
            "description": "The new DAC date in format dd/MM/yyyy",
            "pattern": "^(0[1-9]|[12][0-9]|3[01])/(0[1-9]|1[0-2])/\\d{4}$"
          }
        },
        "required": [
          "organizationId",
          "orderId",
          "new_dac"
        ]
      },
      "NumberPortabilityCreateRequest": {
        "type": "object",
        "description": "Request payload for creating a portability order.",
        "properties": {
          "idService": {
            "type": "integer",
            "description": "The service identifier"
          },
          "idCustomer": {
            "type": "integer",
            "description": "The customer identifier"
          },
          "organizationId": {
            "type": "integer",
            "description": "The organization identifier"
          },
          "cow": {
            "type": "string",
            "description": "The COW code"
          },
          "cor": {
            "type": "string",
            "description": "The COR code"
          },
          "cos": {
            "type": "string",
            "description": "The COS code"
          },
          "controlCode": {
            "type": "string",
            "description": "The control code"
          },
          "lineType": {
            "type": "integer",
            "enum": [
              1,
              2,
              3,
              4,
              5
            ],
            "description": "The line type. 1 = Simplex, 2 = GNR, 3 = ISDN mono, 4 = ISDN multi, 5 = POTS"
          },
          "dac": {
            "type": "string",
            "description": "The DAC date"
          },
          "phoneContact": {
            "type": "string",
            "description": "The contact phone number"
          },
          "emailContact": {
            "type": "string",
            "description": "The contact email address"
          }
        },
        "required": [
          "idService",
          "idCustomer",
          "organizationId",
          "cow",
          "cor",
          "cos",
          "controlCode",
          "lineType",
          "dac",
          "phoneContact",
          "emailContact"
        ]
      },
      "NumberItem": {
        "type": "object",
        "description": "Optimized number list item.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The unique number identifier"
          },
          "idOrder": {
            "type": "integer",
            "description": "The related order identifier"
          },
          "orderType": {
            "type": "string",
            "description": "The order type"
          },
          "orderStatus": {
            "$ref": "#/components/schemas/Status"
          },
          "type": {
            "type": "string",
            "description": "The type description"
          },
          "typeSP": {
            "type": "string",
            "description": "The type short code"
          },
          "customerName": {
            "type": "string",
            "description": "The customer display name"
          },
          "ragioneSociale": {
            "type": "string",
            "description": "The legal company name"
          },
          "activationDate": {
            "type": "string",
            "nullable": true,
            "description": "The activation date"
          },
          "createdDate": {
            "type": "string",
            "description": "The creation date"
          },
          "dac": {
            "type": "string",
            "description": "The DAC date"
          },
          "destination": {
            "type": "string",
            "nullable": true,
            "description": "The destination"
          },
          "organizationName": {
            "type": "string",
            "description": "The organization name"
          },
          "organizationId": {
            "type": "integer",
            "description": "The organization identifier"
          },
          "dn": {
            "type": "string",
            "description": "The directory number"
          }
        },
        "required": [
          "id",
          "idOrder",
          "orderType",
          "orderStatus",
          "customerName",
          "createdDate",
          "organizationId",
          "dn"
        ]
      },
      "NumberActivateRequest": {
        "type": "object",
        "description": "Request payload for activating a number.",
        "properties": {
          "idNumber": {
            "type": "integer",
            "description": "The number identifier"
          },
          "voipPlatform": {
            "type": "integer",
            "description": "The VoIP platform identifier"
          },
          "organizationId": {
            "type": "integer",
            "description": "The organization identifier"
          },
          "category": {
            "type": "integer",
            "description": "The category identifier"
          },
          "optionalData": {
            "type": "object",
            "properties": {
              "qualification": {
                "type": "string",
                "description": "The qualification"
              },
              "occupation": {
                "type": "string",
                "description": "The occupation"
              },
              "email": {
                "type": "string",
                "description": "The email address"
              },
              "additionalAddress": {
                "type": "string",
                "description": "The additional address"
              },
              "note": {
                "type": "string",
                "description": "The note"
              }
            }
          },
          "consent": {
            "type": "object",
            "properties": {
              "paperDirectories": {
                "type": "boolean",
                "description": "Consent for paper directories"
              },
              "informationServices": {
                "type": "boolean",
                "description": "Consent for information services"
              },
              "derivedSearch": {
                "type": "boolean",
                "description": "Consent for derived search"
              },
              "emailAdvertising": {
                "type": "boolean",
                "description": "Consent for email advertising"
              },
              "taxCodeAggregation": {
                "type": "boolean",
                "description": "Consent for tax code aggregation"
              },
              "phoneAdvertising": {
                "type": "boolean",
                "description": "Consent for phone advertising"
              },
              "otherAdvertisingChannels": {
                "type": "boolean",
                "description": "Consent for other advertising channels"
              }
            }
          },
          "dbu": {
            "type": "boolean",
            "description": "Whether DBU is enabled"
          }
        },
        "required": [
          "idNumber",
          "voipPlatform",
          "organizationId",
          "category",
          "consent",
          "dbu"
        ]
      },
      "NumberTerminateRequest": {
        "type": "object",
        "description": "Request payload for terminating a number.",
        "properties": {
          "idNumber": {
            "type": "integer",
            "description": "Number identifier",
            "example": 123
          },
          "organizationId": {
            "type": "integer",
            "description": "Organization identifier",
            "example": 10
          }
        },
        "required": [
          "idNumber",
          "organizationId"
        ]
      },
      "CoverageTechnologyItem": {
        "type": "object",
        "properties": {
          "providerId": {
            "type": "integer",
            "description": "The provider identifier"
          },
          "providerName": {
            "type": "string",
            "description": "The provider name"
          },
          "speedLimit": {
            "type": "number",
            "format": "float",
            "description": "The maximum available speed"
          },
          "speedComplete": {
            "type": "string",
            "nullable": true,
            "description": "The complete speed description"
          },
          "multipleConnection": {
            "type": "boolean",
            "description": "Whether multiple connections are available"
          },
          "distance": {
            "type": "number",
            "format": "float",
            "description": "The distance from the connection element"
          },
          "connectionType": {
            "type": "string",
            "description": "The connection type"
          },
          "connectionElementName": {
            "type": "string",
            "description": "The connection element name"
          },
          "connectionCLLi": {
            "type": "string",
            "description": "The connection CLLI code"
          },
          "serviceName": {
            "type": "string",
            "description": "The service name"
          },
          "serviceDescription": {
            "type": "string",
            "description": "The service description"
          },
          "oloServiceId": {
            "type": "integer",
            "description": "The OLO service identifier"
          },
          "oloTypeProduct": {
            "type": "string",
            "description": "The OLO product type"
          },
          "oloTypeService": {
            "type": "string",
            "description": "The OLO service type"
          },
          "fiberRange": {
            "type": "string",
            "nullable": true,
            "description": "The fiber range, if available"
          },
          "coverage": {
            "type": "boolean",
            "description": "Whether coverage is available"
          },
          "idBuilding": {
            "type": "string",
            "description": "The building identifier"
          },
          "headerId": {
            "type": "string",
            "description": "The header identifier"
          },
          "connectionElementDetail": {
            "type": "string",
            "description": "The connection element detail"
          },
          "statusCode": {
            "type": [
              "string",
              "null"
            ],
            "description": "Provider status code, when returned"
          },
          "statusDescription": {
            "type": [
              "string",
              "null"
            ],
            "description": "Provider status description, when returned"
          }
        },
        "required": [
          "providerId",
          "providerName",
          "speedLimit",
          "multipleConnection",
          "distance",
          "connectionType",
          "connectionElementName",
          "connectionCLLi",
          "serviceName",
          "serviceDescription",
          "oloServiceId",
          "oloTypeProduct",
          "oloTypeService",
          "coverage",
          "idBuilding",
          "headerId",
          "connectionElementDetail"
        ]
      },
      "Circuit_MinimumDate": {
        "type": "object",
        "properties": {
          "minimumDate": {
            "type": "string"
          }
        }
      },
      "Circuit_verifyHoliday": {
        "type": "object",
        "properties": {
          "isHoliday": {
            "type": "boolean"
          }
        }
      },
      "CircuitActivateRequest": {
        "type": "object",
        "required": [
          "contact",
          "timeslot",
          "idBuilding",
          "serviceId",
          "mcrId",
          "slaId",
          "customerId",
          "streetNumber",
          "organizationId",
          "userId",
          "dad"
        ],
        "properties": {
          "contact": {
            "type": "object",
            "required": [
              "firstName",
              "lastName",
              "email",
              "mobile_number",
              "fixed_number"
            ],
            "properties": {
              "firstName": {
                "type": "string"
              },
              "lastName": {
                "type": "string"
              },
              "email": {
                "type": "string"
              },
              "mobile_number": {
                "type": "string"
              },
              "fixed_number": {
                "type": "string"
              }
            }
          },
          "timeslot": {
            "type": "integer",
            "enum": [
              1,
              2,
              3,
              4
            ],
            "description": "Fascia oraria dell'appuntamento di attivazione.\n\n- `1` — 08:30–10:30\n- `2` — 10:30–13:00\n- `3` — 13:00–15:00\n- `4` — 15:00–18:00\n"
          },
          "idBuilding": {
            "type": "string"
          },
          "serviceId": {
            "type": "integer"
          },
          "mcrId": {
            "type": "integer"
          },
          "slaId": {
            "type": "integer"
          },
          "drtId": {
            "type": "integer",
            "description": "ID dell'opzione DRT attivabile per il profilo indicato in `serviceId` e per l'organizzazione selezionata. Ometti il campo o usa `0` se non vuoi selezionare un'opzione DRT."
          },
          "customerId": {
            "type": "integer"
          },
          "streetNumber": {
            "type": "string"
          },
          "organizationId": {
            "type": "integer"
          },
          "userId": {
            "type": "integer"
          },
          "dad": {
            "type": "string"
          },
          "publicIpv6": {
            "type": "boolean"
          },
          "ipv4AdditionalId": {
            "type": "integer"
          },
          "ipv6AdditionalId": {
            "type": "integer"
          },
          "residentialContext": {
            "type": "string"
          },
          "stair": {
            "type": "string"
          },
          "floor": {
            "type": "string"
          },
          "unit": {
            "type": "string"
          },
          "headerId": {
            "type": "string"
          }
        }
      },
      "CircuitMigrateRequest": {
        "type": "object",
        "required": [
          "contact",
          "idBuilding",
          "timeslot",
          "serviceId",
          "mcrId",
          "slaId",
          "customerId",
          "streetNumber",
          "organizationId",
          "userId",
          "dac",
          "mc",
          "carrierName",
          "oloCode",
          "technology"
        ],
        "properties": {
          "contact": {
            "type": "object",
            "required": [
              "firstName",
              "lastName",
              "email",
              "mobile_number",
              "fixed_number"
            ],
            "properties": {
              "firstName": {
                "type": "string"
              },
              "lastName": {
                "type": "string"
              },
              "email": {
                "type": "string"
              },
              "mobile_number": {
                "type": "string"
              },
              "fixed_number": {
                "type": "string"
              }
            }
          },
          "idBuilding": {
            "type": "string"
          },
          "timeslot": {
            "type": "integer"
          },
          "serviceId": {
            "type": "integer"
          },
          "mcrId": {
            "type": "integer"
          },
          "slaId": {
            "type": "integer"
          },
          "customerId": {
            "type": "integer"
          },
          "streetNumber": {
            "type": "string"
          },
          "organizationId": {
            "type": "integer"
          },
          "userId": {
            "type": "integer"
          },
          "dac": {
            "type": "string"
          },
          "publicIpv6": {
            "type": "boolean"
          },
          "ipv4AdditionalId": {
            "type": "integer"
          },
          "ipv6AdditionalId": {
            "type": "integer"
          },
          "residentialContext": {
            "type": "string"
          },
          "stair": {
            "type": "string"
          },
          "floor": {
            "type": "string"
          },
          "unit": {
            "type": "string"
          },
          "mc": {
            "type": "string"
          },
          "carrierName": {
            "type": "string"
          },
          "oloCode": {
            "type": "string"
          },
          "tempUsername": {
            "type": "string"
          },
          "tempPassword": {
            "type": "string"
          },
          "technology": {
            "type": "string"
          },
          "directoryNumbers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "CircuitTerminateRequest": {
        "type": "object",
        "required": [
          "id",
          "organizationId"
        ],
        "properties": {
          "id": {
            "type": "integer"
          },
          "organizationId": {
            "type": "integer"
          }
        }
      },
      "CircuitMigrationCheckMcRequest": {
        "type": "object",
        "required": [
          "mc",
          "carrierName"
        ],
        "properties": {
          "mc": {
            "type": "string"
          },
          "carrierName": {
            "type": "string"
          }
        }
      },
      "CircuitValidateCowRequest": {
        "type": "object",
        "required": [
          "cow"
        ],
        "properties": {
          "cow": {
            "type": "string"
          }
        }
      },
      "CircuitValidateCorRequest": {
        "type": "object",
        "required": [
          "cor",
          "cow"
        ],
        "properties": {
          "cor": {
            "type": "string"
          },
          "cow": {
            "type": "string"
          }
        }
      },
      "CircuitNewIpClassRequest": {
        "type": "object",
        "required": [
          "ipv6AdditionalId",
          "ipv4AdditionalId",
          "publicIpv6",
          "idCircuit",
          "organizationId"
        ],
        "properties": {
          "ipv6AdditionalId": {
            "type": "integer"
          },
          "ipv4AdditionalId": {
            "type": "integer"
          },
          "publicIpv6": {
            "type": "boolean"
          },
          "idCircuit": {
            "type": "integer"
          },
          "organizationId": {
            "type": "integer"
          }
        }
      },
      "CircuitChangeProfileRequest": {
        "type": "object",
        "required": [
          "profileId",
          "mcrId",
          "idCircuit",
          "organizationId"
        ],
        "properties": {
          "profileId": {
            "type": "integer"
          },
          "mcrId": {
            "type": "integer"
          },
          "idCircuit": {
            "type": "integer"
          },
          "organizationId": {
            "type": "integer"
          }
        }
      },
      "CircuitChangeSlaRequest": {
        "type": "object",
        "required": [
          "slaId",
          "idCircuit",
          "organizationId"
        ],
        "properties": {
          "slaId": {
            "type": "integer"
          },
          "idCircuit": {
            "type": "integer"
          },
          "organizationId": {
            "type": "integer"
          }
        }
      },
      "CircuitChangeStatusRequest": {
        "type": "object",
        "required": [
          "organizationId",
          "orderId",
          "statusId"
        ],
        "properties": {
          "organizationId": {
            "type": "integer"
          },
          "orderId": {
            "type": "integer"
          },
          "statusId": {
            "type": "integer"
          }
        }
      },
      "CircuitChangeAppointmentDateRequest": {
        "type": "object",
        "required": [
          "idCircuit",
          "organizationId",
          "appointmentDate"
        ],
        "properties": {
          "idCircuit": {
            "type": "integer"
          },
          "organizationId": {
            "type": "integer"
          },
          "appointmentDate": {
            "type": "string"
          }
        }
      },
      "CircuitChangeCompleteDateRequest": {
        "type": "object",
        "required": [
          "idCircuit",
          "organizationId",
          "completeDate"
        ],
        "properties": {
          "idCircuit": {
            "type": "integer"
          },
          "organizationId": {
            "type": "integer"
          },
          "completeDate": {
            "type": "string"
          }
        }
      },
      "CircuitDeleteIpClassRequest": {
        "type": "object",
        "required": [
          "idCircuit",
          "organizationId",
          "ipOrderCode",
          "ipClass"
        ],
        "properties": {
          "idCircuit": {
            "type": "integer"
          },
          "organizationId": {
            "type": "integer"
          },
          "ipOrderCode": {
            "type": "string"
          },
          "ipClass": {
            "type": "string"
          }
        }
      },
      "UpdateMainCustomerBranchesRequest": {
        "type": "object",
        "properties": {
          "secondaryCustomerIds": {
            "type": "array",
            "description": "ID delle anagrafiche da collegare alla sede principale. Obbligatorio e non vuoto per aggiungere branch; per replace, omesso, null o vuoto scollega tutte le branch, se consentito dalle regole multisede.",
            "items": {
              "type": "integer",
              "minimum": 1
            },
            "example": [
              102,
              103
            ]
          }
        }
      },
      "CustomerBranchesCheckResponse": {
        "type": "object",
        "properties": {
          "hasDuplicates": {
            "type": "boolean",
            "description": "Indica ID ripetuti nella richiesta."
          },
          "requestedCount": {
            "type": "integer",
            "description": "Numero di ID richiesti, inclusi i duplicati."
          },
          "uniqueCount": {
            "type": "integer",
            "description": "Numero di ID distinti."
          },
          "canProceed": {
            "type": "boolean",
            "description": "True quando incompatibleIds è vuoto; il controllo non modifica le anagrafiche."
          },
          "duplicateIds": {
            "type": "array",
            "description": "ID ripetuti nella richiesta.",
            "items": {
              "type": "integer"
            }
          },
          "alreadyLinkedToMainIds": {
            "type": "array",
            "description": "Già collegati alla sede indicata.",
            "items": {
              "type": "integer"
            }
          },
          "linkedToOtherMainIds": {
            "type": "array",
            "description": "Collegati a un’altra sede principale.",
            "items": {
              "type": "integer"
            }
          },
          "blockedByOwnBranchesIds": {
            "type": "array",
            "description": "Anagrafiche che hanno a loro volta branch.",
            "items": {
              "type": "integer"
            }
          },
          "sameAsMainIds": {
            "type": "array",
            "description": "ID coincidenti con la sede principale.",
            "items": {
              "type": "integer"
            }
          },
          "notVisibleIds": {
            "type": "array",
            "description": "Anagrafiche non trovate o non visibili.",
            "items": {
              "type": "integer"
            }
          },
          "readyToAssociateIds": {
            "type": "array",
            "description": "Anagrafiche senza sede principale pronte per il collegamento.",
            "items": {
              "type": "integer"
            }
          },
          "invalidLocationIds": {
            "type": "array",
            "description": "Tipo sede e collegamento incoerenti, con multisede abilitato.",
            "items": {
              "type": "integer"
            }
          },
          "vatMismatchIds": {
            "type": "array",
            "description": "Partita IVA diversa dalla sede principale, con multisede abilitato.",
            "items": {
              "type": "integer"
            }
          },
          "incompatibleIds": {
            "type": "array",
            "description": "Unione degli ID incompatibili, senza duplicati e ordinata.",
            "items": {
              "type": "integer"
            }
          }
        }
      },
      "UpdateMainCustomerRequest": {
        "type": "object",
        "properties": {
          "mainCustomerId": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "description": "ID della sede principale. Omesso o null rimuove il collegamento, se consentito dalle regole multisede.",
            "example": 101
          }
        }
      },
      "AddCustomerRequest": {
        "type": "object",
        "required": [
          "name",
          "ragioneSociale",
          "tel",
          "vatNumber",
          "indirizzo",
          "civico",
          "cap",
          "provincia",
          "comune",
          "regione",
          "indSedLeg",
          "civicoSedLeg",
          "capSedLeg",
          "provinciaSedLeg",
          "comuneSedLeg",
          "regioneSedLeg"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Nome del cliente"
          },
          "ragioneSociale": {
            "type": "string",
            "description": "Ragione sociale del cliente"
          },
          "tel": {
            "type": "string",
            "description": "Numero di telefono del cliente"
          },
          "vatNumber": {
            "type": "string",
            "description": "Partita IVA del cliente. I campi legacy `pIva` e `piva` sono accettati come alias in input."
          },
          "pIva": {
            "type": "string",
            "deprecated": true,
            "description": "Alias legacy di `vatNumber`. Utilizzare `vatNumber` per le nuove integrazioni."
          },
          "piva": {
            "type": "string",
            "deprecated": true,
            "description": "Alias legacy di `vatNumber`. Utilizzare `vatNumber` per le nuove integrazioni."
          },
          "indirizzo": {
            "type": "string",
            "description": "Indirizzo della sede operativa"
          },
          "civico": {
            "type": "string",
            "description": "Numero civico della sede operativa"
          },
          "country": {
            "type": "string",
            "description": "Nazionalità ISO code (IT, EN, ecc.)"
          },
          "cap": {
            "type": "string",
            "description": "CAP della sede operativa"
          },
          "provincia": {
            "type": "string",
            "description": "Provincia della sede operativa"
          },
          "comune": {
            "type": "string",
            "description": "Comune della sede operativa"
          },
          "regione": {
            "type": "string",
            "description": "Regione della sede operativa"
          },
          "indSedLeg": {
            "type": "string",
            "description": "Indirizzo della sede legale"
          },
          "civicoSedLeg": {
            "type": "string",
            "description": "Numero civico della sede legale"
          },
          "capSedLeg": {
            "type": "string",
            "description": "CAP della sede legale"
          },
          "provinciaSedLeg": {
            "type": "string",
            "description": "Provincia della sede legale"
          },
          "comuneSedLeg": {
            "type": "string",
            "description": "Comune della sede legale"
          },
          "regioneSedLeg": {
            "type": "string",
            "description": "Regione della sede legale"
          },
          "type": {
            "type": "string",
            "enum": [
              "HEADQUARTERS",
              "BRANCH"
            ],
            "default": "HEADQUARTERS",
            "description": "Per creare una nuova branch usare BRANCH e specificare mainCustomerId. Con multisede abilitato la partita IVA deve coincidere con quella della sede principale."
          },
          "mainCustomerId": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "description": "ID della sede principale nella stessa organizzazione. Richiesto per BRANCH con multisede abilitato; la sede principale non può essere una branch. Alias legacy in input mainCustomer."
          }
        }
      },
      "RegulatoryDatabaseInfo": {
        "type": "object",
        "required": [
          "anagraficaId",
          "holderAddress",
          "holderBirthDate",
          "holderBirthPlace",
          "holderCity",
          "holderCompanyName",
          "holderEmail",
          "holderGender",
          "holderIdIssuingAuthority",
          "holderIdNumber",
          "holderIdReleaseDate",
          "holderIdType",
          "holderName",
          "holderNationality",
          "holderPostalCode",
          "holderProvince",
          "holderStreetName",
          "holderStreetNumber",
          "holderSurname",
          "invoiceAddress",
          "invoiceCity",
          "invoiceCompanyName",
          "invoiceName",
          "invoiceNationality",
          "invoicePostalCode",
          "invoiceProvince",
          "invoiceStreetName",
          "invoiceStreetNumber",
          "invoiceSurname"
        ],
        "properties": {
          "id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "anagraficaId": {
            "type": "integer"
          },
          "holderAddress": {
            "type": "string"
          },
          "holderBirthDate": {
            "type": "string",
            "format": "date"
          },
          "holderBirthPlace": {
            "type": "string"
          },
          "holderCf": {
            "type": "string"
          },
          "holderCity": {
            "type": "string"
          },
          "holderCompanyName": {
            "type": "string"
          },
          "holderEmail": {
            "type": "string",
            "format": "email"
          },
          "holderGender": {
            "type": "string",
            "enum": [
              "M",
              "F"
            ]
          },
          "holderIdIssuingAuthority": {
            "type": "string"
          },
          "holderIdNumber": {
            "type": "string"
          },
          "holderIdReleaseDate": {
            "type": "string",
            "format": "date"
          },
          "holderIdType": {
            "type": "string",
            "enum": [
              "CI",
              "PG",
              "PS"
            ]
          },
          "holderName": {
            "type": "string",
            "description": "Nome dell'intestatario"
          },
          "holderNationality": {
            "type": "string"
          },
          "holderPostalCode": {
            "type": "string",
            "pattern": "^\\d{5}$"
          },
          "holderProvince": {
            "type": "string",
            "minLength": 2,
            "maxLength": 2
          },
          "holderStreetName": {
            "type": "string"
          },
          "holderStreetNumber": {
            "type": "string"
          },
          "holderSurname": {
            "type": "string"
          },
          "holderVat": {
            "type": "string",
            "pattern": "^\\d{11}$"
          },
          "invoiceAddress": {
            "type": "string"
          },
          "invoiceCity": {
            "type": "string"
          },
          "invoiceCompanyName": {
            "type": "string"
          },
          "invoiceName": {
            "type": "string"
          },
          "invoiceNationality": {
            "type": "string"
          },
          "invoicePostalCode": {
            "type": "string",
            "pattern": "^\\d{5}$"
          },
          "invoiceProvince": {
            "type": "string",
            "minLength": 2,
            "maxLength": 2
          },
          "invoiceStreetName": {
            "type": "string"
          },
          "invoiceStreetNumber": {
            "type": "string"
          },
          "invoiceSurname": {
            "type": "string"
          },
          "lastEdited": {
            "type": [
              "string",
              "null"
            ],
            "description": "Format: dd/MM/yyyy"
          },
          "customer": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Customer"
              },
              {
                "type": "null"
              }
            ]
          }
        }
      },
      "UpdateCustomerRequest": {
        "type": "object",
        "required": [
          "name",
          "ragioneSociale",
          "isActive",
          "piva",
          "tel"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Nome del cliente"
          },
          "ragioneSociale": {
            "type": "string",
            "description": "Ragione sociale del cliente"
          },
          "isActive": {
            "type": "string",
            "description": "Stato di attivazione (es. Yes/No)"
          },
          "piva": {
            "type": "string",
            "description": "Partita IVA o codice fiscale del cliente"
          },
          "country": {
            "type": "string",
            "description": "Nazionalità ISO code (IT, EN, ecc.)"
          },
          "tel": {
            "type": "string",
            "description": "Numero di telefono del cliente"
          }
        }
      },
      "UpdateCustomerAddressRequest": {
        "type": "object",
        "required": [
          "indirizzo",
          "civico",
          "indSedLeg",
          "comune",
          "provincia",
          "regione",
          "cap",
          "civicoSedLeg",
          "comuneSedLeg",
          "provinciaSedLeg",
          "regioneSedLeg",
          "capSedLeg"
        ],
        "properties": {
          "indirizzo": {
            "type": "string",
            "description": "Indirizzo della sede operativa"
          },
          "civico": {
            "type": "string",
            "description": "Numero civico della sede operativa"
          },
          "comune": {
            "type": "string",
            "description": "Comune della sede operativa"
          },
          "provincia": {
            "type": "string",
            "description": "Provincia della sede operativa"
          },
          "regione": {
            "type": "string",
            "description": "Regione della sede operativa"
          },
          "cap": {
            "type": "string",
            "description": "CAP della sede operativa"
          },
          "indSedLeg": {
            "type": "string",
            "description": "Indirizzo della sede legale"
          },
          "civicoSedLeg": {
            "type": "string",
            "description": "Numero civico della sede legale"
          },
          "comuneSedLeg": {
            "type": "string",
            "description": "Comune della sede legale"
          },
          "provinciaSedLeg": {
            "type": "string",
            "description": "Provincia della sede legale"
          },
          "regioneSedLeg": {
            "type": "string",
            "description": "Regione della sede legale"
          },
          "capSedLeg": {
            "type": "string",
            "description": "CAP della sede legale"
          }
        }
      }
    }
  }
}
