# Add ICX Switch

Add an ICX switch. Use activity API with request id to get the status update.

Endpoint: POST /venues/{venueId}/switches/{switchId}
Version: 0.4.0
Security: jwtAuth

## Path parameters:

  - `venueId` (string, required)

  - `switchId` (string, required)

## Request fields (application/json):

  - `id` (string)

  - `name` (string)
    The name assigned to the ICX switch for identification in the network.

  - `description` (string)
    The descriptive text providing additional information about the switch configuration or purpose.

  - `enableStack` (boolean)
    The flag indicating whether switch stacking is enabled for combining multiple physical switches into a single logical unit.

  - `igmpSnooping` (string)
    The IGMP snooping mode for multicast traffic optimization: enabled, disabled, or default.
    Enum: "active", "passive", "none"

  - `jumboMode` (boolean)
    The flag indicating whether jumbo frame support is enabled, allowing frames larger than 1518 bytes.

  - `spanningTreePriority` (integer)
    The STP (Spanning Tree Protocol) bridge priority value, used in root bridge election (lower values have higher priority).

  - `StackMembers_V1_1` (array)
    The list of member switches in a stack configuration, including their models and active status.

  - `StackMembers_V1_1.id` (string)

  - `StackMembers_V1_1.model` (string)
    The model identifier of the ICX switch in the stack.

  - `ipAddressInterfaceType` (string)
    The interface type for the switch management IP address: VLAN interface or management port.
    Enum: "NONE", "PORT", "VE", "MANAGEMENT"

  - `ipAddressInterface` (string)
    The specific interface identifier for the management IP address configuration.

  - `ipAddressType` (string)
    The IP address assignment method: static or DHCP.
    Enum: "static", "dynamic"

  - `ipAddress` (string)
    The IPv4 address assigned to the switch management interface.

  - `subnetMask` (string)
    The subnet mask for the switch management IP address.

  - `defaultGateway` (string)
    The default gateway IP address for routing traffic from the switch management interface.

  - `dhcpClientEnabled` (boolean)
    The flag indicating whether the switch is configured as a DHCP client to obtain its management IP address.

  - `dhcpServerEnabled` (boolean)
    The flag indicating whether the DHCP server feature is enabled on the switch.

  - `dhcp6ServerEnabled` (boolean)
    The flag indicating whether the DHCPv6 server feature is enabled on the switch.

  - `initialVlanId` (integer)
    The VLAN ID used for initial switch configuration and management access.

  - `specifiedType` (string)
    The firmware image type specified for the switch: primary, secondary, or boot.
    Enum: "AUTO", "SWITCH", "ROUTER"

  - `rearModule` (string)
    The model identifier of the rear expansion module installed on the switch, if applicable.

  - `vlanCustomize` (boolean)
    The flag indicating whether VLAN configurations have been customized from default settings.

  - `configBackupNaming` (object)
    Configuration backup file naming settings for this switch.

  - `configBackupNaming.format` (string)
    The naming format for configuration backup files.
    Enum: "DEFAULT", "SWITCH_NAME_AND_DATE", "SWITCH_NAME_AND_SERIAL_NUMBER_AND_DATE", "CUSTOM_TAG"

  - `configBackupNaming.prefix` (string)
    Optional prefix to prepend to the backup file name.

  - `configBackupNaming.suffix` (string)
    Optional suffix to append to the backup file name.

## Response 202 fields (application/json):

  - `requestId` (string)
    The unique identifier for tracking this API operation request.

  - `response` (object)
    The response data containing the result of the operation.

  - `response.id` (string)

## Response 400 fields (application/json):

  - `requestId` (string)
    The unique identifier for tracking this request.

  - `errors` (array)
    The list of error messages.

  - `errors.code` (string)
    Error code identifying the type of error (e.g., 'VALIDATION_ERROR', 'RESOURCE_NOT_FOUND').

  - `errors.message` (string)
    Human-readable error message describing what went wrong.

  - `errors.reason` (string)
    Detailed reason explaining why the error occurred.

  - `errors.suggestion` (string)
    Suggested action or solution to resolve the error.

  - `errors.object` (string)
    Name of the object or field that caused the error (e.g., 'username', 'ipAddress').

  - `errors.value` (any)
    The actual value that caused the error or validation failure.

  - `downloadUrl` (string)
    The download url of the import file.