---
title: "PinMyTerms — pin, inspect, or revoke observed terms"
method: POST
path: "/v1/terms/manage"
---

# PinMyTerms — pin, inspect, or revoke observed terms

`POST /v1/terms/manage`

## Request

- Base URL: `https://api.scrubmytext.com`
- URL: `https://api.scrubmytext.com/v1/terms/manage`
- Auth: HTTP bearer

Stores immutable terms and interface digests with bounded version and price metadata. It is technical evidence, not a legal agreement.

## Request body

- object
  - `operation` 'pin' | 'check' | 'revoke', required
  - `control_id` string
  - `terms_digest` string: A lowercase SHA-256 digest, with an optional sha256: prefix.
  - `interface_digest` string: A lowercase SHA-256 digest, with an optional sha256: prefix.
  - `counterparty_fingerprint` string: A lowercase SHA-256 digest, with an optional sha256: prefix.
  - `version_label` string
  - `price_minor` integer
  - `currency` string
  - `expires_in_seconds` integer

## Response `200`

Terms pin state

## Other responses

- `401`: Paid API key required
- `422`: Invalid operation-specific input

---

[API](https://skmtc.dev/scrubmytext/apis/scrubmytext-agent-infrastructure-api.md) · [All operations](https://skmtc.dev/scrubmytext/apis/scrubmytext-agent-infrastructure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrubmytext/apis/scrubmytext-agent-infrastructure-api/revisions/54ace36baccf?raw)
