API Reference¶

TimedURL offers a developer-friendly REST API that enables programmatic management of expiring links. You can create, update, retrieve, and delete timed URLs, configure fallback destinations, set custom slugs — all via secure HTTP requests.

This documentation provides an interactive interface and technical reference for each endpoint, including required parameters, response formats, and authentication details.

Authentication¶

All requests to the TimedURL API must include an API key for authentication.

TimedURL uses X-API-Key header-based authentication. You must include your API key in each request:

curl -X GET https://api.timedurl.com/v1/timed-urls \
  -H "X-API-Key: your_api_key_here"

To obtain your API key:

1. Sign in to your account at https://timedurl.com.
2. Navigate to the API section from your dashboard.
3. Click "Create API Key" to generate a new key.

OpenAPI¶

You can use the interactive OpenAPI UI below to explore the TimedURL API.

OpenAPI Spec