Skip to main content

Crashes - Mark Viewed

Endpoint​

/i/crashes/view

Overview​

Marks crash groups as viewed by clearing is_new on selected groups and adjusting meta new-counter.

Authentication​

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

Permissions​

Requires crashes Update permission.

Request Parameters​

ParameterTypeRequiredDescription
api_keyStringConditionalRequired if auth_token is not provided.
auth_tokenStringConditionalRequired if api_key is not provided.
app_idStringYesTarget app ID.
argsJSON String (Object)YesAction payload.
args.crashesArray of StringsNoCrash group IDs.
args.crash_idStringNoSingle crash group ID.

Provide args.crashes or args.crash_id.

Examples​

/i/crashes/view?api_key=YOUR_API_KEY&app_id=6991c75b024cb89cdc04efd2&args={"crash_id":"crash_group_1"}

Response​

Success Response​

{
"result": "Success"
}

Response Fields​

FieldTypeDescription
resultStringSuccess when at least one crash group is updated.

Error Responses​

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

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

Behavior​

  • Resolves crash IDs from args.crashes or [args.crash_id].
  • For groups with is_new=true, sets is_new=false.
  • Decrements meta.isnew according to number of groups changed.
Implementation details

Database Collections

CollectionUsed forData touched by this endpoint
countly.app_crashgroups{appId}Crash status and metadataReads selected groups, updates is_new flags, updates meta counters.