Skip to main content
ZStack
Monitoring & Collection/Logging

ListTailPresets

List saved filter presets for a user or tenant with optional scope filter

GET/api/v1/logs/tail/presets

Operation ID

ListTailPresets

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

Query Parameters

  • userUuid
    String

    UUID of the user whose presets to list UUID of the user whose presets to list

  • tenantId
    String

    Tenant identifier to list presets within Tenant identifier to list presets within

  • scope
    String

    Scope filter: "personal", "shared", or "all" Scope filter: "personal", "shared", or "all"

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • items
    List

    Collection of result items

    Example: (nested array)

    • id
      String

      Unique identifier of this filter preset

      Example: preset-001

    • name
      String

      Human-readable name of the filter preset

      Example: Production Errors

    • userUuid
      String

      UUID of the user who owns this preset

      Example: user-001-abc

    • tenantId
      String

      Tenant identifier for multi-tenant preset ownership

      Example: tenant-xyz

    • filter
      Object

      Filter for this resource

      • includeKeywords
        List

        Include keywords

        Example: item1,item2

      • excludeKeywords
        List

        Exclude keywords

        Example: item1,item2

      • regex
        String

        Regular expression pattern to match against log message content

        Example: error.*timeout

      • logLevelMin
        String

        Minimum log level to include; entries below this level are excluded

        Example: warn

      • serviceFilter
        String

        Service name filter to restrict matching to a specific service

        Example: payment-service

    • isShared
      Boolean

      Whether this preset is shared with all users in the tenant

      Example: false

    • createdAt
      String

      Created at

      Example: 2026-01-15T08:00:00Z

  • total
    Integer

    Total number of presets matching the query

    Example: 5

  • limit
    Integer

    Maximum number of items per page

    Example: 20

  • offset
    Integer

    Zero-based offset of the current page

    Example: 20