Change comments settings

PUT

/v1/data/{artifactId}/comments/_config

curl --request PUT \
  --url https://shareout.site/v1/data/example/comments/_config \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "enabled": true, "identityMode": "anonymous", "allowReplies": true, "maxDepth": 1, "overlayEnabled": true, "guestComments": true }'

• Production

Artifact owner only. guestComments: true lets people with no account comment after an email code, wherever they can already open the page (public, or an unlocked password page); false turns it off; null follows the folder setting.

Authorizations

• bearerAuth

Parameters

Path Parameters

artifactId

required

string

Artifact ID (e.g. art_abc123).

Request Body^required

Media typeapplication/json

object

enabled

boolean

identityMode

string

Allowed values: anonymous named authenticated

allowReplies

boolean

maxDepth

integer

>= 1 <= 10

overlayEnabled

boolean

guestComments

boolean | null

Responses

200

Saved settings

Media typeapplication/json

object

success

boolean

data

object

enabled

boolean

identityMode

string

Allowed values: anonymous named authenticated

allowReplies

boolean

maxDepth

integer

overlayEnabled

boolean

guestComments

The artifact’s own guest setting; absent = follows its folder.

boolean

guestCommentsEffective

Whether guests may comment here (own setting, else the nearest folder’s).

boolean

Example

{
  "data": {
    "identityMode": "anonymous"
  }
}

400

INVALID_REQUEST

403

FORBIDDEN — not the owner