---
title: "Upsert URL Validation Request"
method: PUT
path: "/validations/url/{id}"
tags: ["ValidateUrl"]
---

# Upsert URL Validation Request

`PUT /validations/url/{id}`

Upsert URL Validation Request

## Path parameters

- `id` string, required

## Headers

- `If-Match` string

## Request body

- ValidateUrl
  - `id` string — unique identifier
  - `workspace_id` string, required — Associated workspace
  - `status` 'error' | 'pending' | 'running' | 'success' — Validation status
  - `created_time` integer — Time at which the insight was created
  - `created_by_id` string — The ID of the user who created this insight
  - `last_updated_time` integer — time the insight was last updated
  - `last_updated_by_id` string — The ID of the user who last updated this insight
  - `target` object, required
    - `url` string, required
  - `validation_results` ValidateUrlResult[] — Results of validations
    - `valid` boolean
    - `error_code` 'CERT_HOSTNAME_MISMATCH' | 'HTTP_VERSION_UNSUPPORTED' | 'MALFORMED_URL' | 'METHOD_UNSUPPORTED' | 'NO_RESPONSE' | 'REDIRECT_LIMIT' | 'SERVER_ERROR' | 'SOCKET_EXCEPTION' | 'SSL_ERROR' | 'TIMEOUT' | 'TUNNEL_REFUSED' | 'UNKNOWN_HOST' | 'UNKNOWN' | 'UNREACHABLE' | 'BAD_REQUEST' — validation failure code

## Response `200`

Updated URL validation request

- ValidateUrl
  - `id` string — unique identifier
  - `workspace_id` string, required — Associated workspace
  - `status` 'error' | 'pending' | 'running' | 'success' — Validation status
  - `created_time` integer — Time at which the insight was created
  - `created_by_id` string — The ID of the user who created this insight
  - `last_updated_time` integer — time the insight was last updated
  - `last_updated_by_id` string — The ID of the user who last updated this insight
  - `target` object, required
    - `url` string, required
  - `validation_results` ValidateUrlResult[] — Results of validations
    - `valid` boolean
    - `error_code` 'CERT_HOSTNAME_MISMATCH' | 'HTTP_VERSION_UNSUPPORTED' | 'MALFORMED_URL' | 'METHOD_UNSUPPORTED' | 'NO_RESPONSE' | 'REDIRECT_LIMIT' | 'SERVER_ERROR' | 'SOCKET_EXCEPTION' | 'SSL_ERROR' | 'TIMEOUT' | 'TUNNEL_REFUSED' | 'UNKNOWN_HOST' | 'UNKNOWN' | 'UNREACHABLE' | 'BAD_REQUEST' — validation failure code

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — AsyncValidationRequest not found
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)