Add Thread Comment

Adds a comment to a Thread of a Space.

Method POST
URL https://{subdomain}.kintone.com/k/v1/space/thread/comment.json
URL(guest space) https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/space/thread/comment.json
Authentication Password Authentication
Content-Type application/json

Permissions

  • The user must have access to the Space.

Request Parameters

Parameter Value Required Description
space Integer or String Yes The Space ID.
thread Integer or String Yes The Thread ID.
comment Object Optional An object including comment details.
comment.text String Conditional The comment contents.
A line break can be specified by LF.
The maximum characters of the comment is 65535. Required, if comment.files is not set.
comment.files Array Conditional An array including data of attachment files.
The maximum number of the files is 5.
Required, if comment.text is not set.
comment.files[].fileKey String Optional The fileKey of the attachment file.
Use the fileKey that is responded from the Upload File API.
comment.files[].width Integer or String Optional A width can be specified if the attachment file is an image.
The minimum is 100, and the maximum is 750.
If this parameter is ignored, the original width will be set (this width is the same size as the size when "Original" is chosen when adding an image to a thread via GUI). This parameter is ignored if the file is not an image.
comment.mentions Array Optional An array including mentions, that notify other kintone users.
comment.mentions[].code String Optional The code of the user, group or department that will be mentioned.
The maximum number of mentions is 10.
The mentioned users will be placed in front of the comment text in the output.
comment.mentions[].type String Optional The entity type of the mentioned target.
  • USER: User
  • GROUP: Group
  • ORGANIZATION: Department

Sample Request

JavaScript (using kintone REST API Request)

XMLHttpRequest

Response Parameters

Parameter Type Description
id String The comment ID of the created comment.

Sample Response

Sample Capture

Capture.PNG

Limitations

  • If the mentioned name has a localized name setting, and the language of the localized name is the same as the comment poster's language settings, the mentioned name will be posted as the localized name.
  • Inactive/deleted users, departments, and groups cannot be mentioned.
  • Errors will occur if you mention a user who is being invited to the guest space, but has not joined yet.
Was this article helpful?
0 out of 0 found this helpful
Comments
Please sign in to leave a comment.