SavedSearch

Saved searches allow the user to save frequent used searches. These can be organized in folders for easy access. The saved searches can also be referenced in widgets to display current status of PIM data.

Gets the specified saved search folder

get

Authorizations

ApiKey

Path parameters

folderUidstring · uuidRequired

The uid of the folder

Responses

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

404

Not Found

text/plainapplication/jsontext/json

get

HTTPcURLJavaScriptPython

GET /v1/savedsearchfolders/{folderUid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

{
  "OwnerUserUid": "text",
  "Created": "2025-10-13T14:22:10.563Z",
  "LastModified": "2025-10-13T14:22:10.563Z",
  "CreatedBy": "text",
  "LastModifiedBy": "text",
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "ParentUid": "123e4567-e89b-12d3-a456-426614174000",
  "Name": "text",
  "SortOrder": 1
}

Get the specified saved search folders

post

Authorizations

ApiKey

Bodystring · uuid[]

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

string · uuid[]Optional

Responses

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

post

HTTPcURLJavaScriptPython

POST /v1/savedsearchfolders/batch HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 40

[
  "123e4567-e89b-12d3-a456-426614174000"
]

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

[
  {
    "OwnerUserUid": "text",
    "Created": "2025-10-13T14:22:10.563Z",
    "LastModified": "2025-10-13T14:22:10.563Z",
    "CreatedBy": "text",
    "LastModifiedBy": "text",
    "Uid": "123e4567-e89b-12d3-a456-426614174000",
    "ParentUid": "123e4567-e89b-12d3-a456-426614174000",
    "Name": "text",
    "SortOrder": 1
  }
]

Gets all saved search folders

get

Authorizations

ApiKey

Responses

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

get

HTTPcURLJavaScriptPython

GET /v1/savedsearchfolders HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "OwnerUserUid": "text",
    "Created": "2025-10-13T14:22:10.563Z",
    "LastModified": "2025-10-13T14:22:10.563Z",
    "CreatedBy": "text",
    "LastModifiedBy": "text",
    "Uid": "123e4567-e89b-12d3-a456-426614174000",
    "ParentUid": "123e4567-e89b-12d3-a456-426614174000",
    "Name": "text",
    "SortOrder": 1
  }
]

Create a single saved search folder

post

Authorizations

ApiKey

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

Used to create a new saved search folder

OwnerUserUidstring | nullableOptional

Uid of the owner of the saved search folder. If null, the folder is available to all users

Uidstring · uuidOptional

The Uid of the folder

ParentUidstring · uuid | nullableOptional

Uid of parent folder

Namestring | nullableOptional

Name of the folder

SortOrderinteger · int32Optional

Sortorder for folders

Responses

200

OK

No content

400

Bad Request

text/plainapplication/jsontext/json

post

HTTPcURLJavaScriptPython

POST /v1/savedsearchfolders HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 147

{
  "OwnerUserUid": "text",
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "ParentUid": "123e4567-e89b-12d3-a456-426614174000",
  "Name": "text",
  "SortOrder": 1
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

No content

Updates a saved search folder

patch

Authorizations

ApiKey

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

Model used to update saved search folder

Uidstring · uuidOptional

The Uid of the folder

ParentUidstring · uuid | nullableOptional

Uid of parent folder

Namestring | nullableOptional

Name of the folder

SortOrderinteger · int32Optional

Sortorder for folders

Responses

200

OK

No content

400

Bad Request

text/plainapplication/jsontext/json

patch

HTTPcURLJavaScriptPython

PATCH /v1/savedsearchfolders HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 125

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "ParentUid": "123e4567-e89b-12d3-a456-426614174000",
  "Name": "text",
  "SortOrder": 1
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

No content

Deletes a saved search folder

delete

Authorizations

ApiKey

Path parameters

folderUidstring · uuidRequired

the uid of the folder

Responses

200

OK

No content

400

Bad Request

text/plainapplication/jsontext/json

delete

HTTPcURLJavaScriptPython

DELETE /v1/SavedSearchFolders/{folderUid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

No content

Get a specific search

get

Authorizations

ApiKey

Path parameters

uidstring · uuidRequired

The uid of the saved search

Responses

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

404

Not Found

text/plainapplication/jsontext/json

get

HTTPcURLJavaScriptPython

GET /v1/savedsearches/{uid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "Created": "2025-10-13T14:22:10.563Z",
  "CreatedBy": "text",
  "LastMofidied": "2025-10-13T14:22:10.563Z",
  "LastModifiedBy": "text",
  "OwnerUserUid": "text",
  "FailedCalculationCounter": 1,
  "FailedMessage": "text",
  "Name": "text",
  "SearchEntityTypeModel": 1,
  "GlobalListUid": "123e4567-e89b-12d3-a456-426614174000",
  "FolderUid": "123e4567-e89b-12d3-a456-426614174000",
  "Query": {
    "BooleanOperator": 0,
    "QueryModelType": "text"
  },
  "SortOrder": 1,
  "ViewColumns": [
    {
      "FieldUid": "text",
      "Width": 1
    }
  ],
  "EnableTimeline": true,
  "TimelineBusinessUnits": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

Deletes a saved search from the system

delete

Authorizations

ApiKey

Path parameters

uidstring · uuidRequired

The id of the saved search to delete

Responses

200

OK

No content

400

Bad Request

text/plainapplication/jsontext/json

delete

HTTPcURLJavaScriptPython

DELETE /v1/savedsearches/{uid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

No content

Get a list of specific searches

post

Authorizations

ApiKey

Bodystring · uuid[]

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

string · uuid[]Optional

Responses

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

post

HTTPcURLJavaScriptPython

POST /v1/savedsearches/batch HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 40

[
  "123e4567-e89b-12d3-a456-426614174000"
]

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

[
  {
    "Uid": "123e4567-e89b-12d3-a456-426614174000",
    "Created": "2025-10-13T14:22:10.563Z",
    "CreatedBy": "text",
    "LastMofidied": "2025-10-13T14:22:10.563Z",
    "LastModifiedBy": "text",
    "OwnerUserUid": "text",
    "FailedCalculationCounter": 1,
    "FailedMessage": "text",
    "Name": "text",
    "SearchEntityTypeModel": 1,
    "GlobalListUid": "123e4567-e89b-12d3-a456-426614174000",
    "FolderUid": "123e4567-e89b-12d3-a456-426614174000",
    "Query": {
      "BooleanOperator": 0,
      "QueryModelType": "text"
    },
    "SortOrder": 1,
    "ViewColumns": [
      {
        "FieldUid": "text",
        "Width": 1
      }
    ],
    "EnableTimeline": true,
    "TimelineBusinessUnits": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
]

Gets all searches in the system

get

Authorizations

ApiKey

Responses

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

get

HTTPcURLJavaScriptPython

GET /v1/savedsearches HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "Uid": "123e4567-e89b-12d3-a456-426614174000",
    "Created": "2025-10-13T14:22:10.563Z",
    "CreatedBy": "text",
    "LastMofidied": "2025-10-13T14:22:10.563Z",
    "LastModifiedBy": "text",
    "OwnerUserUid": "text",
    "FailedCalculationCounter": 1,
    "FailedMessage": "text",
    "Name": "text",
    "SearchEntityTypeModel": 1,
    "GlobalListUid": "123e4567-e89b-12d3-a456-426614174000",
    "FolderUid": "123e4567-e89b-12d3-a456-426614174000",
    "Query": {
      "BooleanOperator": 0,
      "QueryModelType": "text"
    },
    "SortOrder": 1,
    "ViewColumns": [
      {
        "FieldUid": "text",
        "Width": 1
      }
    ],
    "EnableTimeline": true,
    "TimelineBusinessUnits": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
]

Create a saved search in the system

post

Authorizations

ApiKey

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

Model to create a new saved search in the api

Uidstring · uuidOptional

Unique id if the saved search

OwnerUserUidstring | nullableOptional

The user who owns the saved search. If null, saved search is available to all users

Namestring | nullableOptional

Name of the saved search

SearchEntityTypeModelinteger · enumOptional

The type of saved search

• 1 = Category: Category type
• 2 = Product: Product type
• 3 = VariantGroup: VariantGroup type
• 4 = Variant: Variant type
• 5 = Asset: Asset type
• 6 = GlobalList: Globallist type

Possible values:

GlobalListUidstring · uuid | nullableOptional

Globallist uid of referencing globallist

FolderUidstring · uuid | nullableOptional

Folder id of the saved search

SortOrderinteger · int32Optional

Sortorder of the saved search

EnableTimelinebooleanOptional

Whether or not to enable the timeline

TimelineBusinessUnitsstring · uuid[] | nullableOptional

Business unit limitation for timeline calculation

Responses

200

OK

No content

400

Bad Request

text/plainapplication/jsontext/json

post

HTTPcURLJavaScriptPython

POST /v1/savedsearches HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 391

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "OwnerUserUid": "text",
  "Name": "text",
  "SearchEntityTypeModel": 1,
  "GlobalListUid": "123e4567-e89b-12d3-a456-426614174000",
  "FolderUid": "123e4567-e89b-12d3-a456-426614174000",
  "Query": {
    "BooleanOperator": 0
  },
  "SortOrder": 1,
  "ViewColumns": [
    {
      "FieldUid": "text",
      "Width": 1
    }
  ],
  "EnableTimeline": true,
  "TimelineBusinessUnits": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

No content

Update a saved search

patch

Authorizations

ApiKey

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

Model to update a saved search in the api

Uidstring · uuidOptional

Unique id if the saved search

OwnerUserUidstring | nullableOptional

The user who owns the saved search. If null, saved search is available to all users

Namestring | nullableOptional

Name of the saved search

SearchEntityTypeModelinteger · enumOptional

The type of saved search

• 1 = Category: Category type
• 2 = Product: Product type
• 3 = VariantGroup: VariantGroup type
• 4 = Variant: Variant type
• 5 = Asset: Asset type
• 6 = GlobalList: Globallist type

Possible values:

GlobalListUidstring · uuid | nullableOptional

Globallist uid of referencing globallist

FolderUidstring · uuid | nullableOptional

Folder id of the saved search

SortOrderinteger · int32Optional

Sortorder of the saved search

EnableTimelinebooleanOptional

Whether or not to enable the timeline

TimelineBusinessUnitsstring · uuid[] | nullableOptional

Business unit limitation for timeline calculation

Responses

200

OK

No content

400

Bad Request

text/plainapplication/jsontext/json

patch

HTTPcURLJavaScriptPython

PATCH /v1/savedsearches HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 391

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "OwnerUserUid": "text",
  "Name": "text",
  "SearchEntityTypeModel": 1,
  "GlobalListUid": "123e4567-e89b-12d3-a456-426614174000",
  "FolderUid": "123e4567-e89b-12d3-a456-426614174000",
  "Query": {
    "BooleanOperator": 0
  },
  "SortOrder": 1,
  "ViewColumns": [
    {
      "FieldUid": "text",
      "Width": 1
    }
  ],
  "EnableTimeline": true,
  "TimelineBusinessUnits": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

No content