---
title: "Publish or revoke the owner's authorization: only the licence key holding a proven claim on the domain; actions read/cite/connect/transact each allow or deny, optional agents and note, valid_days 1-365 (default 90); {revoke:true} removes it. It never lifts a block CrawlCheck measured."
method: POST
path: "/api/v1/domain/authorization"
---

# Publish or revoke the owner's authorization: only the licence key holding a proven claim on the domain; actions read/cite/connect/transact each allow or deny, optional agents and note, valid_days 1-365 (default 90); {revoke:true} removes it. It never lifts a block CrawlCheck measured.

`POST /api/v1/domain/authorization`

## Request

- Base URL: `https://crawlcheck.io`
- URL: `https://crawlcheck.io/api/v1/domain/authorization`
- Auth: none required

## Request body

- object
  - `domain` string, required
  - `actions` object
  - `agents` string[]
  - `note` string
  - `valid_days` integer
  - `revoke` boolean

## Response `200`

published

- object, nullable
  - `ok` boolean, nullable
  - `domain` string, nullable
  - `state` string, nullable
  - `actions` object, nullable
    - `connect` string, nullable
    - `transact` string, nullable
  - `agents` unknown[], nullable
    - unknown
  - `valid_until` string, nullable
  - `read` string, nullable

## Other responses

- `401`: no key
- `403`: key does not hold a proven claim

---

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