{"uid":"cap_tBVxd7nppLZ9kS54TepMB","slug":"delx-url-encode-safe-e13571be","name":"Delx URL Encode Safe","description":"Percent-encode text for query components. Call when you build safe query values for agent URLs. Returns encoded text for $0.001 USDC via x402 on Base. No network, no keys, no retention; first-party local JSON only. Results are advisory; the caller owns budgets, auth, and production controls.","url":"https://api.delx.ai/api/v1/x402/url-encode-safe","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"text":{"type":"string","description":"Input field: text."}}},"responseSchema":{"type":"json","example":{"text":"hello%20delx%20%26%20agents","schema":"delx/util-url-encode-safe/v1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZIelBQHFgdPpMion0c_mu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Percent-encodes text using safe encoding rules for use as URL query component values, returning the encoded string","exampleAgentPrompt":"Percent-encode this string so it's safe to use as a URL query parameter value: 'hello world & welcome=yes'","exampleUseCases":[{"title":"Encoding user search query for URL","prompt":"I need to put the user's search term 'coffee shops near me & open now' into a URL query string — can you percent-encode it so it won't break the URL?"},{"title":"Preparing API redirect URI parameter","prompt":"Encode this redirect URI value 'https://myapp.com/callback?source=login' so I can safely embed it as a query parameter in another URL."},{"title":"Sanitizing dynamic agent-generated query values","prompt":"My agent is building a URL and needs to safely include this dynamic value as a query param: 'price range: $10–$50, size=large'. Can you percent-encode it?"}],"resultDescription":"Returns a percent-encoded version of the input text, with all characters that are unsafe in URL query components (spaces, ampersands, equals signs, special characters, etc.) replaced with their %XX hex equivalents. The result is a plain JSON object containing the encoded string, computed locally with no network calls or data retention.","failureModes":["Missing or empty 'text' field returns a validation error","Non-string input type may cause a 400 bad request","Payment failure via x402 protocol will prevent the call from completing","Extremely long input strings may be rejected due to size limits"],"whenToPreferThis":"Use this endpoint when you need query-component-safe percent-encoding specifically (as opposed to full URL encoding or path segment encoding). It is the right choice when building dynamic URLs in agent workflows where special characters in query values would break URL parsing. Prefer it over generic URL encoders when you need a lightweight, local, no-retention operation that is safe to call with sensitive query values and integrates with the x402 micropayment flow on Base. Choose the sibling 'Delx URL Encode' endpoint if you need decode support or full URL encoding rather than query-component-specific encoding.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:30.266Z","isFirstParty":false}