---
title: "Site key for a verified WordPress site"
method: POST
path: "/site-keys"
tags: ["System"]
---

# Site key for a verified WordPress site

`POST /site-keys`

Issues a key to a site that proves it controls its domain: we fetch the proof from the site's REST route (`/wp-json/astroway/v1/verify?nonce=<proof_id>`, or `verify_url` for plain permalinks) and compare it with the one sent. The key is bound to the host, covers a free set of readings and shares 300 calls an hour with the other installs on the host (at most 5). One key per install (host + home path): a new key for the same install revokes the previous one. Server-side only. No API key needed.

## Query parameters

- `fields` string
- `precision` integer

## Request body

- SiteKeyIssue
  - `site_url` string, uri, required — The site home URL, https only. A subdirectory multisite uses the network home.
  - `proof_id` string, uuid, required — UUID v4 the plugin generated for this attempt.
  - `proof` string, required — 32 random bytes, base64url. The site must serve the same value at its verify route.
  - `verify_url` string, uri — The verify REST route when /wp-json/ is not available, e.g. https://example.com/?rest_route=/astroway/v1/verify. Same host as site_url.
  - `plugin_version` string

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `key` string, nullable
    - `plan` string, nullable
    - `domain` string, nullable
    - `home_path` string, nullable
    - `limits` object, nullable
      - `per_hour` number, nullable
    - `endpoints` string[], nullable
    - `replaced_previous` boolean, nullable

## Other responses

- `400` — Validation error
- `401` — Missing or invalid API key

## Changes

- **2026-09-24** `0639223269d9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/site-keys/post.md)

---

[API](https://skmtc.dev/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.dev/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/astroway/apis/astroway-calculation-api/revisions/aa473bce3f00?raw)