Org

Set or rename the org's slug (repo-first-onramp D6)

Owner-only. Claims a globally-unique, address-form slug for the org (run402::<org-slug>/<repo-name>), distinct from display_name. A genesis set (the org had no slug yet) is a 201; a rename (the org already had a slug — the old one releases into a ~90-day cooldown behind a typed SLUG_RELEASED refusal, never a redirect) is a 200. The org's FIRST-EVER slug claim is free — no billing wallet required; every later set or rename debits a one-time payable set fee from the org's allowance. fee_usd_micros in the response names the real price of THIS call (0 or the fee). Requires Idempotency-Key so a retried claim cannot double-bill. Refused for names on the static reserved list (SLUG_RESERVED) or the curated protected-brands list (SLUG_PROTECTED, available only via manual review), and for a slug already claimed or in cooldown (SLUG_TAKEN / SLUG_RELEASED, the latter naming the successor slug).

post/orgs/v1/{org_id}/slug

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/orgs/v1/{org_id}/slug
  • Auth: one of:
    • API key in header SIGN-IN-WITH-X
    • HTTP bearer

Path parameters

org_idstring uuid required

Headers

SIGN-IN-WITH-Xstring required

SIWX auth header — base64-encoded JSON payload containing a signed CAIP-122 (EIP-4361) message. See https://docs.x402.org/extensions/sign-in-with-x.

Idempotency-Keystring required

Required — a paid, side-effecting set. An exact retry with the same key never double-bills.

Request body

slugstring required

Lowercase [a-z0-9-], no leading/trailing/double hyphen, at most 39 characters. Case-folded at resolution; uppercase is refused at claim time, not silently normalized.

Response

Renamed — the org already held a different slug

org_idstring uuid
slugstring
previous_slugunknown
createdboolean

true for a genesis set (the org had no prior slug); false for a rename or a no-op replay of the org's current slug.

fee_usd_microsinteger

The fee actually charged for THIS call. 0 for the org's free first-ever slug claim (or a no-op idempotent replay); the slug set fee otherwise (every later set or rename).

Changes

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