Skip to main content
POST
ListMarkedEntities

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
kinds
enum<string>[]

The kinds of marks to list.

Required array length: 1 - 10 elements

MarkKind is the kind of a mark.

Available options:
MARK_KIND_UNSPECIFIED,
MARK_KIND_CERTIFIED,
MARK_KIND_DEPRECATED
setByIdentities
string[]

Identity strings of the person, to match the person who set the mark. Resolve a user to all their identities with synq.users.v1.UsersService GetUserIdentities first. Format: "synq:<user_id>", "email:", "slack:<slack_user_id>". Empty matches every person.

Maximum array length: 100
Required string length: 1 - 1024
pagination
Pagination · object

The page to read. The default page size is 100, and the largest is 1000.

Response

200 - application/json

Success

markedEntities
MarkedEntity · object[]

The marks, newest first.

pageInfo
PageInfo · object