How do I use the search bar?
Learn how to use our powerful search functionality to find users, content ID results, API keys, and shortcuts with advanced filtering options.
Overview
Our search engine provides comprehensive querying across multiple resource types and includes a Domain-Specific Language (DSL) for advanced filtering. Whether you're looking for a specific item by identifier or searching across categories, our search delivers fast, accurate results.
Searchable Resources
You can search across the following resource types:
- Users — Find user accounts and profiles
- Content ID — Locate specific content by identifier, error or finding
- API Keys — Search for API authentication credentials
- Shortcuts — Find quick access shortcuts and aliases
Search Syntax
Our search uses a simple Domain-Specific Language (DSL) to help you refine your queries and target exactly what you need. The DSL supports direct ID lookups and category-based filtering.
Basic ID Search
To search for a specific item by its unique identifier, use the ID syntax.
Format: id:item_identifier
Example: id:file_1234 — Returns the specific file with identifier file_1234
Category-Based Search
Filter results by category to narrow your search to a specific resource type.
Format: category:type keyword
Examples:
category:contentId malware.foo— Finds all content items matching 'malware.foo'category:users Bob— Locates all users named Bobcategory:keys production— Retrieves all API keys labeled 'production'
User-Supplied Metadata Indexing
Attach custom key-value pairs to your ContentID analysis requests, and search by the metadata values you've supplied. Your metadata is securely indexed and searchable without exposing sensitive information.
Search Format: Search by the metadata value alone (e.g., search staging or acme-12345 —not the key)
Only the metadata values are indexed for searching. You don't need to include the key name in your search query.
Data Protection: We protect your privacy by indexing only the cryptographic hashes of your metadata values, not the original data. This means your actual metadata values are never stored in the search index—only secure hashes are indexed. When you search, we hash your query terms the same way and match them against the indexed hashes.
Important: Because we index only hashes of complete values, partial matches do not work. You must search for exact metadata values you've supplied.
Availability: User-supplied metadata indexing is currently available in the US1 region only. If you'd like to see this feature expanded to other regions, please contact support.
Examples
Here are real-world scenarios where metadata indexing helps:
- Environment tagging — Tag a content ID with
environment:production, then searchproductionto find all production resources - Team assignment — Add
team:security-opsto resources, then searchsecurity-opsto see everything that team owns - Cost center tracking — Mark resources with
cost_center:engineering-2024, then searchengineering-2024for billing and reporting - Workflow status — Add
status:in-reviewto track approval workflows, then searchin-reviewto find pending items - Customer IDs — Tag resources with
customer_id:acme-12345, then searchacme-12345to find all work for that customer - Project codes — Mark resources with
project:proj-2024-q1, then searchproj-2024-q1to find all related resources - Data classification — Add
classification:confidential, then searchconfidentialto find all sensitive resources - Geographic regions — Add
region:us-west, then searchus-westto organize resources by location
Need Help?
For questions about search functionality and metadata indexing, contact our support team.