> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexagon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# importGateway

> Creates or updates a Logical Gateway on the API Platform Server. It accepts a json file with the configuration of the Logical Gateway. See below for e

Creates or updates a Logical Gateway on the API Platform Server.  It accepts a json file with the configuration of the Logical Gateway.  See below for examples.

# Target Properties

<table><colgroup><col /><col /><col /><col /></colgroup><tbody><tr><th>**Property Name**</th><th>**Property Code**</th><th>**Required**</th><th>**Description**</th></tr><tr><td>Oracle API Platform Account</td><td>`FDOAP_CLOUD_ACCOUNT_CODE`</td><td>Yes</td><td>The Oracle API Platform cloud account to use for this operation. </td></tr></tbody></table>

# Inputs

<table><colgroup><col /><col /><col /><col /></colgroup><tbody><tr><th>**Input Name**</th><th>**Input Code**</th><th>**Required**</th><th>**Description**</th></tr><tr><td>Gateway File</td><td>`FDOAP_INP_GATEWAY_FILE`</td><td>Yes</td><td>Json file to use for gateway creation.  Can be absolute or relative to the artifacts directory.</td></tr><tr><td>Apply Node Grant</td><td>`FDOAP_INP_APPLY_NODE_GRANT`</td><td>Yes</td><td>Should the NodeServiceAccount grant be applied to this gateway?  This grant is needed to provision nodes against this Logical Gateway.</td></tr></tbody></table>

# Outputs

<table><colgroup><col /><col /></colgroup><tbody><tr><th>**Output Name**</th><th>**Description**</th></tr><tr><td>`FDOAP_OUT_GATEWAY_ID`</td><td>Logical Gateway Id after creation or updating.</td></tr></tbody></table>

# Artifacts

This operation consumes artifacts from the artifacts repository.

# Endpoint Selection

This operation will select all available endpoints associated to the Target.

# Endpoint Execution

This operation will execute on any one of the selected endpoints and will be random in the determination of which one.

# Special Considerations

## **Gateway File**

Below is a sample json file to create a Logical Gateway.  **The only required field is the 'name' field**

```
{
	"name": "Development",
	"description": "Development Gateway",
	"location": "http://example.com",
	"urls": [
        "http://example.com:8001",
        "http://my.example.com:8001",
        "https://example.com:8002"
    ],
    "proxyUrls":[
    	"http://proxy.com:8001"
    	],
    "firewall": {
        "maxUnboundedItems": "1024",
        "maxChildElementDepth": "1024",
        "maxItemValueLength": "102400",
        "maxMessageSize": "1024000"
    }
}
```