Skip to main content
POST
Add post comment

Authorizations

Authorization
string
header
required

Bearer an mk_live_ API key. A key is ORG-SCOPED: it grants full access to every resource in that organization, with no per-endpoint scoping (see the uid pseudo-permission on each operation). Manage keys at https://app.mymarky.ai.

Headers

Marky-Version
enum<string>

Opt into a dated API version. Omit to stay on the floor (2026-04-08) forever — unpinned clients never break. Pin to a newer date (e.g. 2026-11-03) to receive the newest response shapes. Unknown values fall back to the floor. See https://docs.mymarky.ai for the versioning model.

Available options:
2026-04-08,
2026-07-17,
2026-08-02,
2026-08-04,
2026-08-06,
2026-10-30,
2026-10-31,
2026-11-03
Example:

"2026-11-03"

Path Parameters

business_id
string
required

The workspace ID (a UUID from list_workspaces). Named business_id for backward compatibility; workspaces were called businesses.

post_id
string<uuid>
required

A UUID identifier.

Body

application/json
body
string
required

The comment text (1-2000 characters). Shows in the post's review thread in the app, where your team sees it.

Required string length: 1 - 2000

Response

Successful Response

id
string
required

Comment ID

body
string
required

The comment text

resolved
boolean
required

Whether your team marked this comment as handled

created_at
string
required

When the comment was written

user_id
string | null

ID of the team member who wrote the comment. Null when a client wrote it through a guest review link.

author_name
string | null

Display name of whoever wrote the comment. For a client on a guest review link, the name they entered followed by "(guest)". Null when the account has no name set.

updated_at
string | null

Last update time