Update Saved Search

PUT

api

saved-searches

{id}

Error

A valid request URL is required to generate request examples

{
  "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"
}

Autorizaciones

Authorization

string

header

requerido

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

Parámetros de ruta

string

requerido

Saved search ID

Cuerpo

application/json

name

string

requerido

Display name for the saved search.

Maximum string length: 1024

Ejemplo:

"Production Errors"

sourceId

string

requerido

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

Ejemplo:

"507f1f77bcf86cd799439012"

select

string

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

Maximum string length: 4096

Ejemplo:

"Timestamp, ServiceName, Body"

where

string

Row filter expression. The language is controlled by whereLanguage.

Maximum string length: 8192

Ejemplo:

"SeverityText:ERROR"

whereLanguage

enum<string>

predeterminado:lucene

Language used for the where filter.

Opciones disponibles:

lucene,

sql

Ejemplo:

"lucene"

orderBy

string

ORDER BY expression. Empty uses the source default.

Maximum string length: 1024

Ejemplo:

"Timestamp DESC"

Respuesta

Successfully updated saved search

data

object

The saved search object.

Show child attributes

Última modificación el 15 de julio de 2026

Delete Saved SearchDeletes a saved search and any alerts attached to it.

Error

A valid request URL is required to generate request examples

{
  "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"
}

Funciones

Guías

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta