Skip to navigation

Search

Beta

Searches models, model fields, model syncs, bulk syncs, and connections in the caller’s organization.

Supply a nonblank search term to search all five result categories. Unlike entity lookup, this endpoint does not search Organizations, users, executions, Harbors, or Harbor contexts. Model fields are searchable but have no standalone lookup endpoint.

Searchable resources

  • Models: ID, name, and source Connection type.
  • Model fields: ID, technical name, and label.
  • Model Syncs: ID, name, source and target Connection types, and saved field and identity mappings. Mappings include source field names and labels, target field IDs, and available target field names.
  • Bulk Syncs: ID, name, source and target Connection names and types, and enabled schema IDs, display names, and configured output names. Disabled schemas are excluded; enabled schemas remain searchable when the sync is inactive.
  • Connections: ID and name.

Search uses cached metadata and does not refresh schemas. Names absent from that metadata are not searchable. Bulk Sync fields, execution state, expressions, filters, and constant values are not searched.

Matching and evidence

Matching is case-insensitive and uses word prefixes, not fuzzy matching. Every query word must match somewhere within a result. Spaces and punctuation split words: other emails matches other_emails, but mail does not match email. Some Model Sync source-type matches require a leading ~.

Each resource appears once. Its matches explain which attributes matched and which query terms contributed. Mapping and schema attributes carry their respective mapping or schema context; resource metadata has neither. A name or Connection type match alone does not establish mapping or schema use. Results include canonical links, not complete configurations or schema lists.

Limits and completeness

Results are ordered by category, then name or field label, then ID, not by relevance. limit defaults to 50 and accepts 1–100. It limits resource hits, not match evidence. When metadata.truncated is true, narrow your search or increase the limit. There is no cursor pagination.

⚠️ Incomplete model-field coverage

Above 40,000 published model fields, metadata.model_fields_complete is false: standalone field results cover a subset, not every published field. Model Sync mapping search is unaffected. Incomplete or truncated results cannot establish that no other matches exist.

Authentication

AuthorizationBearer
Bearer user API key
OR
AuthorizationBasic

Basic organization-scoped API key

Headers

X-Polytomic-VersionstringOptional

Query parameters

searchstringRequired>=1 character
Search term matched, by word prefix, against models, model fields, model syncs, bulk syncs, and connections in the caller's organization.
limitintegerOptional1-100Defaults to 50
Maximum number of results to return across all result types. Defaults to 50 and cannot exceed 100.

Response

OK
datalist of objects or nullOptional
metadataobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error