UNPKG

@openforge/elastic-enterprise-search

Version:

Official Node.js client for Elastic Enterprise Search, App Search, and Workplace Search.

2,069 lines 54.8 kB
export interface GetAdaptiveRelevanceSettingsRequest { /** * Name of the engine */ engine_name: string; } export interface GetAdaptiveRelevanceSettingsResponse { curation: { enabled?: boolean; mode?: 'manual' | 'automatic'; timeframe?: number; max_size?: number; min_clicks?: number; schedule_unit?: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month'; schedule_frequency?: number; }; } export interface PutAdaptiveRelevanceSettingsRequest { /** * Name of the engine */ engine_name: string; body?: { curation: { enabled?: boolean; mode?: 'manual' | 'automatic'; timeframe?: number; max_size?: number; min_clicks?: number; schedule_unit?: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month'; schedule_frequency?: number; }; }; } export interface PutAdaptiveRelevanceSettingsResponse { curation: { enabled?: boolean; mode?: 'manual' | 'automatic'; timeframe?: number; max_size?: number; min_clicks?: number; schedule_unit?: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month'; schedule_frequency?: number; }; } export interface ListAdaptiveRelevanceSuggestionsRequest { /** * Name of the engine */ engine_name: string; body?: { page?: { current?: number; size?: number; }; filters?: { status?: Array<'pending' | 'applied' | 'automated' | 'rejected' | 'disabled'>; type?: 'curation'; }; }; } export type ListAdaptiveRelevanceSuggestionsResponse = Record<string, unknown>; export interface PutAdaptiveRelevanceSuggestionsRequest { /** * Name of the engine */ engine_name: string; body?: Array<{ query?: string; type?: 'curation'; status?: 'pending' | 'applied' | 'automated' | 'rejected' | 'disabled'; }>; } export interface PutAdaptiveRelevanceSuggestionsResponse { results?: Array<{ query?: string; type?: 'curation'; status?: 'pending' | 'applied' | 'automated' | 'rejected' | 'disabled'; errors: string[]; } | { query?: string; status?: 'pending' | 'applied' | 'automated' | 'rejected' | 'disabled'; updated_at?: string; created_at?: string; }>; } export interface GetAdaptiveRelevanceSuggestionsRequest { /** * Name of the engine */ engine_name: string; /** * Query to obtain suggestions */ search_suggestion_query: string; body?: { page?: { current?: number; size?: number; }; filters?: { status?: Array<'pending' | 'applied' | 'automated' | 'rejected' | 'disabled'>; type?: 'curation'; }; }; } export type GetAdaptiveRelevanceSuggestionsResponse = Record<string, unknown>; export interface RefreshAdaptiveRelevanceUpdateProcessRequest { /** * Name of the engine */ engine_name: string; /** * Adaptive relevance suggestion type */ adaptive_relevance_suggestion_type: 'curation'; } export type RefreshAdaptiveRelevanceUpdateProcessResponse = Record<string, unknown>; export interface GetTopClicksAnalyticsRequest { /** * Name of the engine */ engine_name: string; body?: { query?: string; filters?: { tag: string | string[]; } | { date: { to: string; from: string; }; } | { all: Array<{ tag: string | string[]; } | { date: { to: string; from: string; }; }>; }; page?: { size: number; }; }; } export interface GetTopClicksAnalyticsResponse { meta: { page: { current?: number; size?: number; }; }; results: Array<{ document_id: string; clicks: number; }>; } export interface GetCountAnalyticsRequest { /** * Name of the engine */ engine_name: string; body?: { filters?: { query: string; } | { document_id: string; } | { tag: string | string[]; } | { date: { to: string; from: string; }; } | { all: Array<{ query: string; } | { document_id: string; } | { tag: string | string[]; } | { date: { to: string; from: string; }; }>; }; interval?: string; }; } export interface GetCountAnalyticsResponse { results: Array<{ clicks: number; queries: number; from: string; to: string; }>; } export interface GetTopQueriesAnalyticsRequest { /** * Name of the engine */ engine_name: string; body?: { filters?: { clicks: boolean; } | { results: boolean; } | { tag: string | string[]; } | { date: { to: string; from: string; }; } | { all: Array<{ clicks: boolean; } | { results: boolean; } | { tag: string | string[]; } | { date: { to: string; from: string; }; }>; }; page?: { size: number; }; }; } export interface GetTopQueriesAnalyticsResponse { meta: { page: { current?: number; size?: number; }; }; results: Array<{ term: string; clicks: number; queries: number; }>; } export interface LogClickthroughRequest { /** * Name of the engine */ engine_name: string; body?: { query: string; request_id?: string; document_id: string; tags?: string[]; }; } export type LogClickthroughResponse = Record<string, unknown>; export interface GetCrawlerUrlExtractionResultRequest { /** * Name of the engine */ engine_name: string; body: string; } export interface GetCrawlerUrlExtractionResultResponse { url: string; normalized_url: string; results: { download: { status_code: number; redirect_location?: string; error?: string; }; extraction: { content_hash: string; content_hash_fields: string[]; content_fields: {}; meta_tag_warnings: Array<{ name: string; value: string; error: string; message: string; }>; }; indexing: { document_id: string; document_fields: {}; }; deduplication: { urls_count: number; urls_sample: string[]; }; }; } export interface CreateCrawlerCrawlRequestRequest { /** * Name of the engine */ engine_name: string; body?: { overrides: { max_crawl_depth?: number; sitemap_discovery_disabled?: boolean; domain_allowlist?: string[]; seed_urls?: string[]; sitemap_urls?: string[]; }; }; } export interface CreateCrawlerCrawlRequestResponse { id: string; type?: 'full' | 'partial'; status: 'success' | 'failed' | 'canceled' | 'skipped' | 'pending' | 'suspended' | 'starting' | 'running' | 'canceling' | 'suspending'; created_at: string; begun_at: string; completed_at: string; } export interface ListCrawlerCrawlRequestsRequest { /** * Name of the engine */ engine_name: string; page?: { /** * The page to fetch. Defaults to 1 */ current?: number; /** * The number of results per page */ size?: number; }; } export interface ListCrawlerCrawlRequestsResponse { meta: { page: { current: number; total_pages: number; total_results: number; size: number; }; }; results: Array<{ id: string; type?: 'full' | 'partial'; status: 'success' | 'failed' | 'canceled' | 'skipped' | 'pending' | 'suspended' | 'starting' | 'running' | 'canceling' | 'suspending'; created_at: string; begun_at: string; completed_at: string; }>; } export interface GetCrawlerCrawlRequestRequest { /** * Name of the engine */ engine_name: string; /** * Crawl Request ID */ crawl_request_id: string; } export type GetCrawlerCrawlRequestResponse = { id: string; type?: 'full' | 'partial'; status: 'success' | 'failed' | 'canceled' | 'skipped' | 'pending' | 'suspended' | 'starting' | 'running' | 'canceling' | 'suspending'; created_at: string; begun_at: string; completed_at: string; } & { crawl_config?: { allOf?: [ { type: 'object'; properties: { max_crawl_depth: { type: 'integer'; }; sitemap_discovery_disabled: { type: 'boolean'; }; domain_allowlist: { type: 'array'; items: { type: 'string'; }; }; seed_urls: { type: 'array'; items: { type: 'string'; }; }; sitemap_urls: { type: 'array'; items: { type: 'string'; }; }; }; additionalProperties: false; } ]; crawl_rules?: Array<{}>; deduplication_settings?: Array<{}>; }; stats: { [k: string]: unknown; } | null; }; export interface GetCrawlerActiveCrawlRequestRequest { /** * Name of the engine */ engine_name: string; } export type GetCrawlerActiveCrawlRequestResponse = { id: string; type?: 'full' | 'partial'; status: 'success' | 'failed' | 'canceled' | 'skipped' | 'pending' | 'suspended' | 'starting' | 'running' | 'canceling' | 'suspending'; created_at: string; begun_at: string; completed_at: string; } & { crawl_config?: { allOf?: [ { type: 'object'; properties: { max_crawl_depth: { type: 'integer'; }; sitemap_discovery_disabled: { type: 'boolean'; }; domain_allowlist: { type: 'array'; items: { type: 'string'; }; }; seed_urls: { type: 'array'; items: { type: 'string'; }; }; sitemap_urls: { type: 'array'; items: { type: 'string'; }; }; }; additionalProperties: false; } ]; crawl_rules?: Array<{}>; deduplication_settings?: Array<{}>; }; stats: { [k: string]: unknown; } | null; }; export interface DeleteCrawlerActiveCrawlRequestRequest { /** * Name of the engine */ engine_name: string; } export interface DeleteCrawlerActiveCrawlRequestResponse { id: string; type?: 'full' | 'partial'; status: 'success' | 'failed' | 'canceled' | 'skipped' | 'pending' | 'suspended' | 'starting' | 'running' | 'canceling' | 'suspending'; created_at: string; begun_at: string; completed_at: string; } export interface CreateCrawlerCrawlRuleRequest { /** * Name of the engine */ engine_name: string; /** * Crawler Domain ID */ domain_id: string; body?: { id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; }; } export interface CreateCrawlerCrawlRuleResponse { id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; } export interface PutCrawlerCrawlRuleRequest { /** * Name of the engine */ engine_name: string; /** * Crawler Domain ID */ domain_id: string; /** * Crawl Rule ID */ crawl_rule_id: string; body?: { id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; }; } export interface PutCrawlerCrawlRuleResponse { id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; } export interface DeleteCrawlerCrawlRuleRequest { /** * Name of the engine */ engine_name: string; /** * Crawler Domain ID */ domain_id: string; /** * Crawl Rule ID */ crawl_rule_id: string; } export interface DeleteCrawlerCrawlRuleResponse { deleted: boolean; } export interface GetCrawlerCrawlScheduleRequest { /** * Name of the engine */ engine_name: string; } export type GetCrawlerCrawlScheduleResponse = { frequency: number; unit: 'hour' | 'day' | 'week' | 'month'; } & { engine: string; }; export interface PutCrawlerCrawlScheduleRequest { /** * Name of the engine */ engine_name: string; body?: { frequency: number; unit: 'hour' | 'day' | 'week' | 'month'; }; } export type PutCrawlerCrawlScheduleResponse = { frequency: number; unit: 'hour' | 'day' | 'week' | 'month'; } & { engine: string; }; export interface DeleteCrawlerCrawlScheduleRequest { /** * Name of the engine */ engine_name: string; } export interface DeleteCrawlerCrawlScheduleResponse { deleted: boolean; } export interface GetCrawlerProcessCrawlDeniedUrlsRequest { /** * Name of the engine */ engine_name: string; /** * Process Crawl identifier */ process_crawl_id: string; } export interface GetCrawlerProcessCrawlDeniedUrlsResponse { /** * Total count of URLs analyzed by process crawl */ total_url_count?: number; /** * Total count of URLs identified for deletion by process crawl */ denied_url_count?: number; /** * Count of denied URLs provided in sample */ sample_size?: number; /** * Sample of URLs identified for deletion by process crawl */ denied_urls_sample?: string[]; } export interface ListCrawlerDomainsRequest { /** * Name of the engine */ engine_name: string; page?: { /** * The page to fetch. Defaults to 1 */ current?: number; /** * The number of results per page */ size?: number; }; } export interface ListCrawlerDomainsResponse { meta: { page: { current: number; total_pages: number; total_results: number; size: number; }; }; results: Array<{ name?: string; entry_points?: Array<{ id?: string; value: string; created_at?: string; }>; crawl_rules?: Array<{ id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; }>; sitemaps?: Array<{ id?: string; url: string; created_at?: string; }>; } & { id?: string; document_count?: number; deduplication_enabled?: boolean; deduplication_fields?: string[]; available_deduplication_fields?: string[]; auth?: null | { type: 'basic'; username: string; password: string; } | { type: 'raw'; header: string; }; created_at?: string; last_visited_at?: string; default_crawl_rule?: { id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; }; }>; } export interface CreateCrawlerDomainRequest { /** * Name of the engine */ engine_name: string; body?: { name?: string; entry_points?: Array<{ id?: string; value: string; created_at?: string; }>; crawl_rules?: Array<{ id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; }>; sitemaps?: Array<{ id?: string; url: string; created_at?: string; }>; }; } export type CreateCrawlerDomainResponse = { name?: string; entry_points?: Array<{ id?: string; value: string; created_at?: string; }>; crawl_rules?: Array<{ id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; }>; sitemaps?: Array<{ id?: string; url: string; created_at?: string; }>; } & { id?: string; document_count?: number; deduplication_enabled?: boolean; deduplication_fields?: string[]; available_deduplication_fields?: string[]; auth?: null | { type: 'basic'; username: string; password: string; } | { type: 'raw'; header: string; }; created_at?: string; last_visited_at?: string; default_crawl_rule?: { id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; }; }; export interface GetCrawlerDomainRequest { /** * Name of the engine */ engine_name: string; /** * Crawler Domain ID */ domain_id: string; } export type GetCrawlerDomainResponse = { name?: string; entry_points?: Array<{ id?: string; value: string; created_at?: string; }>; crawl_rules?: Array<{ id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; }>; sitemaps?: Array<{ id?: string; url: string; created_at?: string; }>; } & { id?: string; document_count?: number; deduplication_enabled?: boolean; deduplication_fields?: string[]; available_deduplication_fields?: string[]; auth?: null | { type: 'basic'; username: string; password: string; } | { type: 'raw'; header: string; }; created_at?: string; last_visited_at?: string; default_crawl_rule?: { id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; }; }; export interface PutCrawlerDomainRequest { /** * Name of the engine */ engine_name: string; /** * Crawler Domain ID */ domain_id: string; body?: { name?: string; entry_points?: Array<{ id?: string; value: string; created_at?: string; }>; crawl_rules?: Array<{ id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; }>; sitemaps?: Array<{ id?: string; url: string; created_at?: string; }>; }; } export type PutCrawlerDomainResponse = { name?: string; entry_points?: Array<{ id?: string; value: string; created_at?: string; }>; crawl_rules?: Array<{ id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; }>; sitemaps?: Array<{ id?: string; url: string; created_at?: string; }>; } & { id?: string; document_count?: number; deduplication_enabled?: boolean; deduplication_fields?: string[]; available_deduplication_fields?: string[]; auth?: null | { type: 'basic'; username: string; password: string; } | { type: 'raw'; header: string; }; created_at?: string; last_visited_at?: string; default_crawl_rule?: { id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; }; }; export interface DeleteCrawlerDomainRequest { /** * Name of the engine */ engine_name: string; /** * Crawler Domain ID */ domain_id: string; } export interface DeleteCrawlerDomainResponse { deleted: boolean; } export interface CreateCrawlerEntryPointRequest { /** * Name of the engine */ engine_name: string; /** * Crawler Domain ID */ domain_id: string; body?: { id?: string; value: string; created_at?: string; }; } export interface CreateCrawlerEntryPointResponse { id?: string; value: string; created_at?: string; } export interface PutCrawlerEntryPointRequest { /** * Name of the engine */ engine_name: string; /** * Crawler Domain ID */ domain_id: string; /** * Crawler Entry Point identifier */ entry_point_id: string; body?: { id?: string; value: string; created_at?: string; }; } export interface PutCrawlerEntryPointResponse { id?: string; value: string; created_at?: string; } export interface DeleteCrawlerEntryPointRequest { /** * Name of the engine */ engine_name: string; /** * Crawler Domain ID */ domain_id: string; /** * Crawler Entry Point identifier */ entry_point_id: string; } export interface DeleteCrawlerEntryPointResponse { deleted: boolean; } export interface GetCrawlerMetricsRequest { } export interface GetCrawlerMetricsResponse { global: { crawl_requests: { pending: number; active: number; successful: number; failed: number; }; }; node: { workers: { pool_size: number; active: number; available: number; }; active_crawls: Array<{ worker_id?: string; worker_running?: boolean; crawl_request?: { id: string; status: 'success' | 'failed' | 'canceled' | 'skipped' | 'pending' | 'suspended' | 'starting' | 'running' | 'canceling' | 'suspending'; created_at: string; updated_at: string; begun_at: string; engine: { id: string; name: string; }; }; crawl_status?: { queue_size?: number; pages_visited?: number; urls_allowed?: number; crawl_duration_msec?: { [k: string]: unknown; }; crawling_time_msec?: { [k: string]: unknown; }; avg_response_time_msec?: { [k: string]: unknown; }; active_threads?: number; urls_denied?: { [k: string]: number; }; status_codes?: { [k: string]: number; }; http_client?: { max_connections?: number; used_connections?: number; }; }; purge_crawl_status?: { queue_size?: number; pages_visited?: number; urls_allowed?: number; crawl_duration_msec?: { [k: string]: unknown; }; crawling_time_msec?: { [k: string]: unknown; }; avg_response_time_msec?: { [k: string]: unknown; }; active_threads?: number; urls_denied?: { [k: string]: number; }; status_codes?: { [k: string]: number; }; http_client?: { max_connections?: number; used_connections?: number; }; }; }>; stats: { active_threads?: number; pages_visited?: number; urls_allowed?: number; queue_size?: { primary: number; purge: number; }; urls_denied?: { [k: string]: number; }; status_codes?: { [k: string]: number; }; }; }; } export interface GetCrawlerOverviewRequest { /** * Name of the engine */ engine_name: string; } export interface GetCrawlerOverviewResponse { domains: Array<{ name?: string; entry_points?: Array<{ id?: string; value: string; created_at?: string; }>; crawl_rules?: Array<{ id?: string; order: number; policy: 'allow' | 'deny'; rule: 'begins' | 'ends' | 'contains' | 'regex'; pattern: string; created_at?: string; }>; sitemaps?: Array<{ id?: string; url: string; created_at?: string; }>; }>; events: Array<{}>; most_recent_crawl_request: null | { id: string; type?: 'full' | 'partial'; status: 'success' | 'failed' | 'canceled' | 'skipped' | 'pending' | 'suspended' | 'starting' | 'running' | 'canceling' | 'suspending'; created_at: string; begun_at: string; completed_at: string; }; } export interface CreateCrawlerProcessCrawlRequest { /** * Name of the engine */ engine_name: string; body?: { dry_run?: boolean; domains?: string[]; }; } export interface CreateCrawlerProcessCrawlResponse { id?: string; dry_run?: boolean; total_url_count?: number; denied_url_count?: number; domains?: string[]; process_all_domains?: boolean; created_at?: string; begun_at?: string; completed_at?: string; } export interface ListCrawlerProcessCrawlsRequest { /** * Name of the engine */ engine_name: string; page?: { /** * The page to fetch. Defaults to 1 */ current?: number; /** * The number of results per page */ size?: number; }; } export interface ListCrawlerProcessCrawlsResponse { meta: { page: { current: number; total_pages: number; total_results: number; size: number; }; }; results: Array<{ id?: string; dry_run?: boolean; total_url_count?: number; denied_url_count?: number; domains?: string[]; process_all_domains?: boolean; created_at?: string; begun_at?: string; completed_at?: string; }>; } export interface GetCrawlerProcessCrawlRequest { /** * Name of the engine */ engine_name: string; /** * Process Crawl identifier */ process_crawl_id: string; } export interface GetCrawlerProcessCrawlResponse { id?: string; dry_run?: boolean; total_url_count?: number; denied_url_count?: number; domains?: string[]; process_all_domains?: boolean; created_at?: string; begun_at?: string; completed_at?: string; } export interface CreateCrawlerSitemapRequest { /** * Name of the engine */ engine_name: string; /** * Crawler Domain ID */ domain_id: string; body?: { id?: string; url: string; created_at?: string; }; } export interface CreateCrawlerSitemapResponse { id?: string; url: string; created_at?: string; } export interface PutCrawlerSitemapRequest { /** * Name of the engine */ engine_name: string; /** * Crawler Domain ID */ domain_id: string; /** * Sitemap ID */ sitemap_id: string; body?: { id?: string; url: string; created_at?: string; }; } export interface PutCrawlerSitemapResponse { id?: string; url: string; created_at?: string; } export interface DeleteCrawlerSitemapRequest { /** * Name of the engine */ engine_name: string; /** * Crawler Domain ID */ domain_id: string; /** * Sitemap ID */ sitemap_id: string; } export interface DeleteCrawlerSitemapResponse { deleted: boolean; } export interface GetCrawlerUrlTracingResultRequest { /** * Name of the engine */ engine_name: string; body: string; } export interface GetCrawlerUrlTracingResultResponse { url: string; normalized_url: string; crawl_requests: Array<{ crawl_request: { id: string; type?: 'full' | 'partial'; status: 'success' | 'failed' | 'canceled' | 'skipped' | 'pending' | 'suspended' | 'starting' | 'running' | 'canceling' | 'suspending'; created_at: string; begun_at: string; completed_at: string; }; found: boolean; discover: Array<{ timestamp: string; event_id: string; message: string; } & { event_type: string; crawl_depth: number; source_url: string; deny_reason: string; }>; seed: { timestamp: string; event_id: string; message: string; } & { url_type: string; source_type: string; source_url: string; }; fetch: { timestamp: string; event_id: string; message: string; } & { event_outcome: string; duration_msec: { [k: string]: unknown; }; http_response: { status_code: number; body_bytes: number; }; redirect: { timestamp: string; event_id: string; message: string; } & { location: string; count: number; chain: string[]; }; }; output: { timestamp: string; event_id: string; message: string; } & { event_outcome?: string; output_module?: string; duration_msec?: { [k: string]: unknown; }; engine?: { id: string; name: string; }; document?: { id: string; }; }; }>; } export interface GetCrawlerUrlValidationResultRequest { /** * Name of the engine */ engine_name: string; body: string; } export interface GetCrawlerUrlValidationResultResponse { url: string; normalized_url: string; valid: boolean; results: Array<{ name: string; result: string; comment: string; details?: {}; }>; } export interface GetCrawlerDomainValidationResultRequest { body: string; } export interface GetCrawlerDomainValidationResultResponse { url: string; normalized_url: string; valid: boolean; results: Array<{ name: string; result: string; comment: string; details?: {}; }>; } export interface GetCrawlerUserAgentRequest { } export interface GetCrawlerUserAgentResponse { user_agent: string; } export interface ListApiKeysRequest { page?: { /** * The page to fetch. Defaults to 1 */ current?: number; /** * The number of results per page */ size?: number; }; } export interface ListApiKeysResponse { meta: { page: { current: number; total_pages: number; total_results: number; size: number; }; }; results: Array<{ id?: string; name: string; type: 'private' | 'search' | 'admin'; access_all_engines?: boolean; engines?: string[]; write?: boolean; read?: boolean; }>; } export interface CreateApiKeyRequest { /** * Details of an API key */ body?: { id?: string; name: string; type: 'private' | 'search' | 'admin'; access_all_engines?: boolean; engines?: string[]; write?: boolean; read?: boolean; }; } /** * Details of an API key */ export interface CreateApiKeyResponse { id?: string; name: string; type: 'private' | 'search' | 'admin'; access_all_engines?: boolean; engines?: string[]; write?: boolean; read?: boolean; } export interface GetApiKeyRequest { /** * Name of an API key */ api_key_name: string; } /** * Details of an API key */ export interface GetApiKeyResponse { id?: string; name: string; type: 'private' | 'search' | 'admin'; access_all_engines?: boolean; engines?: string[]; write?: boolean; read?: boolean; } export interface PutApiKeyRequest { /** * Name of an API key */ api_key_name: string; /** * Details of an API key */ body?: { id?: string; name: string; type: 'private' | 'search' | 'admin'; access_all_engines?: boolean; engines?: string[]; write?: boolean; read?: boolean; }; } /** * Details of an API key */ export interface PutApiKeyResponse { id?: string; name: string; type: 'private' | 'search' | 'admin'; access_all_engines?: boolean; engines?: string[]; write?: boolean; read?: boolean; } export interface DeleteApiKeyRequest { /** * Name of an API key */ api_key_name: string; } export interface DeleteApiKeyResponse { deleted: boolean; } export interface ListCurationsRequest { /** * Name of the engine */ engine_name: string; page?: { /** * The page to fetch. Defaults to 1 */ current?: number; /** * The number of results per page */ size?: number; }; } export interface ListCurationsResponse { meta: { page: { current: number; total_pages: number; total_results: number; size: number; }; }; results: Array<{ id?: string; /** * List of affected search queries */ queries: string[]; /** * List of promoted document IDs */ promoted?: string[]; /** * List of hidden document IDs */ hidden?: string[]; suggestion?: { query?: string; status?: 'pending' | 'applied' | 'automated' | 'rejected' | 'disabled'; updated_at?: string; created_at?: string; }; }>; } export interface CreateCurationRequest { /** * Name of the engine */ engine_name: string; body?: { id?: string; /** * List of affected search queries */ queries: string[]; /** * List of promoted document IDs */ promoted?: string[]; /** * List of hidden document IDs */ hidden?: string[]; suggestion?: { query?: string; status?: 'pending' | 'applied' | 'automated' | 'rejected' | 'disabled'; updated_at?: string; created_at?: string; }; }; } export interface CreateCurationResponse { id: string; } export interface GetCurationRequest { /** * Name of the engine */ engine_name: string; /** * Curation ID */ curation_id: string; } export interface GetCurationResponse { id?: string; /** * List of affected search queries */ queries: string[]; /** * List of promoted document IDs */ promoted?: string[]; /** * List of hidden document IDs */ hidden?: string[]; suggestion?: { query?: string; status?: 'pending' | 'applied' | 'automated' | 'rejected' | 'disabled'; updated_at?: string; created_at?: string; }; } export interface PutCurationRequest { /** * Name of the engine */ engine_name: string; /** * Curation ID */ curation_id: string; body?: { id?: string; /** * List of affected search queries */ queries: string[]; /** * List of promoted document IDs */ promoted?: string[]; /** * List of hidden document IDs */ hidden?: string[]; suggestion?: { query?: string; status?: 'pending' | 'applied' | 'automated' | 'rejected' | 'disabled'; updated_at?: string; created_at?: string; }; }; } export interface PutCurationResponse { id: string; } export interface DeleteCurationRequest { /** * Name of the engine */ engine_name: string; /** * Curation ID */ curation_id: string; } export interface DeleteCurationResponse { deleted: boolean; } export interface GetDocumentsRequest { /** * Name of the engine */ engine_name: string; /** * List of Document IDs to fetch */ ids?: unknown[]; documentIds?: string[]; } export type GetDocumentsResponse = Array<null | { [k: string]: unknown; }>; export interface IndexDocumentsRequest { /** * Name of the engine */ engine_name: string; documents?: Array<{ [k: string]: unknown; }>; } export type IndexDocumentsResponse = Array<{ id: string; }>; export interface DeleteDocumentsRequest { /** * Name of the engine */ engine_name: string; documentIds?: string[]; } export type DeleteDocumentsResponse = Array<{ id: string; deleted: boolean; }>; export interface PutDocumentsRequest { /** * Name of the engine */ engine_name: string; documents?: Array<{ [k: string]: unknown; }>; } export type PutDocumentsResponse = Array<{ id: string; }>; export interface ListDocumentsRequest { /** * Name of the engine */ engine_name: string; page?: { /** * The page to fetch. Defaults to 1 */ current?: number; /** * The number of results per page */ size?: number; }; } export interface ListDocumentsResponse { meta: { page: { current: number; total_pages: number; total_results: number; size: number; }; }; results: Array<{ [k: string]: unknown; }>; } export interface ListEnginesRequest { page?: { /** * The page to fetch. Defaults to 1 */ current?: number; /** * The number of results per page */ size?: number; }; } export interface ListEnginesResponse { meta: { page: { current: number; total_pages: number; total_results: number; size: number; }; }; results: Array<{ name: string; /** * Engine language (null for universal) */ language?: 'da' | 'de' | 'en' | 'es' | 'fr' | 'it' | 'ja' | 'ko' | 'nl' | 'pt' | 'pt-br' | 'ru' | 'th' | 'zh' | null; /** * Engine type */ type?: 'meta' | 'default'; source_engines?: string[]; document_count?: number; index_create_settings_override?: { number_of_shards?: number; }; }>; } export interface CreateEngineRequest { body?: { name: string; /** * Engine language (null for universal) */ language?: 'da' | 'de' | 'en' | 'es' | 'fr' | 'it' | 'ja' | 'ko' | 'nl' | 'pt' | 'pt-br' | 'ru' | 'th' | 'zh' | null; /** * Engine type */ type?: 'meta' | 'default'; source_engines?: string[]; document_count?: number; index_create_settings_override?: { number_of_shards?: number; }; }; } export interface CreateEngineResponse { name: string; /** * Engine language (null for universal) */ language?: 'da' | 'de' | 'en' | 'es' | 'fr' | 'it' | 'ja' | 'ko' | 'nl' | 'pt' | 'pt-br' | 'ru' | 'th' | 'zh' | null; /** * Engine type */ type?: 'meta' | 'default'; source_engines?: string[]; document_count?: number; index_create_settings_override?: { number_of_shards?: number; }; } export interface GetEngineRequest { /** * Name of the engine */ engine_name: string; } export interface GetEngineResponse { name: string; /** * Engine language (null for universal) */ language?: 'da' | 'de' | 'en' | 'es' | 'fr' | 'it' | 'ja' | 'ko' | 'nl' | 'pt' | 'pt-br' | 'ru' | 'th' | 'zh' | null; /** * Engine type */ type?: 'meta' | 'default'; source_engines?: string[]; document_count?: number; index_create_settings_override?: { number_of_shards?: number; }; } export interface DeleteEngineRequest { /** * Name of the engine */ engine_name: string; } export interface DeleteEngineResponse { deleted: boolean; } export interface DeleteMetaEngineSourceRequest { /** * Name of the engine */ engine_name: string; sourceEngines?: string[]; } export interface DeleteMetaEngineSourceResponse { name: string; /** * Engine language (null for universal) */ language?: 'da' | 'de' | 'en' | 'es' | 'fr' | 'it' | 'ja' | 'ko' | 'nl' | 'pt' | 'pt-br' | 'ru' | 'th' | 'zh' | null; /** * Engine type */ type?: 'meta' | 'default'; source_engines?: string[]; document_count?: number; index_create_settings_override?: { number_of_shards?: number; }; } export interface AddMetaEngineSourceRequest { /** * Name of the engine */ engine_name: string; sourceEngines?: string[]; } export interface AddMetaEngineSourceResponse { name: string; /** * Engine language (null for universal) */ language?: 'da' | 'de' | 'en' | 'es' | 'fr' | 'it' | 'ja' | 'ko' | 'nl' | 'pt' | 'pt-br' | 'ru' | 'th' | 'zh' | null; /** * Engine type */ type?: 'meta' | 'default'; source_engines?: string[]; document_count?: number; index_create_settings_override?: { number_of_shards?: number; }; } export interface SearchEsSearchRequest { /** * Name of the engine */ engine_name: string; /** * Query parameters to be passed to Elasticsearch _search API */ es_search_query_params?: { [k: string]: unknown; }; /** * The search query associated with this request when recording search analytics */ 'X-Enterprise-Search-Analytics'?: { [k: string]: unknown; }; /** * Analytics tags to be applied with this search request */ 'X-Enterprise-Search-Analytics-Tags'?: { [k: string]: unknown; }; /** * The Elasticsearch token API */ Authorization: { [k: string]: unknown; }; body?: {}; } export type SearchEsSearchResponse = Record<string, unknown>; export interface GetApiLogsRequest { /** * Name of the engine */ engine_name: string; body?: { filters: { date: { from: string; to: string; }; status?: number; method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'; }; page?: { total_results?: number; size?: number; }; query?: string; sort_direction?: 'asc' | 'desc'; }; } export interface GetApiLogsResponse { results?: Array<{}>; meta?: { page: { current: number; total_pages: number; total_results: number; size: number; }; } & { query?: string; filters?: { date: { from: string; to: string; }; status?: number; method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'; }; sort_direction?: 'asc' | 'desc'; }; } export interface QuerySuggestionRequest { /** * Name of the engine */ engine_name: string; body?: { query?: string; types?: { documents?: { fields?: string[]; [k: string]: unknown; }; [k: string]: unknown; }; size?: number; }; } export interface QuerySuggestionResponse { results?: { documents?: Array<{ suggestion?: string; }>; [k: string]: unknown; }; meta?: {}; } export interface GetSchemaRequest { /** * Name of the engine */ engine_name: string; } export interface GetSchemaResponse { [k: string]: string; } export interface PutSchemaRequest { /** * Name of the engine */ engine_name: string; schema?: { [k: string]: 'text' | 'number' | 'date' | 'geolocation'; }; } export interface PutSchemaResponse { [k: string]: string; } export interface SearchRequest { /** * Name of the engine */ engine_name: string; body?: { query: string; analytics?: {}; boosts?: {}; facets?: {}; filters?: {}; group?: {}; page?: { current?: number; size?: number; }; result_fields?: {}; search_fields?: { [k: string]: { weight?: number; }; }; sort?: Array<{ [k: string]: ('asc' | 'desc') | { center?: string | Array<{ [k: string]: unknown; }>; order?: 'asc' | 'desc'; mode?: 'min' | 'max' | 'median' | 'avg'; }; }>; }; } export interface SearchResponse { meta: { page: { current: number; total_pages: number; total_results: number; size: number; }; } & { alerts: string[]; warnings: string[]; precision?: number; engine: { name?: string; /** * Engine type */ type?: 'meta' | 'default'; }; request_id?: string; }; results: Array<{}>; } export interface MultiSearchRequest { /** * Name of the engine */ engine_name: string; body?: { queries: Array<{ query: string; analytics?: {}; boosts?: {}; facets?: {}; filters?: {}; group?: {}; page?: { current?: number; size?: number; }; result_fields?: {}; search_fields?: { [k: string]: { weight?: number; }; }; sort?: Array<{ [k: string]: ('asc' | 'desc') | { center?: string | Array<{ [k: string]: unknown; }>; order?: