Create Device Managed Network

Create a new Device Managed Network.

Request

Path Params

identifier

string

required

Body Params application/json

config

schemas-config_request

required

The configuration object containing information for the WARP client to detect the managed network.

One of

tls_config_request

Example:

{"sha256":"b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c","tls_sockaddr":"foo.bar:1234"}

sha256

string

optional

The SHA-256 hash of the TLS certificate presented by the host found at tls_sockaddr. If absent, regular certificate verification (trusted roots, valid timestamp, etc) will be used to validate the certificate.

Example:

b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c

tls_sockaddr

string

required

A network address of the form "host:port" that the WARP client will use to detect the presence of a TLS host.

Example:

foobar:1234

name

string

required

The name of the Device Managed Network. Must be unique.

Example:

managed-network-1

type

enum<string>

required

The type of Device Managed Network.

Allowed value:

tls

Example:

tls

Example

{
    "config": {
        "sha256": "b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c",
        "tls_sockaddr": "foo.bar:1234"
    },
    "name": "managed-network-1",
    "type": "tls"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Create Device Managed Network response

application/json

Body

allOf {2}

optional

object (api-response-single)

optional

errors

array [object {2}]

messages

required

Example:

[]

messages

array [object {2}]

messages

required

Example:

[]

result

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

object

optional

result

object (device-managed-networks)

optional

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "config": {
            "sha256": "b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c",
            "tls_sockaddr": "foo.bar:1234"
        },
        "name": "managed-network-1",
        "network_id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
        "type": "tls"
    },
    "success": true
}

🟢200Create Device Managed Network response failure