How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

usewrit-app Cloud API

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.

usewrit-app Cloud API is one of 17 APIs that usewrit-app publishes on the 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.

This API exposes 18 operations across 15 paths, and defines 18 schemas. It is described by OpenAPI 3.2.0, at version 0.1.0.

Requests are made against 2 base URLs: http://127.0.0.1:8131, https://127.0.0.1:8132.

18 operations 15 paths 18 schemas 1 DELETE7 GET2 PATCH8 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1.0
Base URL
https://api.usewrit.app
Authentication
HTTP Bearer
License
MIT
Resource Areas
1

Authentication & Security 1

usewrit-app Cloud API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Every route (including /v1/agent and /v1/health) requires Authorization: Bearer . Token families: - wlt… — the runtime token from runtime.json (full access, us…

Paths & Operations 18

Across 15 paths, the API surfaces 18 operations — 1 DELETE, 7 GET, 2 PATCH, 8 POST. Each is listed below with its method, path, parameters, and response codes.

Cloud 18

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 daem…

POST
/api/crawl/scrape
Scrape one page (metered)
cloudScrapeMetered body → 200401402422
POST
/v1/keyless/scrape
Scrape one page (keyless)
cloudScrapeKeyless 1 param body → 200400429
POST
/v1/keyless/map
Map a site's URLs (keyless)
cloudMapKeyless 1 param body → 200400429
GET
/v1/keyless/quota
Remaining keyless allowance
cloudKeylessQuota 1 param → 200400
GET
/api/targets
List cloud monitors
cloudListMonitors 4 params → 200401
POST
/api/targets
Create a cloud monitor
cloudCreateMonitor body → 201400401402
GET
/api/targets/{target_id}
Get a cloud monitor
cloudGetMonitor 1 param → 200404
PATCH
/api/targets/{target_id}
Update a cloud monitor
cloudUpdateMonitor 1 param body → 200402404
DELETE
/api/targets/{target_id}
Delete a cloud monitor
cloudDeleteMonitor 1 param → 204404
PATCH
/api/targets/{target_id}/toggle
Pause or resume a cloud monitor
cloudToggleMonitor 2 params → 200404
POST
/api/targets/{target_id}/run
Check a cloud monitor now
cloudRunMonitor 1 param → 200409503
GET
/api/targets/{target_id}/changes
A cloud monitor's change history
cloudMonitorChanges 2 params → 200
GET
/api/targets/changes/recent
Recent changes across all cloud monitors
cloudRecentChanges 1 param → 200
POST
/api/crawl
Start a cloud crawl
cloudStartCrawl body → 200401402
GET
/api/crawl/{crawl_id}
Poll a cloud crawl
cloudCrawlStatus 1 param → 200404
POST
/api/v1/website-to-api
Turn a website into a callable API
cloudWebsiteToApi body → 202200400401402403
GET
/api/v1/website-to-api/{build_id}
Poll a website-to-API build
cloudWebsiteToApiStatus 1 param → 200404
POST
/v1/keyless/crawl
Crawl a few pages (keyless)
cloudKeylessCrawl 1 param body → 200422429

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are CrawlJob (33 properties), CloudMonitor (26 properties), CloudMonitorCreate (18 properties), CrawlStartRequest (15 properties). Each schema is shown below with its type and property counts.

KeylessQuota
object
Remaining keyless daily allowance for the calling install.
7 properties
CloudMonitorChange
object
One detected change in a cloud monitor's history.
12 properties
CloudMonitorCreate
object
Create/update body for a cloud monitor. snakecase ON PURPOSE — the cloud ACCEPTS snakecase and ANSWERS camelCase (CloudMonitor). Every field except url is opti…
18 properties 1 required
WebsiteToApiRequest
object
Same inputs as the MCP tool, so the two front doors cannot drift.
7 properties 2 required
ScrapeResult
object
A single scraped page. tier is keyless or metered; quota is present on the keyless tier only.
8 properties
CrawlStartRequest
object
Start a Dragnet whole-site crawl. Only url is required; every other field falls to the column default. includepaths/excludepaths are path-regex allow/deny list…
15 properties 1 required
CloudMonitorRunResult
object
Outcome of an out-of-schedule check.
3 properties
CloudScrapeRequest
object
1 property 1 required
CloudMapRequest
object
3 properties 1 required
MapResult
object
A site's ranked URLs. quota is present on the keyless tier only.
7 properties
KeylessCrawlRequest
object
4 properties 1 required
CloudCrawlJob
KeylessCrawlResult
object
A bounded keyless crawl. Deliberately NOT a CrawlJob — that is a fleet job you poll, this returns the pages inline.
8 properties
CrawlJob
object
A Dragnet crawl job (crawljobs row), in the toview projection: the JSON-TEXT scope columns are parsed into arrays, and the Dragnet brand, the dataworkflowid al…
33 properties 24 required
PlanLimitError
object
A plan-ceiling denial (402). Distinguished from a credits/wallet 402 by carrying a numeric limit; clients should branch on that rather than on a code allowlist…
5 properties
CloudMonitor
object
A monitor as WRIT CLOUD serialises it. NOTE THE CASING: the cloud answers camelCase (checkPeriodMs) where the daemon's Monitor answers snakecase (checkperiodms…
26 properties
Error
object
The daemon's domain error body. NOTE: some 4xx responses (axum framework rejections) are text/plain instead of this JSON shape. Certain codes attach extra fiel…
2 properties 2 required
CloudBuild
object
A build, or the ladder answer that made one unnecessary. buildid is present only when a build was actually queued — branch on status first.
12 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

usewrit-app-cloud-api-openapi.yml Raw ↑

Other APIs usewrit-app publishes across the network.

usewrit-app Agent API
usewrit-app Automations API
usewrit-app Crawl API
usewrit-app Data API
usewrit-app Datasets API
usewrit-app Extractors API
usewrit-app Files API
usewrit-app Keys API
usewrit-app Monitors API
usewrit-app Personas API
usewrit-app Runs API
usewrit-app Secrets API
Where this information came from

This is an independent, third-party profile of usewrit-app Cloud API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.