Crashes - Add Comment

Endpoint

/i/crashes/add_comment

Overview

Adds a comment to a crash group.

Authentication

Countly API supports three authentication methods:

1. api_key=YOUR_API_KEY
2. auth_token=YOUR_AUTH_TOKEN
3. countly-token: YOUR_AUTH_TOKEN

Permissions

Requires crashes Create permission.

Request Parameters

Parameter	Type	Required	Description
api_key	String	Conditional	Required if auth_token is not provided.
auth_token	String	Conditional	Required if api_key is not provided.
app_id	String	Yes	Target app ID for validation context.
args	JSON String (Object)	Yes	Comment payload.
args.app_id	String	Yes	App ID used by comment write path.
args.crash_id	String	Yes	Crash group ID.
args.text	String	No	Comment text. Default empty string.
args.time	Number	No	Comment timestamp in ms. Default current time.

Response

Success Response

{
  "result": "Success"
}

Response Fields

Field	Type	Description
result	String	Success when request is accepted.

Error Responses

• 400

{
  "result": "Please provide args parameter"
}

Standard auth/permission errors from create validation can also be returned.

Behavior/Processing

• Builds comment object with _id, author, author_id, time, text.
• Comment _id is SHA1 hash of app/crash/comment payload.
• Pushes comment into crash group comments array.
• Emits crash_added_comment system log action.

Database Collections

Collection	Used for	Data touched by this endpoint
countly.app_crashgroups{appId}	Crash comments	Pushes new entry into comments array.
countly.systemlogs	Audit trail	Receives crash_added_comment action.

Examples

/i/crashes/add_comment?api_key=YOUR_API_KEY&app_id=6991c75b024cb89cdc04efd2&args={"app_id":"6991c75b024cb89cdc04efd2","crash_id":"crash_group_1","text":"Investigating root cause"}

Related Endpoints

• Crashes - Edit Comment
• Crashes - Delete Comment

Last Updated

2026-03-07