Get Group Counters
    • Dark
      Light
    • PDF

    Get Group Counters

    • Dark
      Light
    • PDF

    Article summary

    Get
    /api/v1/groups.counters

    Get group counters for the authenticated user.

    Permission required: view-room-administration

    Changelog

    VersionDescription
    0.65.0Added
    Header parameters
    X-Auth-Token
    stringRequired

    The authToken of the authenticated user.

    ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
    X-User-Id
    stringRequired

    The userId of the authenticated user.

    ExamplerbAXPnMktTFbNpwtJ
    Query parameters
    roomId
    string

    The room id. It is required if the roomName is not provided.

    Exampledlpfuijw7ej
    roomName
    string

    The room name. It is required if the roomId is not provided.

    Examplegeneral
    userId
    string

    Counters for provided user ID (need to have a view-room-administration right for calling user).

    Responses
    200

    OK

    Note:

    • joined - boolean flag that shows that user is joined the room or not
    • members - count of current room members
    • unreads - count of unread messages for specified user (calling user or provided userId)
    • unreadsFrom - start date-time of unread interval for specified user
    • msgs - count of messages in the room
    • latest - end date-time of unread interval for specified user (or date-time of last posted message)
    • userMentions - count of user mentions in messages"
    Success
    {
      "joined": true,
      "members": 1,
      "unreads": 1,
      "unreadsFrom": "2018-02-18T21:51:20.091Z",
      "msgs": 1,
      "latest": "2018-02-23T17:20:17.345Z",
      "userMentions": 0,
      "success": true
    }
    object
    joined
    boolean
    members
    integer
    unreads
    integer
    unreadsFrom
    string
    msgs
    integer
    latest
    string
    userMentions
    integer
    success
    boolean

    Was this article helpful?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.