# x402-gateway Short Link Creator

> x402-gateway Short Link Creator is a paid API for AI agents from x402.freeq.one, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Creates a permanent or TTL-expiring short link on freeq.one with optional custom slug, returning the short URL and a one-time manage secret for stats and deletion

## Facts

- Endpoint: POST https://x402.freeq.one/tools/shortlink_create?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-gateway-short-link-creator-88abfdaf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sqankNP_OGNgoU1cSOrNU

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 x402-gateway-short-link-creator-88abfdaf -d '<json body>'
```

Example prompt: Shorten https://imapp.blogspot.com/2026/08/uuid-generator-free-uuid-v4-v7-creator.html into a short link on freeq.one with the custom slug 'uuid-tool' — make sure to save the manage secret it returns.

## When to prefer this

Choose this endpoint when you need to create a short, shareable link on the freeq.one domain, especially when you want a custom memorable slug, an automatically expiring TTL link, or access to a manage secret for later stats and deletion. It is paid per-call in USDC on Base via x402, making it suitable for agentic workflows that already handle x402 payments. Prefer it over generic URL shorteners when you need programmatic control over expiry and deletion without a separate account or API key.

## Known failure modes

- Invalid or malformed destination URL (non-http/https scheme) — returns 4xx validation error
- Custom slug already taken — returns conflict error
- Custom slug outside allowed character set or length (must be 3-40 chars, a-z0-9-) — returns validation error
- Malformed expires_at timestamp (not valid ISO 8601) — returns validation error
- Payment not completed or insufficient USDC balance — returns 402 Payment Required
- Network timeout reaching x402.freeq.one — returns 5xx or connection error

## How this service works

Short Link Creator: Create a permanent short link on freeq.one (e.g. https://freeq.one/MySlug). Optional: custom slug, expires_at (ISO date) for a TTL link that auto-expires — same price. Returns short_url plus a one-time manage_secret that gates FREE stats (GET /tools/shortlink_stats with X-Link-Secret) and FREE deletion of the link. Store the secret — it is shown only at creation. Pay per call in USDC on Base via x402 — POST https://x402.freeq.one/tools/shortlink_create.

## Output

Returns a JSON object containing the short_url (e.g. https://freeq.one/MySlug) and a one-time manage_secret string used to authenticate future stat lookups (GET /tools/shortlink_stats with X-Link-Secret) and link deletion. The manage secret is only shown once at creation and must be stored by the caller.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "example": "https://imapp.blogspot.com/2026/08/uuid-generator-free-uuid-v4-v7-creator.html",
   "description": "Destination URL to shorten (http/https)"
  },
  "slug": {
   "type": "string",
   "example": "uuid-tool",
   "description": "Optional custom slug (3-40 chars, a-z0-9-). Random if omitted."
  },
  "expires_at": {
   "type": "string",
   "example": "2027-01-01T00:00:00Z",
   "description": "Optional ISO 8601 expiry; link 404s after this time. Omit for a permanent link."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-gateway-short-link-creator-88abfdaf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.freeq.one](https://www.zero.xyz/host/x402.freeq.one/llms.txt)