Get queue debug info

Enterprise

This endpoint is part of Countly Enterprise. To get access, contact sales or compare versions. Existing customers can reach the support portal with questions.

Endpoint

/o/content/debug

Overview

Returns user-friendly queue status details for one user.

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions

• Required permission: Read on the content feature

Request Parameters

Parameter	Type	Required	Description
api_key	String	Yes (or auth_token)	API key for authentication
auth_token	String	Yes (or api_key)	Auth token for authentication
app_id	String	Yes	Application identifier
uid	String	Yes	User ID

Examples

Example 1: Check Queue Status for a User

/o/content/debug?api_key=YOUR_API_KEY&app_id=5be987d7b93798516eb5289a&uid=user_12345

Response

Success Response

{
  "Queue Summary": {
    "Total Items": 2,
    "Last Content View": "2 hours ago",
    "Cooldown Status": "Cooldown expired 2 hours ago",
    "Content Available": "Yes"
  },
  "Next Available Content": {
    "Content ID": "5d4472152de8f07336f3b352",
    "Priority Level": 3,
    "Category": "Uncategorized",
    "Added to Queue": "5 minutes ago",
    "Expires": "in 23 hours",
    "Journey ID": "No Journey",
    "Additional Metadata": {}
  },
  "All Queue Items": [
    {
      "Content ID": "5d4472152de8f07336f3b352",
      "Priority Level": 3,
      "Category": "Uncategorized",
      "Added to Queue": "5 minutes ago",
      "Expires": "in 23 hours",
      "Journey ID": "No Journey",
      "Additional Metadata": {}
    }
  ]
}

Response Fields

Field	Type	Description
Queue Summary	Object	Queue overview
Queue Summary.Total Items	Number	Number of non-expired queue items (max 20 listed)
Queue Summary.Last Content View	String	Relative time string
Queue Summary.Cooldown Status	String	Cooldown state description
Queue Summary.Content Available	String	Content availability summary
Next Available Content	Object/String	Next deliverable item details, or a cooldown/empty state string
All Queue Items	Array	List of queue entries with friendly fields
Queue Status	String	Returned when queue is empty

Error Responses

HTTP Status	Response
500	"Error"

Behavior

1. Builds EngagementQueue for app_id + uid.
2. Reads user state and up to 20 non-expired queue entries.
3. Computes cooldown text and availability summary.
4. Returns a user-friendly debug object.

Related Endpoints

• SDK Read - Content Delivery: Retrieve content from queue
• Content Blocks - Read: Inspect content definitions

Implementation details

Database Collections

Collection	Used for	Data touched by this endpoint
countly.content_queue	Endpoint data source	** - Queue entries
countly.app_users{app_id}	Endpoint data source	** - User content state (content.last_view_ts, content.state_update_ts)
countly.apps	Endpoint data source	** - App plugin cooldown configuration lookup