Update Saved Search

Updates an existing saved search. This is a full replace: send the full object. Every optional field (select, where, whereLanguage, orderBy, tags, filters) is always written and falls back to its default when omitted, so omitting a field resets it rather than preserving the stored value.

PUT /api/v2/saved-searches/{id}

Error

A valid request URL is required to generate request examples

200

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "name": "Production Errors",
    "sourceId": "507f1f77bcf86cd799439012",
    "select": "Timestamp, ServiceName, Body",
    "where": "SeverityText:ERROR",
    "whereLanguage": "lucene",
    "orderBy": "Timestamp DESC",
    "tags": [
      "production",
      "errors"
    ],
    "filters": [
      {
        "type": "sql",
        "condition": "ServiceName IN ('checkout', 'payments')"
      }
    ],
    "teamId": "507f1f77bcf86cd799439013",
    "createdAt": "2025-01-01T00:00:00.000Z",
    "updatedAt": "2025-06-15T10:30:00.000Z"
  }
}

{
  "message": "NOT_FOUND: Alert not found"
}

{
  "message": "NOT_FOUND: Alert not found"
}

{
  "message": "NOT_FOUND: Alert not found"
}

{
  "message": "NOT_FOUND: Alert not found"
}

Авторизации

Authorization · string · header · обязательно

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Параметры пути

id · string · обязательно

Saved search ID

Тело

application/json

name · string · обязательно

Display name for the saved search.

Maximum string length: 1024

Пример:

"Production Errors"

sourceId · string · обязательно

ID of the source to query. Must belong to the team.

Пример:

"507f1f77bcf86cd799439012"

select · string

Comma-separated list of column expressions to display. Empty uses the source default.

Maximum string length: 4096

Пример:

"Timestamp, ServiceName, Body"

where · string

Row filter expression. The language is controlled by whereLanguage.

Maximum string length: 8192

Пример:

"SeverityText:ERROR"

whereLanguage · enum<string> · по умолчанию: lucene

Language used for the where filter.

Доступные опции: lucene, sql

Пример:

"lucene"

orderBy · string

ORDER BY expression. Empty uses the source default.

Maximum string length: 1024

Пример:

"Timestamp DESC"

tags · string[]

Tags used to organize saved searches.

Maximum array length: 50

Maximum string length: 32

Пример:

["production", "errors"]

filters · object[]

Structured pinned filters applied to the search.

Maximum array length: 100

Show child attributes

Пример:

[
  {
    "type": "sql",
    "condition": "ServiceName IN ('checkout', 'payments')"
  }
]

Ответ

200

application/json

Successfully updated saved search

data · object

The saved search object.

Show child attributes