Moogsoft Docs

getResolvingThreadEntries

A MoogDb v2 method that returns thread entries for a Situation that have been marked as resolving steps. Threads are comments or 'story activity' on Situations. Operators can mark one or more thread entries as steps that were used to resolve a Situation.

You can select specific thread entries to return using start and limit values. If not, their default values return the first 100 thread entries. The thread entries returned are ordered by most recent first.

Back to MoogDb V2 API Method Reference.

Request arguments

Method getResolvingThreadEntries takes the following request arguments:

Name

Type

Required

Description

situationId

Number

Yes

Situation ID.

thread

String

Yes

Name of the thread.

start

Number

No

Number of the first resolving thread entry to return. Default is 0.

limit

Number

No

Maximum number of resolving thread entries to return. Default is 100.

Response

Method getResolvingThreadEntries returns the following response:

Type

Description

Native Object

A JSON object containing details of the selected thread entries.

API behavior in active and historic databases

The behavior of this method depends on whether the relevant alert or Situation is open, closed and still in the active database, or closed and archived to the historic database. This method updates or returns information about the alert or Situation as follows:

See API Update Behavior for more information on Situation statuses.

Examples

The following examples demonstrate typical use of method getResolvingThreadEntries:

Request examples

Example request to return the first 100 thread entries that are resolving steps for Situation 58:

var resolvingEntries = moogdb.getResolvingThreadEntries(58);

Request to return the first 10 thread entries that are resolving steps for Situation 58:

var resolvingEntries = moogdb.getResolvingThreadEntries(58, 0, 10);

Response example

Example response returning two resolving steps for the specified Situation:

{ 
  "entries": [
              {
                  "uid": 3,
                  "entry": "This one is important. Another comment",
                  "agrees": [],
                  "total_comments": 0,
                  "thread_id": "Support",
                  "mmid": -1,
                  "sig_id": 1,
                  "entry_id": 2,
                  "timed_at": 1423226829,
                  "disagrees": [],
                  "commenters": []
              },
              {
                  "uid": 3,
                  "entry": "No comment. A comment",
                  "agrees": [],
                  "total_comments": 0,
                  "thread_id": "Support",
                  "mmid": -1,
                  "sig_id": 1,
                  "entry_id": 1,
                  "timed_at": 1423226807,
                  "disagrees": [3],
                  "commenters": []
              }
             ],
  "total_entries": 2
}