Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.simplehost.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
What is a Handle?

A handle gives you a personalized URL at yourname.simplehost.dev. It’s like a username for your SimpleHost profile.
Handles are available on the Hobby plan ($5/mo) only.

​
Setting Your Handle

​
From the dashboard

  1. Go to simplehost.dev/dashboard
  2. Click the Handle tab
  3. Enter your desired handle
  4. Click Save Changes

​
Handle Rules

  • 3-30 characters long
  • Lowercase letters, numbers, and hyphens only
  • Cannot start or end with a hyphen
  • Must be unique across all users
  • Reserved names (www, api, app, admin, etc.) are not allowed
  • Can be changed at any time (your old handle is released immediately)

​
Using Your Handle

Once set, your handle URL (yourname.simplehost.dev) is active. You can configure what it points to in the dashboard.

​
Managing from the Terminal

You can manage your handle entirely from the terminal — no dashboard required.

​
Get your current handle

curl -X GET https://simplehost.dev/api/v1/handle \
  -H "Authorization: Bearer sh_live_your_key_here"

​
Claim or change your handle

curl -X PUT https://simplehost.dev/api/v1/handle \
  -H "Authorization: Bearer sh_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"handle": "yourname"}'

​
Release your handle

curl -X DELETE https://simplehost.dev/api/v1/handle \
  -H "Authorization: Bearer sh_live_your_key_here"
Releasing your handle also removes all links associated with it. This cannot be undone.
See the Handle API reference for full request/response details.