# AWS Direct Connect API

> AWS Direct Connect API on Apizie: 59 endpoints (Accepts a proposal request to attach a virtual private gateway or transit gateway to a Direct Connect gateway., Creates a hosted connection on the specified interconnect or a link aggregation group (LAG) of…, Provisions a private virtual interface to be owned by the specified Amazon Web Services account. Virtual…, Provisions a public virtual interface to be owned by the specified Amazon Web Services account. The owner of…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:amazonaws-directconnect/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-directconnect`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://apizie.tech/api/cloud/amazonaws-directconnect
- OpenAPI: https://apizie.tech/api/cloud/amazonaws-directconnect/openapi.json

Direct Connect links your internal network to an Direct Connect location over a standard Ethernet fiber-optic cable. One end of the cable is connected to your router, the other to an Direct Connect router. With this…

## Endpoints

### Accepts a proposal request to attach a virtual private gateway or transit gateway to a Direct Connect gateway.
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/accept-direct-connect-gateway-association-proposal` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a hosted connection on the specified interconnect or a link aggregation group (LAG) of…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/allocate-hosted-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Provisions a private virtual interface to be owned by the specified Amazon Web Services account. Virtual…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/allocate-private-virtual-interface` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Provisions a public virtual interface to be owned by the specified Amazon Web Services account. The owner of…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/allocate-public-virtual-interface` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Provisions a transit virtual interface to be owned by the specified Amazon Web Services account. Use this…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/allocate-transit-virtual-interface` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Associates an existing connection with a link aggregation group (LAG). The connection is interrupted and…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/associate-connection-with-lag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Associates a hosted connection and its virtual interfaces with a link aggregation group (LAG) or…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/associate-hosted-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Associates a MAC Security (MACsec) Connection Key Name (CKN)/ Connectivity Association Key (CAK) pair with…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/associate-mac-sec-key` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Associates a virtual interface with a specified link aggregation group (LAG) or connection. Connectivity to…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/associate-virtual-interface` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Confirms the creation of the specified hosted connection on an interconnect. Upon creation, the hosted…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/confirm-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### The confirmation of the terms of agreement when creating the connection/link aggregation group (LAG).
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/confirm-customer-agreement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Accepts ownership of a private virtual interface created by another Amazon Web Services account. After the…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/confirm-private-virtual-interface` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Accepts ownership of a public virtual interface created by another Amazon Web Services account. After the…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/confirm-public-virtual-interface` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Accepts ownership of a transit virtual interface created by another Amazon Web Services account. After the…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/confirm-transit-virtual-interface` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a BGP peer on the specified virtual interface. You must create a BGP peer for the corresponding…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/create-bgppeer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a connection between a customer network and a specific Direct Connect location. A connection links…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/create-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a Direct Connect gateway, which is an intermediate object that enables you to connect a set of…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/create-direct-connect-gateway` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates an association between a Direct Connect gateway and a virtual private gateway. The virtual private…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/create-direct-connect-gateway-association` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a proposal to associate the specified virtual private gateway or transit gateway with the specified…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/create-direct-connect-gateway-association-proposal` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates an interconnect between an Direct Connect Partner's network and a specific Direct Connect location.…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/create-interconnect` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a link aggregation group (LAG) with the specified number of bundled physical dedicated connections…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/create-lag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a private virtual interface. A virtual interface is the VLAN that transports Direct Connect traffic.…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/create-private-virtual-interface` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a public virtual interface. A virtual interface is the VLAN that transports Direct Connect traffic.…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/create-public-virtual-interface` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a transit virtual interface. A transit virtual interface should be used to access one or more…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/create-transit-virtual-interface` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes the specified BGP peer on the specified virtual interface with the specified customer address and…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/delete-bgppeer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes the specified connection. Deleting a connection only stops the Direct Connect port hour and data…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/delete-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes the specified Direct Connect gateway. You must first delete all virtual interfaces that are attached…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/delete-direct-connect-gateway` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes the association between the specified Direct Connect gateway and virtual private gateway. We…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/delete-direct-connect-gateway-association` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes the association proposal request between the specified Direct Connect gateway and virtual private…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/delete-direct-connect-gateway-association-proposal` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes the specified interconnect. Intended for use by Direct Connect Partners only.
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/delete-interconnect` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes the specified link aggregation group (LAG). You cannot delete a LAG if it has active virtual…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/delete-lag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes a virtual interface.
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/delete-virtual-interface` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Displays the specified connection or all connections in this Region.
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-connections` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Get and view a list of customer agreements, along with their signed status and whether the customer is an…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-customer-metadata` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |

### Describes one or more association proposals for connection between a virtual private gateway or transit…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-direct-connect-gateway-association-proposals` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists the associations between your Direct Connect gateways and virtual private gateways and transit…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-direct-connect-gateway-associations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists the attachments between your Direct Connect gateways and virtual interfaces. You must specify a Direct…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-direct-connect-gateway-attachments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists all your Direct Connect gateways or only the specified Direct Connect gateway. Deleted Direct Connect…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-direct-connect-gateways` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists the hosted connections that have been provisioned on the specified interconnect or link aggregation…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-hosted-connections` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists the interconnects owned by the Amazon Web Services account or only the specified interconnect.
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-interconnects` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Describes all your link aggregation groups (LAG) or the specified LAG.
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-lags` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Gets the LOA-CFA for a connection, interconnect, or link aggregation group (LAG). The Letter of…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-loa` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists the Direct Connect locations in the current Amazon Web Services Region. These are the locations that…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-locations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |

### Details about the router.
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-router-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Describes the tags associated with the specified Direct Connect resources.
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-tags` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists the virtual private gateways owned by the Amazon Web Services account. You can create one or more…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-virtual-gateways` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |

### Displays all virtual interfaces for an Amazon Web Services account. Virtual interfaces deleted fewer than 15…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/describe-virtual-interfaces` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Disassociates a connection from a link aggregation group (LAG). The connection is interrupted and…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/disassociate-connection-from-lag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Removes the association between a MAC Security (MACsec) security key and an Direct Connect dedicated…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/disassociate-mac-sec-key` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists the virtual interface failover test history.
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/list-virtual-interface-test-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Starts the virtual interface failover test that verifies your configuration meets your resiliency…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/start-bgp-failover-test` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Stops the virtual interface failover test.
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/stop-bgp-failover-test` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Adds the specified tags to the specified Direct Connect resource. Each resource can have a maximum of 50…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Removes one or more tags from the specified Direct Connect resource.
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates the Direct Connect dedicated connection configuration. You can update the following parameters for a…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/update-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates the name of a current Direct Connect gateway.
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/update-direct-connect-gateway` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates the specified attributes of the Direct Connect gateway association. Add or remove prefixes from the…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/update-direct-connect-gateway-association` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates the attributes of the specified link aggregation group (LAG). You can update the following LAG…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/update-lag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates the specified attributes of the specified virtual private interface. Setting the MTU of a virtual…
`POST https://apizie.tech/v1/cloud:amazonaws-directconnect/update-virtual-interface-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

## Example
```
curl "https://apizie.tech/v1/cloud:amazonaws-directconnect/accept-direct-connect-gateway-association-proposal" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AWS Direct Connect API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:amazonaws-directconnect/accept-direct-connect-gateway-association-proposal with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the AWS Direct Connect API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. AWS Direct Connect itself also needs your own key from amazonaws.com.

### Can AI agents use the AWS Direct Connect API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-directconnect.

### What is the status of the AWS Direct Connect API?
Needs your own provider key (bring your own key)