Sign in

v1

latestOpenAPI 3.1.0Proprietary2026-08-06177398877.4 KB
Saved Searches

Update saved search

Partially update a saved search. Only provided fields will be updated. You can only update saved searches that you own.

patch/saved-searches/{id}

Path parameters

idstring uuid required

Saved search UUID

Request body

namestring

Display name for the saved search

isPublicboolean nullable

Whether this saved search is visible to all users

groupIdstring uuid nullable

Optional group this saved search belongs to

Example request

{
  "name": "Updated Shipments View",
  "isPublic": true
}

Response

Saved search updated successfully

object'SAVED_SEARCH'

Object type identifier

idstring uuid required

Unique saved search identifier

namestring required

Display name for the saved search

preferenceType'SHIPMENT' | 'INVOICE' | 'BILL' | 'USER' | 'CUSTOMER' | 'VENDOR' | 'QUOTE' | 'COMMISSION' | 'CARRIER' | 'INVOICE_PAYMENT' | 'BILL_PAYMENT' | 'LOAD' | 'TRUCK_POSTING' | 'LOCATION' required

Type of entity this saved search applies to. Each type corresponds to a specific entity's search view.

Entity Mapping:

  • INVOICE: Customer invoices (AR Invoices) - money owed to you
  • BILL: Vendor/Carrier bills (AP Invoices) - money you owe
  • INVOICE_PAYMENT: Customer payment groups (AR Payment Groups)
  • BILL_PAYMENT: Vendor/Carrier payment groups (AP Payment Groups)
isPublicboolean nullable

Whether this saved search is visible to all users in the organization. If false or null, only the owner can see it.

ownedByUserstring uuid nullable

User ID who owns this saved search. Null means it's an organization-level saved search.

groupIdstring uuid nullable

Optional group this saved search belongs to

createdAtstring date-time required

Timestamp when saved search was created

updatedAtstring date-time required

Timestamp when saved search was last updated

Example response

{
  "object": "SAVED_SEARCH",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Active Shipments - West Coast",
  "preferenceType": "SHIPMENT",
  "jsonValue": {
    "searchCriteria": {
      "filters": [
        {
          "field": "status",
          "searchCriteria": {
            "operator": "ONE_OF",
            "values": [
              "ACTIVE",
              "PENDING"
            ]
          }
        }
      ]
    },
    "sorting": [
      {
        "id": "createdAt",
        "desc": true
      }
    ],
    "columnVisibility": {
      "status": true,
      "createdAt": true
    },
    "columnOrder": [
      "id",
      "status",
      "createdAt"
    ]
  },
  "isPublic": true,
  "ownedByUser": "550e8400-e29b-41d4-a716-446655440001",
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T14:30:00Z"
}