# Dropto Deploys API

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

Dropto Deploys 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 Deploys. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

One publish, from asking for upload addresses to putting a version live. Versions are immutable and are never written over, so promoting an earlier one is a pointer moving rather than an upload repeating.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/sites/{siteId}/deploys/prepare` | Validates a manifest and returns one presigned upload URL per file |
| GET | `/api/sites/{siteId}/deploys/{deployId}` | Reads the state of one deploy |
| POST | `/api/sites/{siteId}/deploys/{deployId}/complete` | Verifies the uploaded files and takes the deploy live |
| GET | `/api/sites/{siteId}/deploys/{deployId}/file` | Reads one text file out of one deploy, for the in-browser editor |
| GET | `/api/sites/{siteId}/deploys/{deployId}/manifest` | Lists the files one deploy contains, a page at a time or all at once |
| POST | `/api/sites/{siteId}/deploys/{deployId}/preview-ticket` | Lets the in-browser editor's preview frame load a gated version's own files |
| POST | `/api/sites/{siteId}/deploys/{deployId}/promote` | Rolls the site back to an earlier deploy that still has its files |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/dropto-run/openapi/dropto-run-deploys-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 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 Sites API](https://apis.io/apis/dropto-run/dropto-run-sites-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

Deploys

---

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