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.

​
Overview

Before a site can send a proxied request to an external API, that destination must be explicitly approved for that site. This allowlist keeps the proxy tightly scoped. A site can only send requests to exact hostnames you have approved.

​
Endpoints

MethodEndpointDescription
GET/api/v1/publish/:slug/proxy-hostsList approved hostnames
PUT/api/v1/publish/:slug/proxy-hostsAdd one or more approved hostnames
DELETE/api/v1/publish/:slug/proxy-hosts/:hostnameRemove an approved hostname

​
List Approved Hosts

GET /api/v1/publish/:slug/proxy-hosts

​
Example

curl -s https://simplehost.dev/api/v1/publish/bright-canvas-a7k2/proxy-hosts \
  -H "Authorization: Bearer sh_live_your_key_here"

​
Response

{
  "hosts": [
    {
      "hostname": "api.openai.com",
      "createdAt": "2026-03-31T10:20:00.000Z",
      "updatedAt": "2026-03-31T10:20:00.000Z"
    }
  ]
}

​
Add Approved Hosts

PUT /api/v1/publish/:slug/proxy-hosts

​
Example

curl -s -X PUT https://simplehost.dev/api/v1/publish/bright-canvas-a7k2/proxy-hosts \
  -H "Authorization: Bearer sh_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "hosts": ["api.openai.com", "api.stripe.com"]
  }'

​
Response

{
  "ok": true,
  "stored": [
    "api.openai.com",
    "api.stripe.com"
  ]
}

​
Remove Approved Host

DELETE /api/v1/publish/:slug/proxy-hosts/:hostname

​
Example

curl -s -X DELETE https://simplehost.dev/api/v1/publish/bright-canvas-a7k2/proxy-hosts/api.openai.com \
  -H "Authorization: Bearer sh_live_your_key_here"

​
Response

{
  "ok": true,
  "deleted": "api.openai.com"
}

​
Rules

  • Only exact hostnames are allowed
  • Only HTTPS destinations are supported
  • Use the narrowest possible set of hosts for each site
  • Do not add wildcard-style hostnames