List comment markers

List the open comment threads on a set of records

Returns a marker for each open thread on the given records that the user can see: the record, the field (or _record for a thread on the record as a whole), the thread id, and whether the thread has activity the user has not seen. Fails with 400 INVALID_REQUEST if more than 200 records are named, and with 404 NOT_FOUND if the form does not exist or the user may not see it.

Request

POST https://www.activityinfo.org/resources/form/{formId}/comments/markers

Request body

application/json

object
recordIds array[string] The ids of the records whose open threads are wanted, at most 200 of them. required

Successful response

application/json

array[object]
recordId string The id of the record the thread is attached to. required
fieldId string The id of the field the thread is attached to, or `_record` for a thread on the record as a whole. required
threadId string The id of the open thread. required
unread boolean True if the thread has activity the user has not yet seen. required

Error responses

Status Code Error Code Description
401 AUTHENTICATION_REQUIRED The request must be authenticated
Next item
List form comment threads