---
title: "POST /v1/{+parent}/endpoints"
method: POST
path: "/v1/{+parent}/endpoints"
tags: ["projects"]
---

# POST /v1/{+parent}/endpoints

`POST /v1/{+parent}/endpoints`

Creates a new Endpoint in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `endpointId` string
- `requestId` string

## Request body

- Endpoint — Endpoint describes a single IDS endpoint. It defines a forwarding rule to which packets can be sent for IDS inspection.
  - `threatExceptions` string[] — List of threat IDs to be excepted from generating alerts.
  - `trafficLogs` boolean — Whether the endpoint should report traffic logs in addition to threat logs.
  - `satisfiesPzi` boolean — Output only. [Output Only] Reserved for future use.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'READY' | 'DELETING' | 'UPDATING' — Output only. Current state of the endpoint.
  - `updateTime` string, google-datetime — Output only. The update time timestamp.
  - `endpointForwardingRule` string — Output only. The fully qualified URL of the endpoint's ILB Forwarding Rule.
  - `labels` object — The labels of the endpoint.
  - `name` string — Output only. The name of the endpoint.
  - `description` string — User-provided description of the endpoint
  - `satisfiesPzs` boolean — Output only. [Output Only] Reserved for future use.
  - `severity` 'SEVERITY_UNSPECIFIED' | 'INFORMATIONAL' | 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL' — Required. Lowest threat severity that this endpoint will alert on.
  - `network` string — Required. The fully qualified URL of the network to which the IDS Endpoint is attached.
  - `createTime` string, google-datetime — Output only. The create time timestamp.
  - `endpointIp` string — Output only. The IP address of the IDS Endpoint's ILB.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/ids.md) · [All operations](https://skmtc.dev/google/apis/ids/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/ids/revisions/45c8927b5370/schema)