Body Required

• id string(uuid) Required

  Unique id for this event. Stable across redeliveries, so it is the dedupe key. It is the primary key of the row the publisher wrote, which means it is assigned when the state change is recorded, not when the message is dispatched.

• type string Required

  The topic name, identical to the channel address. Route on this.

  Value is thread.published.

• api_version string Required

  The Commune-Version value this payload conforms to. Present on the message itself, not only on the request header, so an event persisted to a consumer's own store stays self-describing.

• occurred_at string(date-time) Required

  RFC 3339 timestamp of the state change, not of the delivery attempt. Use it to order events, since delivery order is not guaranteed.

• newsletter_id string(uuid) | null Required

  The newsletter the change belongs to. This is the tenant boundary: a consumer only ever receives events for newsletters its credential can read. Null only for events that are genuinely not newsletter-scoped, which none of the 21 topics currently are.

• actor object | null Required

  Who caused the change. ALWAYS null today and consumers must treat it that way: the public API is currently read-only, so nothing that reaches this catalog was triggered through it, and Commune does not backfill an actor for changes made in the product UI or by a cron. The field exists now so that populating it, once writes exist, is an additive change rather than a new envelope version.

  Additional properties are NOT allowed.

  Hide actor attributes Show actor attributes object | null

  • type string Required

    user for a change a person made through an authenticated session, api_key for a public API write, system for a cron or webhook ingest with no human behind it.

    Values are user, api_key, or system.

  • id string Required

    Identifier of the actor within its type. A user id for user, a key id (never the secret) for api_key, a stable job name for system.

  • label string | null

    Human-readable name for display. Best effort, may be null.

• idempotency_key string | null Required

  ALWAYS null today. Once the public API accepts writes this carries the Idempotency-Key header of the write that caused the change, so a consumer can tie an event back to its own request and collapse the duplicates a retried write would otherwise produce. Null stays a legitimate value even then: a change made in the product UI or by a cron has no originating request to key on.

  Maximum length is 255.

• data object Required

  Event-specific body. Narrowed by each concrete event schema below.

  Hide data attributes Show data attributes object

  • thread_id string(uuid) Required

    The thread. The same id thread.created carried, so a consumer that stored that event can match on it directly.

  • short_id string | null

    Short public identifier used in thread URLs.

  • url string(uri) | null
  • author object | null

    A pointer to a Commune account, enough to attribute and render something without a second call. Null when there is no account to point at, either because there never was one or because the account was deleted. Content outlives its author, so a null here is expected rather than a sign the reference was lost.

    Hide author attributes Show author attributes object | null

    • user_id string Required
    • username string | null
    • display_name string | null
    • avatar_url string(uri) | null
  • visibility string Required

    Always public. Present so a payload stays self-describing next to thread.created, which carries the same field and can carry other values.

    Value is public.

  • previous_visibility string | null Required

    What the thread was before. Null when it was created public, which is the case source also reports.

    Values are subscribers, paid, or null.

  • source string Required

    created_public for a thread a team member started public, which fires thread.created from the same write. visibility_changed for one that was featured later.

    Values are created_public or visibility_changed.

  • published_by object | null

    The team member who put it on the feed. Named published_by rather than actor because the envelope already has an actor, which means something different and is always null today. Null on the created_public path, where a thread was public from the start and nobody featured it.

    Hide published_by attributes Show published_by attributes object | null

    • user_id string Required
    • username string | null
    • display_name string | null
    • avatar_url string(uri) | null
  • article_id string(uuid) | null

    Set when the thread is an article's discussion rather than a standalone one.

  • published_at string(date-time) Required

    visibility_changed_at on the visibility_changed path, the thread's created_at on the created_public path.