ARarbital
Social Community

POST /v2/social/posts/{post_id}/replies

Replies to a community post. Participation is community: any authenticated, unrestricted account that can read the post and has no block in either direction with the post author. Nothing is published to X. Caption is at most 2000 Unicode code points after trimming; C0 controls other than tab, newline and carriage return are rejected. Accepts ordered post_reply media_ids; body may be omitted or empty only with nonempty media or an external gif reference. Binding commits with the reply. Disabled writes return 503 social_media_disabled and invalid media returns 400 invalid_social_media. Also accepts one public KLIPY gif reference with optional caption, without a media upload. Reject gif with nonempty media_ids, null references, arbitrary URLs and unknown reference fields. SOCIAL_EXTERNAL_GIFS_ENABLED defaults false; disabled GIF-reference writes return 503 social_media_disabled independently of the upload gate. The backend stores the reference atomically and performs no provider calls or GIF-byte moderation. Receiver lookup restrictions must be reviewed before activation.

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/{post_id}/replies
  • Auth
    HTTP bearer

Path parameters

post_idstring uuid required

Request body

bodystring
media_idsstring[] ()

Upload IDs in gallery order. Each must belong to the actor, be approved, ready, unexpired and unbound, and match the write scope and exact chat when applicable. Up to four still images or one GIF; no mixed gallery. Binding is atomic with the parent write.

client_content_idstring uuid

Actor/source-kind scoped creation key. Matching replay returns the original readable source; a changed command returns 409. Required with nonempty mentions.

Response

The created reply

bodystring nullable required

Null after parent deletion; empty for a media-only or external-GIF-only reply. Removing the last image preserves the empty body and deleted media slot.

created_at_msstring required
deletedboolean required
idstring uuid required
parent_reply_idstring uuid nullable required

Exact direct parent reply on the same post; null for a direct reply to the post.

post_idstring uuid required
reply_countinteger required

Nondeleted visible direct replies, excluding deeper descendants.

viewer_can_deleteboolean required

Whether the viewer owns this undeleted reply and may delete it.

Changes

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