---
title: "Update URI monitoring configuration"
method: PUT
path: "/v1/dem/uris/{entityId}"
tags: ["dem"]
---

# Update URI monitoring configuration

`PUT /v1/dem/uris/{entityId}`

## Path parameters

- `entityId` string, required

## 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 `200`

The request has succeeded.

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

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `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)