Suggestions

Post a paid suggestion for the directory (F11)

Suggest a change, feature, bug, or data fix for the x402 List directory itself. The feedback channel is paid in x402: every suggestion costs a one-time $0.10 USDC (x402) payment on Base, as anti-spam skin-in-the-game. There is NO refund. Suggestions are internal and manually reviewed; they are never published and there is no public roadmap. This endpoint is agent-first (JSON only). The paid flow is the standard x402 handshake: the first call (no PAYMENT-SIGNATURE) returns HTTP 402 with a PAYMENT-REQUIRED header and an accepts[] body (single option, $0.10 USDC on Base) plus the app-level error code suggestion_fee_required; sign the payment and retry the same request with a PAYMENT-SIGNATURE header. On success the 201 carries a PAYMENT-RESPONSE header. When the payment layer is not configured, the endpoint answers HTTP 503 (suggestions temporarily unavailable).

post/suggestions

Request

Base URL: https://x402-list.com/api/v1
URL: https://x402-list.com/api/v1/suggestions
Auth: none declared

Request body

textstring required

The suggestion (1 to 2000 characters)

category'feature' | 'bug' | 'data' | 'other'

Suggestion category (defaults to "other" when omitted)

emailstring email

Optional contact email. Leave an email if you want a reply. A reply is not guaranteed.

Response

Suggestion received, pending manual review

Example response

{
  "provenance": {
    "attribution": "Data: x402-list.com (CC BY 4.0)",
    "cite_as": "https://x402-list.com/services/acme-generate",
    "source": "https://x402-list.com"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.