logo_queries

Creates, updates, deletes, gets or lists a logo_queries resource.

Overview

Name	logo_queries
Type	Resource
Id	cloudflare.brand_protection.logo_queries

Fields

The following fields are returned by SELECT queries:

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
create	insert	account_id, tag, image_data, similarity_threshold		Create a new saved brand protection logo query for visual similarity matching
delete_by_account	delete	account_id, query_id		Delete a saved brand protection logo query. Returns 404 if the query ID doesn't exist.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
account_id	string	The Cloudflare account ID.
query_id	string

INSERT examples

create

Create a new saved brand protection logo query for visual similarity matching

INSERT INTO cloudflare.brand_protection.logo_queries (
image_data,
search_lookback,
similarity_threshold,
tag,
account_id
)
SELECT 
'{{ image_data }}' /* required */,
{{ search_lookback }},
{{ similarity_threshold }} /* required */,
'{{ tag }}' /* required */,
'{{ account_id }}'
RETURNING
query_id,
message,
success
;

Manifest

# Description fields are for documentation purposes
- name: logo_queries
props:
  - name: account_id
    value: "{{ account_id }}"
    description: Required parameter for the logo_queries resource.
  - name: image_data
    value: "{{ image_data }}"
    description: |
      Base64 encoded image data. Can include data URI prefix (e.g., 'data:image/png;base64,...') or just the base64 string.
  - name: search_lookback
    value: {{ search_lookback }}
    description: |
      If true, search historic scanned images for matches above the similarity threshold
    default: true
  - name: similarity_threshold
    value: {{ similarity_threshold }}
    description: |
      Minimum similarity score (0-1) required for visual matches
  - name: tag
    value: "{{ tag }}"
    description: |
      Unique identifier for the logo query

DELETE examples

delete_by_account

Delete a saved brand protection logo query. Returns 404 if the query ID doesn't exist.

DELETE FROM cloudflare.brand_protection.logo_queries
WHERE account_id = '{{ account_id }}' --required
AND query_id = '{{ query_id }}' --required
;