Creates a new comment on a block.
Authentication required.
You can mention users in the comment body using @username syntax.
Path Params
id
string
required
The Block ID or slug
Body Params
body
string
required
Comment body (supports @mentions)
POST
https://api.are.na/v3/blocks/{id}/comments
A comment on a block
id
integer!
Unique identifier for the comment
type
string!
Comment type
Comment
body
MarkdownContent
Comment body with markdown, HTML, and plain text renderings
MarkdownContent
MarkdownContent
Markdown content with multiple renderings
markdown
string!
Original markdown value
html
string!
HTML rendering of the markdown
plain
string!
Plain text rendering of the markdown
unknown
null
created_at
string (date-time)!
When the comment was created
updated_at
string (date-time)!
When the comment was last updated
user
EmbeddedUser!
Embedded user representation (used when user is nested in other resources)
id
integer!
Unique identifier for the user
type
string!
User type
User
name
string!
User's display name
slug
string!
URL-safe identifier (use this in API paths)
avatar
string | null (uri)!
URL to user's avatar image
initials
string!
User's initials
_links
object!
HATEOAS links for navigation and discovery.
self
Link!
A hypermedia link containing the URL of a linked resource.
href
string (uri)!
The URL of the linked resource