# Dropto Sites API

**Canonical:** https://apis.io/apis/dropto-run/dropto-run-sites-api/  
**Provider:** Dropto — https://apis.io/providers/dropto-run/  
**Base URL:** https://dropto.run  
**Documentation:** https://dropto.run/docs/api

Dropto Sites API is one of 13 APIs that [Dropto](https://apis.io/providers/dropto-run/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Sites. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

A site, its address, and everything that is true of it rather than of one publish: the subdomain, custom domains and their certificates, a password, an expiry date, and the traffic figures — which identify nobody.

## Operations (39)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/sites` | Lists one page of the signed-in user's sites, newest first or in the order… |
| POST | `/api/sites` | Creates an empty site, either with the caller's own subdomain or a generated one |
| POST | `/api/sites/claim` | Attaches anonymous sites to the signed-in user |
| GET | `/api/sites/subdomain-availability` | Tells the caller whether a subdomain could be used, without reserving it |
| DELETE | `/api/sites/{siteId}` | Takes a site offline and reserves its subdomain permanently |
| GET | `/api/sites/{siteId}` | Reads one site and its recent deploys |
| PATCH | `/api/sites/{siteId}` | Changes a site's serving settings and pushes them to the edge |
| GET | `/api/sites/{siteId}/domains` | Reads a site's custom domains and what each still needs |
| POST | `/api/sites/{siteId}/domains` | Claims a hostname the customer owns and returns the DNS records to add |
| DELETE | `/api/sites/{siteId}/domains/{domainId}` | Stops serving a site on a hostname and releases it |
| POST | `/api/sites/{siteId}/domains/{domainId}/recheck` | Asks the provider about a pending domain now instead of waiting for the backoff |
| GET | `/api/sites/{siteId}/env` | Lists the variables a site's functions read: names and the last four characters… |
| DELETE | `/api/sites/{siteId}/env/{name}` | Removes a variable from the site's functions, sealed value and all |
| PUT | `/api/sites/{siteId}/env/{name}` | Sets a variable the site's functions read; the value is sealed on arrival and… |
| GET | `/api/sites/{siteId}/feedback` | Reads one page of the comments left on a site's pages, newest first, with the… |
| GET | `/api/sites/{siteId}/feedback/blocked` | Lists who is blocked from commenting on a site, most recent first, fifty at a… |
| POST | `/api/sites/{siteId}/feedback/blocked` | Blocks whoever wrote a comment from commenting on the site, optionally deleting… |
| DELETE | `/api/sites/{siteId}/feedback/blocked/{userId}` | Lets a blocked person comment on the site again |
| GET | `/api/sites/{siteId}/feedback/threads` | Reads a site's comment threads whole, with where each sits on its page and a… |
| POST | `/api/sites/{siteId}/feedback/threads/{threadId}/comments` | Answers a comment thread as the site's owner, and resolves it too when asked |
| POST | `/api/sites/{siteId}/feedback/threads/{threadId}/reopen` | Reopens a resolved comment thread as the site's owner |
| POST | `/api/sites/{siteId}/feedback/threads/{threadId}/resolve` | Resolves a comment thread as the site's owner |
| GET | `/api/sites/{siteId}/forms` | Lists the forms a site has collected, and the account's month |
| GET | `/api/sites/{siteId}/forms/{formName}/submissions` | Reads one page of a form's submissions, newest first |
| POST | `/api/sites/{siteId}/pause` | Takes a site off the air without deleting it, keeping its files and subdomain |
| POST | `/api/sites/{siteId}/resume` | Puts a paused site back on the air, if the plan still has room for it |
| POST | `/api/sites/{siteId}/subdomain` | Moves a site to a new subdomain; the old one keeps redirecting to it |
| GET | `/api/sites/{siteId}/traffic/overview` | Reads one site's traffic tiles, chart and status split for a range, audience… |
| GET | `/api/sites/{siteId}/traffic/top` | Reads one of a site's traffic lists: top pages, referrers, countries or broken… |
| GET | `/api/sites/{siteId}/upstreams` | Lists the origins a site proxies /api/* to, with header names and the last four… |
| POST | `/api/sites/{siteId}/upstreams` | Declares an origin the site may proxy /api/* to, with headers whose values are… |
| GET | `/api/sites/{siteId}/upstreams/log` | Lists the site's latest proxied requests, newest first: method, path without… |
| DELETE | `/api/sites/{siteId}/upstreams/{upstreamId}` | Stops the site proxying to an origin and drops its sealed headers |
| PATCH | `/api/sites/{siteId}/upstreams/{upstreamId}` | Changes the methods an upstream is open to, sets header values, or removes… |
| DELETE | `/api/sites/{siteId}/viewers` | Takes one address off a site's list and ends that person's access within a… |
| GET | `/api/sites/{siteId}/viewers` | Reads one page of the people a site is shared with, and whether each has opened… |
| PATCH | `/api/sites/{siteId}/viewers` | Changes what one person on a site's list may do — view it, or also comment on it |
| POST | `/api/sites/{siteId}/viewers` | Puts addresses on the list of people who may see a site — all of them, or none… |
| POST | `/api/sites/{siteId}/viewers/resend` | Mails one person on a site's list again — at most once a day per address |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/dropto-run/openapi/dropto-run-sites-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/dropto-run/json-schema/dropto-run-site-detail-schema.json
- **JSONSchema** — https://artifacts.apis.io/dropto-run/json-schema/dropto-run-update-site-settings-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/dropto-run/json-schema/dropto-run-site-domain-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/dropto-run/json-schema/dropto-run-me-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/dropto-run/json-schema/dropto-run-site-traffic-overview-schema.json
- **JSONSchema** — https://artifacts.apis.io/dropto-run/json-schema/dropto-run-site-settings-response-schema.json

## Other Dropto APIs (12)

- [Dropto Abuse API](https://apis.io/apis/dropto-run/dropto-run-abuse-api/)
- [Dropto Account API](https://apis.io/apis/dropto-run/dropto-run-account-api/)
- [Dropto Announcements API](https://apis.io/apis/dropto-run/dropto-run-announcements-api/)
- [Dropto Auth API](https://apis.io/apis/dropto-run/dropto-run-auth-api/)
- [Dropto Billing API](https://apis.io/apis/dropto-run/dropto-run-billing-api/)
- [Dropto Deploys API](https://apis.io/apis/dropto-run/dropto-run-deploys-api/)
- [Dropto Health API](https://apis.io/apis/dropto-run/dropto-run-health-api/)
- [Dropto Plans API](https://apis.io/apis/dropto-run/dropto-run-plans-api/)
- [Dropto Promotions API](https://apis.io/apis/dropto-run/dropto-run-promotions-api/)
- [Dropto Site folders API](https://apis.io/apis/dropto-run/dropto-run-site-folders-api/)
- [Dropto Support API](https://apis.io/apis/dropto-run/dropto-run-support-api/)
- [Dropto Tokens API](https://apis.io/apis/dropto-run/dropto-run-tokens-api/)

## Tags

Sites

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/dropto-run/dropto-run-sites-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/dropto-run/.