For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

User Search Filters

Show user search filter

get

Returns a saved search filter by ID.

The response includes the filter name, owner, global flag, and criteria that can be reused in a search.

This endpoint loads the filter by ID and does not apply the owner-only restriction used by other endpoints.

Path parameters
idintegerRequired

User search filter ID

Responses
200

User search filter

application/json
get/api/business_concept_user_filters/{id}
GET /api/business_concept_user_filters/{id} HTTP/1.1
Accept: */*
{
  "data": {
    "filters": {
      "country": [
        "Sp"
      ]
    },
    "id": 12,
    "is_global": false,
    "name": "a",
    "user_id": 9702
  }
}

Delete user search filter (only owner)

delete

Deletes a saved search filter. Only the owner of the filter can remove it.

Path parameters
idintegerRequired

User search filter ID

Responses
204

User search filter deleted

No content

delete/api/business_concept_user_filters/{id}
DELETE /api/business_concept_user_filters/{id} HTTP/1.1
Accept: */*

No content

List user search filters for current user

get

Returns the search filters owned by the authenticated user, plus any global filters.

The result set is the union of:

  • filters owned by the caller (user_id matches), and

  • filters flagged as is_global.

When the caller is a non-admin jti user, the result is further filtered by domain: filters whose filters.taxonomy does not intersect with the caller's permitted domains under 'View published business concepts' are excluded.

If the caller has no 'View published business concepts' permission in any domain and the permission is not granted by default, the response is empty.

Responses
200

User search filters

application/json
get/api/business_concept_user_filters/me
GET /api/business_concept_user_filters/me HTTP/1.1
Accept: */*
{
  "data": [
    {
      "filters": {
        "country": [
          "Sp"
        ]
      },
      "id": 12,
      "is_global": false,
      "name": "a",
      "user_id": 9702
    },
    {
      "filters": {
        "country": [
          "Sp"
        ]
      },
      "id": 13,
      "is_global": false,
      "name": "b",
      "user_id": 9702
    }
  ]
}

List all user search filters

get

Returns all saved user search filters in the system.

The response includes filters owned by any user, including global filters.

To list only the caller's own filters plus globals, use the index_by_user endpoint instead.

Responses
200

User search filters

application/json
get/api/business_concept_user_filters
GET /api/business_concept_user_filters HTTP/1.1
Accept: */*
{
  "data": [
    {
      "filters": {
        "query": "customer",
        "type": "business_concept"
      },
      "id": 1,
      "name": "My filter",
      "user_id": 10
    }
  ]
}

Create user search filter

post

Creates a saved search filter for the authenticated user.

Set is_global to true only when the caller is allowed to create a global filter; it defaults to false when omitted.

Body
Responses
201

User search filter created

application/json
post/api/business_concept_user_filters
POST /api/business_concept_user_filters HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 118

{
  "user_search_filter": {
    "filters": {
      "query": "customer",
      "type": "business_concept"
    },
    "is_global": false,
    "name": "My filter"
  }
}
{
  "data": {
    "filters": {
      "query": "customer"
    },
    "id": 1,
    "inserted_at": "2026-05-22T10:00:00Z",
    "name": "My filter",
    "user_id": 10
  }
}

Last updated