Skip to main content
ZStack
Monitoring & Collection/Logging

SaveTailPreset

Save a reusable filter configuration as a named preset for future sessions

POST/api/v1/logs/tail/presets

Operation ID

SaveTailPreset

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

application/json

Body Fields

  • userUuid
    StringRequired

    UUID of the user saving this preset

    Example: user-001-abc

  • tenantId
    StringRequired

    Tenant identifier for preset ownership

    Example: tenant-xyz

  • preset
    ObjectRequired

    Preset for this resource

    • 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

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • 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