---
title: "Create URL validation request"
method: POST
path: "/validations/url"
tags: ["ValidateUrl"]
---

# Create URL validation request

`POST /validations/url`

Create URL validation request

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

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
- `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)