Get flow crash groups

Ⓔ Enterprise Only
This API is available exclusively in Countly Enterprise.

Endpoint

/o/flows?method=crashes

Overview

Returns crash-group options (name, value) for crash-based flow definitions.

Authentication

Countly API supports three authentication methods:

1. API key query parameter: api_key=YOUR_API_KEY
2. Auth token query parameter: auth_token=YOUR_AUTH_TOKEN
3. Auth token header: countly-token: YOUR_AUTH_TOKEN

Permissions

Requires flows Read permission.

Request Parameters

Parameter	Type	Required	Description
method	String	Yes	Must be crashes.
app_id	String	Yes	Target app ID.
query	String	No	Optional case-insensitive name search.
api_key	String	Conditional	Required if auth_token is not provided.
auth_token	String	Conditional	Required if api_key is not provided.

Response

Success Response

{
  "result": [
    {
      "name": "NullReferenceException",
      "value": "67aef9ad7c2f4c0012ab33aa"
    }
  ]
}

Response Fields

Field	Type	Description
result	Array	Crash-group option list.
result[].name	String	Crash-group display name.
result[].value	String	Crash-group ID (_id).

Error Responses

• 400

{
  "result": "DB error. Please check logs"
}

Behavior/Processing

• Reads dynamic collection countly.app_crashgroups{app_id}.
• Excludes _id = "meta".
• Optional regex filter on name.
• Sorts by name descending and limits to 100.
• Uses returnMessage(200, res) for success.

Database Collections

Collection	Used for	Data touched by this endpoint
countly.app_crashgroups{appId}	Endpoint data source	Stores endpoint-related records this endpoint reads or modifies.

---

Examples

/o/flows?
  method=crashes&
  app_id=64f5c0d8f4f7ac0012ab3456&
  query=exception

---

Related Endpoints

• Flows - Events
• Flows - Create

---

Last Updated

2026-02-16