# Delx URL Encode Safe

> Delx URL Encode Safe is a paid API for AI agents from api.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Percent-encodes text using safe encoding rules for use as URL query component values, returning the encoded string

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/url-encode-safe
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-url-encode-safe-e13571be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tBVxd7nppLZ9kS54TepMB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability delx-url-encode-safe-e13571be -d '<json body>'
```

Example prompt: Percent-encode this string so it's safe to use as a URL query parameter value: 'hello world & welcome=yes'

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "description": "Input field: text."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "text": "hello%20delx%20%26%20agents",
  "schema": "delx/util-url-encode-safe/v1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-url-encode-safe-e13571be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.delx.ai](https://www.zero.xyz/host/api.delx.ai/llms.txt)
