Type Alias PublishedPostAsset

Type Declaration

• {}
• {}

• asset_type: "published_post"

  Discriminator identifying this as a published-post reference asset. See /schemas/creative/asset-types for the registry.

• Optionalpost_url?: string

  Canonical URL for the published post. Preferred when the platform exposes a stable public or authenticated URL.

• Optionalplatform?: string

  Optional platform or publisher namespace for the referenced post. Informational unless the seller's product declaration or platform extension narrows the accepted values.

• Optionalplatform_post_id?: string

  Optional platform-native post identifier when a URL alone is not stable or not available. Buyers SHOULD include platform when using platform_post_id without post_url, unless the product or format declaration already narrows the platform. Platform-specific identifier semantics belong in platform_extensions; this field is only an opaque reference.

• Optionalidentity_ref?: { handle?: string; profile_url?: string; platform_identity_id?: string }

  Optional identity hint for the authoring handle/page/channel that owns the post. Sellers MUST verify authorization from platform state; buyers MUST NOT use this object as proof of authorization.

  • Optionalhandle?: string

    Human-readable handle or username when available.

  • Optionalprofile_url?: string

    URL for the authoring profile, page, or channel.

  • Optionalplatform_identity_id?: string

    Opaque platform-native identity identifier.

• Optionalpublished_at?: string

  When the referenced post was originally published, if known.

• Optionalreference_authorization?: {
      status:
          | "authorized"
          | "pending"
          | "expired"
          | "revoked"
          | "not_required"
          | "unknown";
      checked_at?: string;
      expires_at?: string;
      authorization_url?: string;
      authorization_instructions?: string;
  }

  Server-emitted, seller-observed authorization state for the referenced post or identity. Sellers MAY return this object on read surfaces. On write requests, sellers MUST ignore buyer-supplied reference_authorization.status and other authorization-state claims unless a platform extension explicitly defines a signed proof shape and the seller verifies that proof.

  • status: "authorized" | "pending" | "expired" | "revoked" | "not_required" | "unknown"

    Current seller-observed authorization state. authorized: seller can serve the referenced post. pending: additional creator/account action is required. expired or revoked: authorization previously existed but no longer permits serving. not_required: the seller can legally and technically serve without a separate identity authorization. unknown: seller has not checked or cannot disclose the state.

  • Optionalchecked_at?: string

    When the seller last checked the authorization state.

  • Optionalexpires_at?: string

    When the authorization expires, if the platform exposes an expiry.

  • Optionalauthorization_url?: string

    Optional URL the buyer or creator can use to complete authorization.

  • Optionalauthorization_instructions?: string

    Human-readable instructions for completing or restoring authorization.

• Optionalprovenance?: Provenance