IP Policies

Create IP Policy

Create a new IP policy. It will not apply to any traffic until you associate to a traffic source via an endpoint configuration or IP restriction.

Request

POST /ip_policies

Example Request

curl \
-X POST \
-H "Authorization: Bearer {API_KEY}" \
-H "Content-Type: application/json" \
-H "Ngrok-Version: 2" \
-d '{"description":"API Outbound Gateway"}' \
https://api.ngrok.com/ip_policies

Parameters

Name	Type	Description
description	string	human-readable description of the source IPs of this IP policy. optional, max 255 bytes.
metadata	string	arbitrary user-defined machine-readable data of this IP policy. optional, max 4096 bytes.

Response

Returns a 201 response on success

Example Response

{
	"created_at": "2024-08-02T07:15:16Z",
	"description": "API Outbound Gateway",
	"id": "ipp_2k5ohQoBpUhYPpcTU67wU7hMJ5k",
	"uri": "https://api.ngrok.com/ip_policies/ipp_2k5ohQoBpUhYPpcTU67wU7hMJ5k"
}

Fields

Name	Type	Description
id	string	unique identifier for this IP policy
uri	string	URI of the IP Policy API resource
created_at	string	timestamp when the IP policy was created, RFC 3339 format
description	string	human-readable description of the source IPs of this IP policy. optional, max 255 bytes.
metadata	string	arbitrary user-defined machine-readable data of this IP policy. optional, max 4096 bytes.

Delete IP Policy

Delete an IP policy. If the IP policy is referenced by another object for the purposes of traffic restriction it will be treated as if the IP policy remains but has zero rules.

Request

DELETE /ip_policies/{id}

Example Request

curl \
-X DELETE \
-H "Authorization: Bearer {API_KEY}" \
-H "Ngrok-Version: 2" \
https://api.ngrok.com/ip_policies/ipp_2k5ohQoBpUhYPpcTU67wU7hMJ5k

Response

Returns a 204 response with no body on success

Get IP Policy

Get detailed information about an IP policy by ID.

Request

GET /ip_policies/{id}

Example Request

curl \
-X GET \
-H "Authorization: Bearer {API_KEY}" \
-H "Ngrok-Version: 2" \
https://api.ngrok.com/ip_policies/ipp_2k5ohQoBpUhYPpcTU67wU7hMJ5k

Response

Returns a 200 response on success

Example Response

{
	"created_at": "2024-08-02T07:15:16Z",
	"description": "API Outbound Gateway",
	"id": "ipp_2k5ohQoBpUhYPpcTU67wU7hMJ5k",
	"metadata": "metadata={\"pod-id\": \"b3d9c464-4f48-4783-a741-d7d7d5db310f\"}",
	"uri": "https://api.ngrok.com/ip_policies/ipp_2k5ohQoBpUhYPpcTU67wU7hMJ5k"
}

Fields

Name	Type	Description
id	string	unique identifier for this IP policy
uri	string	URI of the IP Policy API resource
created_at	string	timestamp when the IP policy was created, RFC 3339 format
description	string	human-readable description of the source IPs of this IP policy. optional, max 255 bytes.
metadata	string	arbitrary user-defined machine-readable data of this IP policy. optional, max 4096 bytes.

List IP Policies

List all IP policies on this account

Request

GET /ip_policies

Example Request

curl \
-X GET \
-H "Authorization: Bearer {API_KEY}" \
-H "Ngrok-Version: 2" \
https://api.ngrok.com/ip_policies

Response

Returns a 200 response on success

Example Response

{
	"ip_policies": [
		{
			"created_at": "2024-08-02T07:15:16Z",
			"description": "API Outbound Gateway",
			"id": "ipp_2k5ohQoBpUhYPpcTU67wU7hMJ5k",
			"uri": "https://api.ngrok.com/ip_policies/ipp_2k5ohQoBpUhYPpcTU67wU7hMJ5k"
		},
		{
			"created_at": "2024-08-02T07:15:16Z",
			"description": "Developer Environments",
			"id": "ipp_2k5ohOs6reP0txdCppjAsd7w8rT",
			"uri": "https://api.ngrok.com/ip_policies/ipp_2k5ohOs6reP0txdCppjAsd7w8rT"
		}
	],
	"next_page_uri": null,
	"uri": "https://api.ngrok.com/ip_policies"
}

Fields

Name	Type	Description
ip_policies	IPPolicy	the list of all IP policies on this account
uri	string	URI of the IP policy list API resource
next_page_uri	string	URI of the next page, or null if there is no next page

IPPolicy fields

Name	Type	Description
id	string	unique identifier for this IP policy
uri	string	URI of the IP Policy API resource
created_at	string	timestamp when the IP policy was created, RFC 3339 format
description	string	human-readable description of the source IPs of this IP policy. optional, max 255 bytes.
metadata	string	arbitrary user-defined machine-readable data of this IP policy. optional, max 4096 bytes.

Update IP Policy

Update attributes of an IP policy by ID

Request

PATCH /ip_policies/{id}

Example Request

curl \
-X PATCH \
-H "Authorization: Bearer {API_KEY}" \
-H "Content-Type: application/json" \
-H "Ngrok-Version: 2" \
-d '{"metadata":"metadata={\"pod-id\": \"b3d9c464-4f48-4783-a741-d7d7d5db310f\"}"}' \
https://api.ngrok.com/ip_policies/ipp_2k5ohQoBpUhYPpcTU67wU7hMJ5k

Parameters

Name	Type	Description
id	string
description	string	human-readable description of the source IPs of this IP policy. optional, max 255 bytes.
metadata	string	arbitrary user-defined machine-readable data of this IP policy. optional, max 4096 bytes.

Response

Returns a 200 response on success

Example Response

{
	"created_at": "2024-08-02T07:15:16Z",
	"description": "API Outbound Gateway",
	"id": "ipp_2k5ohQoBpUhYPpcTU67wU7hMJ5k",
	"metadata": "metadata={\"pod-id\": \"b3d9c464-4f48-4783-a741-d7d7d5db310f\"}",
	"uri": "https://api.ngrok.com/ip_policies/ipp_2k5ohQoBpUhYPpcTU67wU7hMJ5k"
}

Fields

Name	Type	Description
id	string	unique identifier for this IP policy
uri	string	URI of the IP Policy API resource
created_at	string	timestamp when the IP policy was created, RFC 3339 format
description	string	human-readable description of the source IPs of this IP policy. optional, max 255 bytes.
metadata	string	arbitrary user-defined machine-readable data of this IP policy. optional, max 4096 bytes.