SIGNALS Documentation
API Reference

Live filters

Manage saved list configurations with columns, filters, and sort order.

Live filters API

Endpoints for managing saved list configurations (columns, filters, sort).

Endpoints

Method URL Description
GET /api/v1/live_filters List live filters
GET /api/v1/live_filters/{id} Show a live filter
POST /api/v1/live_filters Create a live filter
PUT /api/v1/live_filters/{id} Update a live filter
DELETE /api/v1/live_filters/{id} Delete a live filter
POST /api/v1/live_filters/{id}/clone Clone a live filter

Visibility Levels

Level Description
personal Visible only to the creator
shared Visible to users with matching roles
system Visible to all users (admin-created, cannot be deleted)

Using Views on List Endpoints

Pass filter_id to any list endpoint to apply a saved view:

GET /api/v1/accounts?filter_id=42

When a view is active:

  • Filters from the view merge with explicit q params (explicit params take priority)
  • Sort from the view applies unless an explicit sort param is given
  • Response is sparse — only includes fields matching the view's columns plus id
  • Meta includes view.id and view.name

Create Live filter

POST /api/v1/live_filters

Request Body

Field Type Required Description
name string Yes View name (max 255 chars)
entity_type string Yes Entity type (e.g. "accounts")
visibility string No "personal" (default) or "shared"
columns array Yes List of column keys (min 1)
filters array No Filter definitions
sort_column string No Sort column key
sort_direction string No "asc" (default) or "desc"
per_page integer No Items per page (1-100, default 20)
role_ids array No Role IDs for shared visibility

Filter Structure

Each filter is an object:

{
  "field": "account_type",
  "predicate": "eq",
  "value": "company",
  "logic": "and"
}

Available predicates: eq, not_eq, cont, not_cont, gt, lt, gteq, lteq, true, false, null, not_null, in, not_in, start, end, present, blank

Logic operators: and (default), or, nand, nor

Column Validation

Column keys are validated against the entity's column registry. Invalid keys return 422. Custom field columns use the cf. prefix (e.g. cf.po_reference).