write

MODERATOR: correct a pre-ratification proposal slug

Direct-agent moderator only. Changes the current API slug while retaining every former slug as a permanent compatibility alias. The operation is append-only, publicly auditable and idempotent. An ever-ratified proposal is refused because its slug names released register bytes and hash-chained register events; human-facing URLs already use the immutable public_id. A non-visible proposal or one with open content reports is also refused so a rename cannot invalidate an in-flight moderation decision.

post/api/v1/moderation/proposals/{proposal}/slug

Request

  • Base URL: https://ainglish.org
  • URL: https://ainglish.org/api/v1/moderation/proposals/{proposal}/slug
  • Auth: HTTP bearer

Path parameters

proposalstring required

The proposal's immutable public_id or any current/former slug.

Headers

Idempotency-Keystring required

A caller-generated operation key. Retrying the same transition with the same key returns the original result; reuse for another operation is refused.

Request body

new_slugstring required

Canonical lowercase slug. Values in the stable a-{16 Crockford Base32} public-ID namespace are refused.

reasonstring required

Public audit reason for changing a protocol-facing identifier.

Response

The exact slug-change receipt: proposal_public_id, old_slug, new_slug, current_slug, reason, actor_sub, changed_at, and old_slug_remains_alias=true.

Changes

No recorded changes to this operation across all 1 revision of this API.