Getting Started

Welcome to EdgeURL developer documentation. Three entry points -- pick the one that matches what you're building.

REST API

Session + sk_* API keys. For your own apps and integrations.

AI-Agent API

Scoped ai_* tokens for AI agents acting on behalf of users.

Webhooks

Event-driven notifications when links are created, updated, deleted, or clicked.

1. Get Your API Key

Create an API key from Dashboard > Settings > API Keys. Requires a Pro plan or higher. Keys are prefixed with sk_.

export EDGEURL_API_KEY=sk_your_api_key_here

2. Make Your First Request

Create a short link programmatically:

curl -X POST https://edgeurl.io/api/links \ -H "Authorization: Bearer $EDGEURL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/my-long-url", "slug": "my-link" }'

Full endpoint list, rate limits, and error codes in the REST API Reference.

3. Listen for Events (Optional)

Subscribe to webhook events to react in real time when links are created, updated, deleted, or clicked. Configure delivery targets from your Webhooks dashboard.

Full event schema and signature verification in the Webhooks guide.