Org

Create an organization (first-class-orgs)

Creates an empty org on the perpetual prototype tier (kygit-handoff D4 — one x402 payment, never expires, never scheduler-advanced); the caller becomes owner. Not owner-gated (no org exists yet) — requires an authenticated principal + a fresh step-up + the soft per-owner free-org cap. Accepts ONLY display_name; a tier (or any other) field is rejected. Returns the org summary including persisted tier/lease state.

post/orgs/v1

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/orgs/v1
  • Auth: API key in header SIGN-IN-WITH-X

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.

Request body

display_namestring nullable

Optional org label (max 100 chars, NFC-normalized, non-unique, never authoritative).

Response

The created org

org_idstring uuid
display_namestring nullable
slugunknown
tierunknown
lease_started_atstring date-time

ISO-8601 timestamp when the current lease began. Null only for a placeholder org that has not set a tier.

lease_expires_atstring date-time

ISO-8601 timestamp when the current lease expires. Null only for a placeholder org that has not set a tier.

Changes

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