Social Community

POST /v2/social/posts

Creates a community post containing text and/or structured token, post or position attachments. Send a position with chain_id and address, without snapshot, to capture the authenticated owner's current Codex holding as provider_reported. Caller-supplied snapshots remain author_claimed. Parent and attachment inserts are atomic. Unavailable or incomplete position observations return 503 position_snapshot_unavailable with no post written. Missing holdings or invisible source references return 404 attachment_reference_not_found. Approved post media_ids may accompany text and structured attachments or create a media-only post; publish_to_x must be explicitly false. A nonempty retired media URL array returns 422. A disabled media write gate returns 503 social_media_disabled; invalid ownership, scope, gallery or binding returns 400 invalid_social_media.

Request

  • Base URL
    https://api.arbital.xyz (the document declares no server; this is the origin it was published from)
  • URL
    https://api.arbital.xyz/v2/social/posts
  • Auth
    HTTP bearer

Request body

OR

Response

Community post created

bodystring required
created_at_msstring required
idstring uuid required
like_countinteger required
pinnedboolean required
viewer_likedboolean required
x_post_urlstring nullable required
x_publish_statestring required

Changes

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