List URL surface misclassification rules | aVenture

{
  "assetExtension": [
    "string"
  ],
  "newsArticleHost": [
    "string"
  ],
  "parkingHost": [
    "string"
  ],
  "route": [
    {
      "apiEndpoint": "string",
      "attemptedSurface": [
        "string"
      ],
      "cliCommand": "string",
      "correctSurface": "string",
      "deterministicUrlShape": "string",
      "exactPath": [
        "string"
      ],
      "hostSuffix": "string",
      "id": "string",
      "pathPrefix": [
        "string"
      ],
      "pathTemplate": [
        "string"
      ],
      "additionalGuidance": "string",
      "externalSocialPostPlatform": "linkedin",
      "requiredLastSegment": "string",
      "requiredSegment": "string"
    }
  ]
}

Returns URL shapes whose attempted write surface is deterministically wrong. Consumers route these before writing; news/press articles belong on News.newsUrlOriginal via news create, not EntityUrl.urlType=website.

Authentication

X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Response

assetExtensionlist of strings

Binary asset file extensions (no leading dot) — an asset is not a web page.

newsArticleHostlist of strings

Pure news/press-wire hosts. An article path on these is a news record, never a URL link; the outlet’s own root stays a valid website.

parkingHostlist of strings

Domain-marketplace / for-sale / parking hosts — the domain is unowned, never a URL.

routelist of objects

Deterministic URL path routes whose canonical surface is not the attempted write surface.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

406

Not Acceptable Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error

$	curl https://api.aventure.vc/v1/entities/urls/surface-misclassifications \
>	-H "X-Client-Secret: <apiKey>"