Web & Metadata · x402 V2

URL Discovery Audit

Use this service when you need this capability: performs a bounded deterministic audit of autonomous-agent and search discovery resources for a public HTTPS URL.

Price and endpoint

LivePOSTBase USDC

0.02 USDC per call

x402 V2 exact payment on Base mainnet (eip155:8453) using USDC. The HTTP 402 challenge confirms the exact requirements before an authorized payment.

POST https://signalharness.ai/api/agent/services/url_discovery_audit/invoke

Purpose

Performs a bounded deterministic audit of autonomous-agent and search discovery resources for a public HTTPS URL.

Documented public-source retrieval is bounded by the URL, byte, redirect, and timeout limits below. Source availability can affect execution; review the input schema and returned source metadata.

Inputs

Request fields and validation limits
FieldTypeRequiredLimits
urlstringRequiredPattern: ^https://; Minimum length 9; Maximum length 2048

Example request body

{
  "url": "https://example.com/"
}
View complete input schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "additionalProperties": false,
  "minProperties": 1,
  "maxProperties": 1,
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "pattern": "^https://",
      "minLength": 9,
      "maxLength": 2048
    }
  }
}

Realistic output shape

Illustrative output from the canonical adapter fixture and schema. It is not a completed paid execution or a current live observation.

{
  "url": "https://example.com/resource",
  "checks": [
    {
      "id": "example",
      "status": "pass",
      "detail": "example",
      "url": "https://example.com/resource"
    }
  ],
  "discoveredResourceUrls": [
    "example00"
  ],
  "summary": {
    "pass": 0,
    "warn": 0,
    "fail": 0
  }
}
View complete output schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "additionalProperties": false,
  "minProperties": 4,
  "maxProperties": 4,
  "required": [
    "url",
    "checks",
    "discoveredResourceUrls",
    "summary"
  ],
  "properties": {
    "url": {
      "type": "string",
      "minLength": 9,
      "maxLength": 2048
    },
    "checks": {
      "type": "array",
      "minItems": 1,
      "maxItems": 32,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "minProperties": 4,
        "maxProperties": 4,
        "required": [
          "id",
          "status",
          "detail",
          "url"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          },
          "status": {
            "type": "string",
            "enum": [
              "pass",
              "warn",
              "fail"
            ],
            "minLength": 4,
            "maxLength": 4
          },
          "detail": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "discoveredResourceUrls": {
      "type": "array",
      "minItems": 0,
      "maxItems": 16,
      "items": {
        "type": "string",
        "minLength": 9,
        "maxLength": 2048
      }
    },
    "summary": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 3,
      "maxProperties": 3,
      "required": [
        "pass",
        "warn",
        "fail"
      ],
      "properties": {
        "pass": {
          "type": "integer",
          "minimum": 0,
          "maximum": 32
        },
        "warn": {
          "type": "integer",
          "minimum": 0,
          "maximum": 32
        },
        "fail": {
          "type": "integer",
          "minimum": 0,
          "maximum": 32
        }
      }
    }
  }
}

Execution limits

  • MaxInputBytes: 4096
  • MaxOutputBytes: 262144
  • MaxConcurrentExecutions: 2
  • MaxArtifacts: 0
  • MaxArtifactBytes: 0
  • RateLimitPerMinute: 10
  • MaxFetchBytes: 1048576
  • MaxDecodedBytes: 1048576
  • FetchTimeoutMs: 10000
  • MaxRedirects: 3
  • MaxUrls: 16
  • MaxNodes: 25000

Timeout: 30000 ms. Full schemas are in OpenAPI.

Copyable unpaid request

This schema-valid request returns the canonical HTTP 402 challenge without executing the service. A payment-capable client validates the challenge, signs only with prior authority and budget, and retries the identical body.

curl -i -X POST https://signalharness.ai/api/agent/services/url_discovery_audit/invoke \
  -H "Content-Type: application/json" \
  --data '{"url":"https://example.com/"}'

Continue with the paid-call walkthrough →