# usewrit-app Cloud API

**Canonical:** https://apis.io/apis/usewrit-app/usewrit-app-cloud-api/  
**Provider:** usewrit-app — https://apis.io/providers/usewrit-app/  
**Base URL:** https://api.usewrit.app  
**Documentation:** https://usewrit.app/docs/api

usewrit-app Cloud API is one of 17 APIs that [usewrit-app](https://apis.io/providers/usewrit-app/) 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 Cloud. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Tiered Writ CLOUD surface (scrape / map / crawl) — runs on the cloud, NOT the local daemon. These operations target the cloud server (`https://api.usewrit.app`), overriding the daemon `servers` above. Two tiers, resolved by credential: METERED with an `Authorization: Bearer` API key (the `/api/crawl/*` paths, billed per page), or KEYLESS with no key (the `/v1/keyless/*` paths, free but daily-capped per `X-Writ-Client-Id` device id and per IP). Whole-site crawl is metered-only; keyless covers scrape + map. See the hand-written SDKs' `cloud` surface.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/crawl/scrape` | Scrape one page (metered) |
| POST | `/v1/keyless/scrape` | Scrape one page (keyless) |
| POST | `/v1/keyless/map` | Map a site's URLs (keyless) |
| GET | `/v1/keyless/quota` | Remaining keyless allowance |
| GET | `/api/targets` | List cloud monitors |
| POST | `/api/targets` | Create a cloud monitor |
| GET | `/api/targets/{target_id}` | Get a cloud monitor |
| PATCH | `/api/targets/{target_id}` | Update a cloud monitor |
| DELETE | `/api/targets/{target_id}` | Delete a cloud monitor |
| PATCH | `/api/targets/{target_id}/toggle` | Pause or resume a cloud monitor |
| POST | `/api/targets/{target_id}/run` | Check a cloud monitor now |
| GET | `/api/targets/{target_id}/changes` | A cloud monitor's change history |
| GET | `/api/targets/changes/recent` | Recent changes across all cloud monitors |
| POST | `/api/crawl` | Start a cloud crawl |
| GET | `/api/crawl/{crawl_id}` | Poll a cloud crawl |
| POST | `/api/v1/website-to-api` | Turn a website into a callable API |
| GET | `/api/v1/website-to-api/{build_id}` | Poll a website-to-API build |
| POST | `/v1/keyless/crawl` | Crawl a few pages (keyless) |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/usewrit-app/openapi/usewrit-app-cloud-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/usewrit-app/json-schema/usewrit-app-workflow-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewrit-app/json-schema/usewrit-app-monitor-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewrit-app/json-schema/usewrit-app-crawl-job-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewrit-app/json-schema/usewrit-app-persona-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewrit-app/json-schema/usewrit-app-workflow-update-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewrit-app/json-schema/usewrit-app-persona-write-schema.json

## Other usewrit-app APIs (12)

- [usewrit-app Agent API](https://apis.io/apis/usewrit-app/usewrit-app-agent-api/)
- [usewrit-app Automations API](https://apis.io/apis/usewrit-app/usewrit-app-automations-api/)
- [usewrit-app Crawl API](https://apis.io/apis/usewrit-app/usewrit-app-crawl-api/)
- [usewrit-app Data API](https://apis.io/apis/usewrit-app/usewrit-app-data-api/)
- [usewrit-app Datasets API](https://apis.io/apis/usewrit-app/usewrit-app-datasets-api/)
- [usewrit-app Extractors API](https://apis.io/apis/usewrit-app/usewrit-app-extractors-api/)
- [usewrit-app Files API](https://apis.io/apis/usewrit-app/usewrit-app-files-api/)
- [usewrit-app Keys API](https://apis.io/apis/usewrit-app/usewrit-app-keys-api/)
- [usewrit-app Monitors API](https://apis.io/apis/usewrit-app/usewrit-app-monitors-api/)
- [usewrit-app Personas API](https://apis.io/apis/usewrit-app/usewrit-app-personas-api/)
- [usewrit-app Runs API](https://apis.io/apis/usewrit-app/usewrit-app-runs-api/)
- [usewrit-app Secrets API](https://apis.io/apis/usewrit-app/usewrit-app-secrets-api/)

## Tags

Cloud

---

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