---
title: "Perform an action on multi-cloud network resources (enable/disable)."
method: POST
path: "/v1/multi-cloud-networks/actions"
tags: ["Network"]
---

# Perform an action on multi-cloud network resources (enable/disable).

`POST /v1/multi-cloud-networks/actions`

## Request

- Base URL: `https://api.emma.ms/external`
- URL: `https://api.emma.ms/external/v1/multi-cloud-networks/actions`
- Auth: HTTP bearer

Performs an action (enable/disable) over networks, network cloud connections, and cross-region connections.

## Query parameters

- `projectId` integer

## Request body

- union
  - McnDirectNetworkEnable: Enable a Direct Connect network in a macro region.
    - `networkType` 'direct-connect', required: Network connectivity type. Only Direct Connect is supported here.
    - `macroRegion` 'emea' | 'amer' | 'apac', required: Macro region that identifies the target network.
    - `connectivityCenterId` integer, required: Connectivity Center identifier (city) selected when the network is created. Required for enabling a network.
    - `action` 'enable-network', required: Action to apply to the target resource.
  - McnDirectNetworkDisable: Disable a Direct Connect network in a macro region.
    - `networkType` 'direct-connect', required: Network connectivity type for this request. Only Direct Connect is supported here.
    - `macroRegion` 'emea' | 'amer' | 'apac', required: Macro region that identifies the target network.
    - `action` 'disable-network', required: Action to apply to the target resource.
  - McnDirectCloudConnectAction: Enable or disable a cloud connection within a Direct Connect network for a macro region.
    - `networkType` 'direct-connect', required: Network connectivity type for this request. Only Direct Connect is supported here.
    - `macroRegion` 'emea' | 'amer' | 'apac', required: Macro region that identifies the parent network containing the cloud connection.
    - `cloudConnectionProvider` 'aws' | 'gcp' | 'azure', required: Cloud provider of the cloud connection to be enabled or disabled.
    - `action` 'enable-cloud-connect' | 'disable-cloud-connect', required: Action to apply to the target resource.
  - McnDirectCrossConnectAction: Enable or disable a cross-region connection between two macro regions for Direct Connect.
    - `networkType` 'direct-connect', required: Network connectivity type for this request. Only Direct Connect is supported here.
    - `macroRegions` string[], required: Exactly two macro regions that form the cross-region connection to be enabled or disabled.
    - `action` 'enable-cross-region-connect' | 'disable-cross-region-connect', required: Action to apply to the target resource.

## Response `200`

Successful operation

- MultiCloudNetwork[]
  - `directConnect` object: Multi-cloud network with direct connection
    - `networks` object[]: Network within macro region (AMER, EMEA, or APAC).
      - `id` string: Network ID
      - `macroRegion` 'emea' | 'amer' | 'apac': Macro region of the network
      - `connectivityCenter` object: Connectivity center where the connection point is located.
        - `id` integer: Connectivity center ID
        - `name` string: Connectivity center location
      - `bandwidth` object: Bandwidth and rate limit configuration for the network.
        - `rateLimit` number: Maximum allowed throughput for the connection.
        - `unit` 'Mbps' | 'Gbps': Unit for rateLimit.
      - `cost` object: Pricing information for the network connection.
        - `unit` 'MONTH' | 'YEAR': Billing period for the price.
        - `currency` string: Currency code
        - `price` number: Price for the given billing unit.
      - `status` 'enabled' | 'disabled' | 'enabling' | 'disabling': Operational status of the network.
      - `cloudConnects` object[]: Cloud provider connections available from this Direct Connect network.
        - `id` string: Unique identifier of the cloud connection.
        - `provider` object: Cloud provider for this connection.
          - `id` integer: Numeric identifier of the cloud provider.
          - `name` string: Cloud provider name.
        - `bandwidth` object: Bandwidth and rate limit configuration for the cloud connection.
          - `rateLimit` integer: Maximum allowed throughput for the cloud connection.
          - `unit` 'Mbps' | 'Gbps': Unit for rateLimit.
        - `cost` object: Pricing information for the cloud connection.
          - `unit` string: Billing period for the price.
          - `currency` string: Currency code
          - `price` number: Price for the given billing unit.
        - `status` 'enabled' | 'disabled' | 'enabling' | 'disabling': Operational status of the cloud connection.
    - `crossRegionConnects` object[]: Cross-region links between networks in different macro regions.
      - `id` string: Unique identifier of the cross-region connection.
      - `networks` object[]: Network endpoints participating in the cross-region connection.
        - `id` string: Network ID.
        - `macroRegion` 'emea' | 'amer' | 'apac': Macro region of the referenced network (AMER, EMEA, or APAC).
      - `bandwidth` object: Bandwidth and rate limit configuration for the cross-region connection.
        - `rateLimit` integer: Maximum allowed throughput for the cross-region connection.
        - `unit` 'Mbps' | 'Gbps': Unit for rateLimit.
      - `cost` object: Pricing information for the cross-region connection.
        - `unit` string: Billing period for the price.
        - `currency` string: Currency code
        - `price` number: Price for the given billing unit.
      - `status` 'enabled' | 'disabled': Operational status of the cross-region connection.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal server error

---

[API](https://skmtc.dev/emma/apis/public-emma-api.md) - [All operations](https://skmtc.dev/emma/apis/public-emma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/emma/apis/public-emma-api/revisions/9e55f0920078?raw)