OmnioDocsAPI referenceOpen the app

Count conversations

GET/v1/conversations/counts

How many conversations each view, state and lifecycle stage holds, how many have unread customer messages, and how many each assignee, team, channel and tag has, for the inbox badges and filters.

Narrow the views, states and stages with the list's filters.

Scope conversations:read

Query parameters

tag_idstring, uuid
lifecyclestring
Up to 64 characters
assignee_member_idstring, uuid
assignee_team_idstring, uuid
channel_idstring, uuid

Response

  • 200Success
Response fields
viewsobjectRequired
lifecycleobjectRequired
unreadobjectRequired
scopesobjectRequired
assigneesobjectRequired
teamsobjectRequired
channelsobjectRequired
tagsobjectRequired

Errors

  • 401unauthorized. The key is missing, unknown or revoked
  • 403insufficient_scope. The key lacks the scope above
  • 422validation_error. details.fields names each field at fault

Every error has the same shape. See Errors.