---
title: "Create URI monitoring configuration"
method: POST
path: "/v1/dem/uris"
tags: ["dem"]
---

# Create URI monitoring configuration

`POST /v1/dem/uris`

## Request body

- DemUri
  - `name` string, required — Name of the URI, which must be unique within the organization. The name must also not contain any control characters, any white space other than space (U+0020), or any consecutive, leading or trailing spaces.
  - `ipOrDomain` string, required — IP/domain of the URI.
  - `availabilityCheckSettings` DemUriAvailabilityCheckSettingsInput, required
    - `platformOptions` DemProbePlatformOptions
      - `probePlatforms` DemProbePlatform[], required — Cloud platforms hosting synthetic probes.
      - `testFromAll` boolean — Use this field to configure whether availability tests should be performed from all selected platforms or one randomly selected platform. It has no effect if you provided only one platform in the `probePlatforms` field. If set to true, a separate test is made from each of the selected platforms. If set to false, only one of the selected platforms is chosen every time. If omitted, the previous setting will stay in effect. If there is no previous setting, the value will default to false.
    - `testFrom` DemTestFrom
      - `type` 'REGION' | 'COUNTRY' | 'CITY', required
      - `values` string[], required — A list of probe location values of the selected type. At least one value matching an existing probe must be provided.
    - `testIntervalInSeconds` 60 | 300 | 600 | 900 | 1800 | 3600 | 7200 | 14400, required
    - `outageConfiguration` DemOutageConfiguration
      - `failingTestLocations` 'all' | 'any', required
      - `consecutiveForDown` integer, required — Number of consecutive failing tests for an entity to be considered down.
    - `dns` DemUriDnsSettings
      - `enabled` boolean, required — Enables or disables DNS tests for the URI. Exactly one test type (DNS, ping, TCP, or UDP) must be enabled for a URI.
      - `nameserver` string, required — Nameserver to be used for DNS queries. Can be an IP address or domain name.
      - `port` integer, nullable — Port number to be used for DNS queries.
      - `ipToExpect` string, required — Expected IP address in DNS response.
    - `ping` DemUriPingSettings
      - `enabled` boolean, required — Enables or disables ping tests for the URI. Exactly one test type (DNS, ping, TCP, or UDP) must be enabled for a URI.
    - `tcp` DemUriTcpSettings
      - `enabled` boolean, required — Enables or disables TCP tests for the URI. Exactly one test type (DNS, ping, TCP, or UDP) must be enabled for a URI.
      - `port` integer, required — Port number to be used in TCP tests.
      - `stringToSend` string, nullable — String to send in the body of a TCP request.
      - `stringToExpect` string, nullable — String to search for in the body of a TCP response.
    - `udp` DemUriUdpSettings
      - `enabled` boolean, required — Enables or disables UDP tests for the URI. Exactly one test type (DNS, ping, TCP, or UDP) must be enabled for a URI.
      - `port` integer, required — Port number to be used in UDP tests.
      - `stringToSend` string, required — String to send in the body of a UDP request.
      - `stringToExpect` string, required — String to search for in the body of a UDP response.
  - `tags` CommonTag[] — Tags associated with the URI for categorization.
    - `key` string, required — Tag key.
    - `value` string, required — Tag value.

## Response `201`

The request has succeeded and a new resource has been created as a result.

- CommonEntityId
  - `id` string, required — Resource identifier.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `500` — Server error

---

[API](https://skmtc.net/solarwinds/apis/solarwinds-observability.md) · [All operations](https://skmtc.net/solarwinds/apis/solarwinds-observability/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarwinds/solarwinds-observability/versions/994e5ca64961/schema)