# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Elastic Cloud Enterprise Platform Infrastructure API version: 1.0.0 extends: openapi/elk-stack-platforminfrastructure-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 83 - target: $.paths['/platform/configuration/api_base_url'].get update: x-apievangelist-phrasing: intent: Get the platform API base URL effect: read questions: - What API base URL is configured for my Elastic Cloud Enterprise platform? - Where can I check the base URL the platform advertises for its API? instructions: - text: Show the configured API base URL. - text: Tell me what the platform's API base URL is set to. method: generated generated: '2026-09-26' - target: $.paths['/platform/configuration/api_base_url'].put update: x-apievangelist-phrasing: intent: Set the platform API base URL effect: write questions: - How do I change the API base URL for my ECE installation? - Can I update the base URL without re-provisioning the Security cluster? instructions: - text: Set the API base URL to {value}. slots: value: requestBody.value - text: Change the platform API base URL to {value} with skip_cascading_operations {skip_cascading_operations}. slots: value: requestBody.value skip_cascading_operations: query.skip_cascading_operations method: generated generated: '2026-09-26' - target: $.paths['/platform/configuration/store'].get update: x-apievangelist-phrasing: intent: List Config Store options effect: read questions: - What options are stored in the platform Config Store? - How do I see every Config Store setting currently defined? instructions: - text: List all Config Store options. - text: Show everything saved in the platform configuration store. method: generated generated: '2026-09-26' - target: $.paths['/platform/configuration/store/{config_option_id}'].get update: x-apievangelist-phrasing: intent: Get a Config Store option by name effect: read questions: - How do I read the value of one Config Store option? - Can I look up a single configuration store entry by its name? instructions: - text: Get Config Store option {config_option_id}. slots: config_option_id: path.config_option_id - text: Read the value held by store option {config_option_id}. slots: config_option_id: path.config_option_id method: generated generated: '2026-09-26' - target: $.paths['/platform/configuration/store/{config_option_id}'].put update: x-apievangelist-phrasing: intent: Update an existing Config Store option effect: write questions: - How do I change the value of a Config Store option that already exists? - Can I guard a Config Store update against conflicting edits with a version? instructions: - text: Update Config Store option {config_option_id} to {value}. slots: config_option_id: path.config_option_id value: requestBody.value - text: Change existing store option {config_option_id} to {value} only if it is at version {version}. slots: config_option_id: path.config_option_id value: requestBody.value version: query.version method: generated generated: '2026-09-26' - target: $.paths['/platform/configuration/store/{config_option_id}'].post update: x-apievangelist-phrasing: intent: Create a new Config Store option effect: write questions: - How do I add a brand-new option to the platform Config Store? - Can I insert a Config Store entry under a name I choose? instructions: - text: Create Config Store option {config_option_id} with value {value}. slots: config_option_id: path.config_option_id value: requestBody.value - text: Insert a new store entry named {config_option_id} set to {value}. slots: config_option_id: path.config_option_id value: requestBody.value method: generated generated: '2026-09-26' - target: $.paths['/platform/configuration/store/{config_option_id}'].delete update: x-apievangelist-phrasing: intent: Delete a Config Store option effect: destructive questions: - How do I remove an option from the Config Store? - Can I delete a configuration store entry by its name? instructions: - text: Delete Config Store option {config_option_id}. slots: config_option_id: path.config_option_id - text: Remove the {config_option_id} entry from the configuration store. slots: config_option_id: path.config_option_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/adminconsoles'].get update: x-apievangelist-phrasing: intent: List adminconsoles effect: read questions: - What adminconsole instances are running in my ECE installation? - How do I get an overview of all adminconsoles? instructions: - text: List all adminconsoles. - text: Give me an overview of every adminconsole instance. method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/adminconsoles/_reindex'].post update: x-apievangelist-phrasing: intent: Reindex regional indices effect: write questions: - How do I kick off a reindex of all the regional indices? - Can I rebuild the region indices from the adminconsole? instructions: - text: Start a reindex of all regional indices. - text: Rebuild every region index now. method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/adminconsoles/{adminconsole_id}/logging_settings'].get update: x-apievangelist-phrasing: intent: Get an adminconsole's logging settings effect: read questions: - What log levels is a particular adminconsole instance using? - How do I check the logging configuration of one adminconsole? instructions: - text: Show the logging settings for adminconsole {adminconsole_id}. slots: adminconsole_id: path.adminconsole_id - text: Tell me the log levels in effect on adminconsole {adminconsole_id}. slots: adminconsole_id: path.adminconsole_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/adminconsoles/{adminconsole_id}/logging_settings'].put update: x-apievangelist-phrasing: intent: Set an adminconsole's logging levels effect: write questions: - How do I override the log levels on an adminconsole instance? - Can I turn adminconsole logging up to DEBUG for troubleshooting? instructions: - text: Set the logging levels of adminconsole {adminconsole_id} to {logging_levels}. slots: adminconsole_id: path.adminconsole_id logging_levels: requestBody.logging_levels - text: Override adminconsole {adminconsole_id} log levels with {logging_levels}, replacing what is there. slots: adminconsole_id: path.adminconsole_id logging_levels: requestBody.logging_levels method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/adminconsoles/{adminconsole_id}/logging_settings'].delete update: x-apievangelist-phrasing: intent: Reset an adminconsole's logging to defaults effect: destructive questions: - How do I put an adminconsole's logging back to the default levels? - Can I clear the log level overrides on an adminconsole? instructions: - text: Reset adminconsole {adminconsole_id} logging to defaults. slots: adminconsole_id: path.adminconsole_id - text: Clear the log level overrides on adminconsole {adminconsole_id}. slots: adminconsole_id: path.adminconsole_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/adminconsoles/{adminconsole_id}/logging_settings'].patch update: x-apievangelist-phrasing: intent: Patch an adminconsole's logging settings effect: write questions: - Can I change just one log level on an adminconsole without resetting the rest? - How does a merge-patch of adminconsole logging handle null values? instructions: - text: Patch the logging settings of adminconsole {adminconsole_id}. slots: adminconsole_id: path.adminconsole_id - text: Merge-patch a single log level change into adminconsole {adminconsole_id}. slots: adminconsole_id: path.adminconsole_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators'].get update: x-apievangelist-phrasing: intent: List allocators effect: read questions: - How do I see all the allocators in my ECE platform? - Can I filter the allocator list with a query and page through it? instructions: - text: List all allocators. - text: List allocators matching {q}, {size} at a time. slots: q: query.q size: query.size method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/_resync'].post update: x-apievangelist-phrasing: intent: Resynchronize all allocators in the index effect: write questions: - How do I resync every allocator's information into the search index? - Can I skip reindexing allocators whose version already matches? instructions: - text: Resynchronize all allocators in the background. - text: Resync every allocator, skipping matching versions when skip_matching_version is {skip_matching_version}. slots: skip_matching_version: query.skip_matching_version method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/_search'].post update: x-apievangelist-phrasing: intent: Search allocators with a query effect: read questions: - Which allocators match an Elasticsearch query I write? - Can I page through allocator search results with a cursor? instructions: - text: Search allocators with query {query}. slots: query: requestBody.query - text: Get the next page of allocator search hits from cursor {cursor}. slots: cursor: requestBody.cursor method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}'].get update: x-apievangelist-phrasing: intent: Get an allocator effect: read questions: - How do I look up one allocator's details by ID? - What capacity and instances does a specific allocator have? instructions: - text: Get allocator {allocator_id}. slots: allocator_id: path.allocator_id - text: Show me the details of allocator {allocator_id}. slots: allocator_id: path.allocator_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}'].delete update: x-apievangelist-phrasing: intent: Delete an allocator effect: destructive questions: - How do I remove an allocator from the platform? - Can I delete an allocator and remove the instances on it at the same time? instructions: - text: Delete allocator {allocator_id}. slots: allocator_id: path.allocator_id - text: Delete allocator {allocator_id} and remove its instances, with remove_instances {remove_instances}. slots: allocator_id: path.allocator_id remove_instances: query.remove_instances method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/_resync'].post update: x-apievangelist-phrasing: intent: Resynchronize one allocator effect: write questions: - How do I refresh a single allocator in the search index and caches immediately? - Can I force one allocator's index entry to sync right away? instructions: - text: Resync allocator {allocator_id} now. slots: allocator_id: path.allocator_id - text: Refresh the index and cache entry for allocator {allocator_id}. slots: allocator_id: path.allocator_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/clusters/_move'].post update: x-apievangelist-phrasing: intent: Move clusters off an allocator effect: write questions: - How do I move clusters off an allocator before maintenance? - Can I validate a cluster move plan without actually moving anything? - What happens when I treat an allocator as permanently down during a move? instructions: - text: Move all clusters off allocator {allocator_id}. slots: allocator_id: path.allocator_id - text: Move Elasticsearch clusters {elasticsearch_clusters} off allocator {allocator_id}. slots: elasticsearch_clusters: requestBody.elasticsearch_clusters allocator_id: path.allocator_id - text: Dry-run a move off {allocator_id} with validate_only {validate_only}. slots: allocator_id: path.allocator_id validate_only: query.validate_only method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/clusters/{cluster_type}/_move'].post update: x-apievangelist-phrasing: intent: Move clusters of one type off an allocator effect: write questions: - Can I move only the Kibana clusters off an allocator and leave the rest? - How do I vacate a single cluster type from an allocator? instructions: - text: Move the {cluster_type} clusters off allocator {allocator_id}. slots: cluster_type: path.cluster_type allocator_id: path.allocator_id - text: Vacate only {cluster_type} clusters from {allocator_id}, moving data at file-system level with force_move {force_move}. slots: cluster_type: path.cluster_type allocator_id: path.allocator_id force_move: query.force_move method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/logging_settings'].get update: x-apievangelist-phrasing: intent: Get an allocator's logging settings effect: read questions: - What log levels is a specific allocator running with? - How do I inspect the logging configuration on one allocator? instructions: - text: Show the logging settings for allocator {allocator_id}. slots: allocator_id: path.allocator_id - text: Tell me the log levels configured on allocator {allocator_id}. slots: allocator_id: path.allocator_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/logging_settings'].put update: x-apievangelist-phrasing: intent: Set an allocator's logging levels effect: write questions: - How do I override the log levels on an allocator? - Can I raise an allocator's logging to DEBUG while I troubleshoot? instructions: - text: Set allocator {allocator_id} logging levels to {logging_levels}. slots: allocator_id: path.allocator_id logging_levels: requestBody.logging_levels - text: Replace the log level overrides on allocator {allocator_id} with {logging_levels}. slots: allocator_id: path.allocator_id logging_levels: requestBody.logging_levels method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/logging_settings'].delete update: x-apievangelist-phrasing: intent: Reset an allocator's logging to defaults effect: destructive questions: - How do I restore the default logging on an allocator? - Can I drop the custom log levels I set on an allocator? instructions: - text: Reset allocator {allocator_id} logging to defaults. slots: allocator_id: path.allocator_id - text: Drop the custom log levels on allocator {allocator_id}. slots: allocator_id: path.allocator_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/logging_settings'].patch update: x-apievangelist-phrasing: intent: Patch an allocator's logging settings effect: write questions: - Can I tweak one log level on an allocator without overwriting the others? - How do I merge-patch logging changes into an allocator? instructions: - text: Patch the logging settings of allocator {allocator_id}. slots: allocator_id: path.allocator_id - text: Merge a partial log level change into allocator {allocator_id}. slots: allocator_id: path.allocator_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/maintenance-mode/_start'].post update: x-apievangelist-phrasing: intent: Put an allocator into maintenance mode effect: write questions: - How do I put an allocator into maintenance mode? - Can I record a reason when I start allocator maintenance? instructions: - text: Start maintenance mode on allocator {allocator_id}. slots: allocator_id: path.allocator_id - text: Put allocator {allocator_id} into maintenance with reason {reason}. slots: allocator_id: path.allocator_id reason: query.reason method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/maintenance-mode/_stop'].post update: x-apievangelist-phrasing: intent: Take an allocator out of maintenance mode effect: write questions: - How do I bring an allocator back out of maintenance mode? - Can I note why allocator maintenance ended? instructions: - text: Stop maintenance mode on allocator {allocator_id}. slots: allocator_id: path.allocator_id - text: End maintenance on allocator {allocator_id}, noting reason {reason}. slots: allocator_id: path.allocator_id reason: query.reason method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/metadata'].get update: x-apievangelist-phrasing: intent: Get an allocator's metadata effect: read questions: - What metadata tags are attached to an allocator? - How do I read the key-value metadata on one allocator? instructions: - text: Get the metadata for allocator {allocator_id}. slots: allocator_id: path.allocator_id - text: List the metadata items on allocator {allocator_id}. slots: allocator_id: path.allocator_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/metadata'].put update: x-apievangelist-phrasing: intent: Replace all metadata on an allocator effect: write questions: - How do I set the full collection of metadata on an allocator? - Can I replace an allocator's metadata only if it hasn't changed since I read it? instructions: - text: Set allocator {allocator_id} metadata to {items}. slots: allocator_id: path.allocator_id items: requestBody.items - text: Replace every metadata item on {allocator_id} with {items} at version {version}. slots: allocator_id: path.allocator_id items: requestBody.items version: query.version method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/metadata/{key}'].put update: x-apievangelist-phrasing: intent: Add or update one allocator metadata item effect: write questions: - Can I change a single metadata key on an allocator without touching the others? - How do I tag an allocator with one new metadata value? instructions: - text: Set metadata key {key} on allocator {allocator_id} to {value}. slots: key: path.key allocator_id: path.allocator_id value: requestBody.value - text: Tag allocator {allocator_id} with {key}={value}. slots: allocator_id: path.allocator_id key: path.key value: requestBody.value method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/metadata/{key}'].delete update: x-apievangelist-phrasing: intent: Remove one allocator metadata item effect: destructive questions: - How do I delete a single metadata key from an allocator? - Can I untag an allocator by removing one metadata entry? instructions: - text: Remove metadata key {key} from allocator {allocator_id}. slots: key: path.key allocator_id: path.allocator_id - text: Untag {allocator_id} by deleting its {key} metadata item. slots: allocator_id: path.allocator_id key: path.key method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/settings'].get update: x-apievangelist-phrasing: intent: Get an allocator's override settings effect: read questions: - What capacity override is set on an allocator? - How do I view the override settings of one allocator? instructions: - text: Get the override settings for allocator {allocator_id}. slots: allocator_id: path.allocator_id - text: Show the capacity override on allocator {allocator_id}. slots: allocator_id: path.allocator_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/settings'].put update: x-apievangelist-phrasing: intent: Overwrite an allocator's settings effect: write questions: - How do I override an allocator's memory capacity from what was set at install? - Does replacing allocator settings delete fields I leave out? instructions: - text: Set allocator {allocator_id} capacity to {capacity} MB. slots: allocator_id: path.allocator_id capacity: requestBody.capacity - text: Overwrite all settings on allocator {allocator_id} with capacity {capacity}. slots: allocator_id: path.allocator_id capacity: requestBody.capacity method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/allocators/{allocator_id}/settings'].patch update: x-apievangelist-phrasing: intent: Patch an allocator's settings effect: write questions: - Can I change only some allocator settings and leave the others as they are? - How do I apply a partial settings update to an allocator? instructions: - text: Patch the settings of allocator {allocator_id}. slots: allocator_id: path.allocator_id - text: Apply a partial settings change to allocator {allocator_id} at version {version}. slots: allocator_id: path.allocator_id version: query.version method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/blueprinter/roles'].get update: x-apievangelist-phrasing: intent: List Blueprinter roles effect: read questions: - Which Blueprinter roles are defined on my platform? - How do I see all persisted runner roles? instructions: - text: List all Blueprinter roles. - text: Show every persisted runner role. method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/blueprinter/roles'].post update: x-apievangelist-phrasing: intent: Create a Blueprinter role effect: write questions: - How do I define a new Blueprinter role for runners? - Can I bless specific runners when I create a role? instructions: - text: Create Blueprinter role {role}. slots: role: requestBody.role - text: Create role {role} with runner blessings {blessings}. slots: role: requestBody.role blessings: requestBody.blessings method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/blueprinter/roles/{blueprinter_role_id}'].get update: x-apievangelist-phrasing: intent: Get a Blueprinter role effect: read questions: - How do I look up one Blueprinter role and its containers? - Which runners are blessed for a particular role? instructions: - text: Get Blueprinter role {blueprinter_role_id}. slots: blueprinter_role_id: path.blueprinter_role_id - text: Show the containers and blessings of role {blueprinter_role_id}. slots: blueprinter_role_id: path.blueprinter_role_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/blueprinter/roles/{blueprinter_role_id}'].put update: x-apievangelist-phrasing: intent: Update a Blueprinter role effect: write questions: - How do I change the containers that make up a Blueprinter role? - Can I make a role auto-blessed so any runner can take its containers? instructions: - text: Update role {blueprinter_role_id} with id {id}, containers {containers} and auto_blessed {auto_blessed}. slots: blueprinter_role_id: path.blueprinter_role_id id: requestBody.id containers: requestBody.containers auto_blessed: requestBody.auto_blessed - text: Replace the containers of Blueprinter role {blueprinter_role_id} with {containers}. slots: blueprinter_role_id: path.blueprinter_role_id containers: requestBody.containers method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/blueprinter/roles/{blueprinter_role_id}'].delete update: x-apievangelist-phrasing: intent: Delete a Blueprinter role effect: destructive questions: - How do I delete a Blueprinter role? - Can I delete a role even when validation would block it? instructions: - text: Delete Blueprinter role {blueprinter_role_id}. slots: blueprinter_role_id: path.blueprinter_role_id - text: Delete role {blueprinter_role_id} ignoring validation errors with skip_validations {skip_validations}. slots: blueprinter_role_id: path.blueprinter_role_id skip_validations: query.skip_validations method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/blueprinter/roles/{blueprinter_role_id}/blessings'].put update: x-apievangelist-phrasing: intent: Set all runner blessings for a role effect: write questions: - How do I set which runners are allowed to run a Blueprinter role? - Can I replace the whole runner blessing map on a role at once? instructions: - text: Set the blessings for role {blueprinter_role_id} to {runner_ids_to_blessing}. slots: blueprinter_role_id: path.blueprinter_role_id runner_ids_to_blessing: requestBody.runner_ids_to_blessing - text: Replace the runner blessing map on {blueprinter_role_id} with {runner_ids_to_blessing}. slots: blueprinter_role_id: path.blueprinter_role_id runner_ids_to_blessing: requestBody.runner_ids_to_blessing method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/blueprinter/roles/{blueprinter_role_id}/blessings/{runner_id}'].put update: x-apievangelist-phrasing: intent: Bless one runner for a role effect: write questions: - Can I bless a single runner for a role without resending all blessings? - How do I allow one more runner to run a Blueprinter role? instructions: - text: Bless runner {runner_id} for role {blueprinter_role_id} with value {value}. slots: runner_id: path.runner_id blueprinter_role_id: path.blueprinter_role_id value: requestBody.value - text: Allow runner {runner_id} to run role {blueprinter_role_id}, blessing set to {value}. slots: runner_id: path.runner_id blueprinter_role_id: path.blueprinter_role_id value: requestBody.value method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/constructors'].get update: x-apievangelist-phrasing: intent: List constructors effect: read questions: - What constructors are part of my ECE installation? - How do I get an overview of all constructors? instructions: - text: List all constructors. - text: Give me an overview of every constructor in the installation. method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/constructors/_resync'].post update: x-apievangelist-phrasing: intent: Resynchronize all constructors in the index effect: write questions: - How do I resync every constructor's information into the search index? - Can a bulk constructor resync skip documents whose version already matches? instructions: - text: Resynchronize all constructors in the background. - text: Resync every constructor with skip_matching_version {skip_matching_version}. slots: skip_matching_version: query.skip_matching_version method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/constructors/{constructor_id}'].get update: x-apievangelist-phrasing: intent: Get a constructor effect: read questions: - How do I look up one constructor by its ID? - Is a particular constructor in maintenance mode? instructions: - text: Get constructor {constructor_id}. slots: constructor_id: path.constructor_id - text: Show the details of constructor {constructor_id}. slots: constructor_id: path.constructor_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/constructors/{constructor_id}/_resync'].post update: x-apievangelist-phrasing: intent: Resynchronize one constructor effect: write questions: - How do I immediately refresh one constructor's search index and cache entry? - Can I resync a single constructor rather than all of them? instructions: - text: Resync constructor {constructor_id} now. slots: constructor_id: path.constructor_id - text: Refresh the index and cache for constructor {constructor_id}. slots: constructor_id: path.constructor_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/constructors/{constructor_id}/logging_settings'].get update: x-apievangelist-phrasing: intent: Get a constructor's logging settings effect: read questions: - What log levels is a constructor running with? - How do I check the logging setup of one constructor? instructions: - text: Show the logging settings for constructor {constructor_id}. slots: constructor_id: path.constructor_id - text: Tell me the log levels on constructor {constructor_id}. slots: constructor_id: path.constructor_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/constructors/{constructor_id}/logging_settings'].put update: x-apievangelist-phrasing: intent: Set a constructor's logging levels effect: write questions: - How do I override the log levels on a constructor? - Can I turn on verbose logging for a single constructor? instructions: - text: Set constructor {constructor_id} logging levels to {logging_levels}. slots: constructor_id: path.constructor_id logging_levels: requestBody.logging_levels - text: Replace constructor {constructor_id} log level overrides with {logging_levels}. slots: constructor_id: path.constructor_id logging_levels: requestBody.logging_levels method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/constructors/{constructor_id}/logging_settings'].delete update: x-apievangelist-phrasing: intent: Reset a constructor's logging to defaults effect: destructive questions: - How do I put a constructor's logging back to default? - Can I remove the log level overrides from a constructor? instructions: - text: Reset constructor {constructor_id} logging to defaults. slots: constructor_id: path.constructor_id - text: Remove the custom log levels from constructor {constructor_id}. slots: constructor_id: path.constructor_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/constructors/{constructor_id}/logging_settings'].patch update: x-apievangelist-phrasing: intent: Patch a constructor's logging settings effect: write questions: - Can I adjust one constructor log level without replacing all of them? - How do I merge-patch a logging change into a constructor? instructions: - text: Patch the logging settings of constructor {constructor_id}. slots: constructor_id: path.constructor_id - text: Merge one log level change into constructor {constructor_id}. slots: constructor_id: path.constructor_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/constructors/{constructor_id}/maintenance-mode/_start'].post update: x-apievangelist-phrasing: intent: Put a constructor into maintenance mode effect: write questions: - How do I stop a constructor from building new plans while it finishes current ones? - Can I pause plan construction on a constructor for maintenance? instructions: - text: Start maintenance mode on constructor {constructor_id}. slots: constructor_id: path.constructor_id - text: Pause new plan construction on {constructor_id}. slots: constructor_id: path.constructor_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/constructors/{constructor_id}/maintenance-mode/_stop'].post update: x-apievangelist-phrasing: intent: Take a constructor out of maintenance mode effect: write questions: - How do I let a constructor resume building submitted plans? - Can I end maintenance mode on a constructor? instructions: - text: Stop maintenance mode on constructor {constructor_id}. slots: constructor_id: path.constructor_id - text: Resume plan construction on {constructor_id}. slots: constructor_id: path.constructor_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/coordinators'].get update: x-apievangelist-phrasing: intent: List coordinators effect: read questions: - Which coordinators are running in my ECE installation? - How do I get an overview of all coordinators? instructions: - text: List all coordinators. - text: Give me an overview of every coordinator. method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/coordinators/candidates'].get update: x-apievangelist-phrasing: intent: List coordinator candidates effect: read questions: - Which hosts are candidates to become coordinators? - How do I see all coordinator candidates waiting for promotion? instructions: - text: List all coordinator candidates. - text: Show hosts eligible for coordinator promotion. method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/coordinators/candidates/{coordinator_candidate_id}'].get update: x-apievangelist-phrasing: intent: Get a coordinator candidate effect: read questions: - How do I look up one coordinator candidate? - What are the details of a specific candidate before I promote it? instructions: - text: Get coordinator candidate {coordinator_candidate_id}. slots: coordinator_candidate_id: path.coordinator_candidate_id - text: Show candidate {coordinator_candidate_id} before promotion. slots: coordinator_candidate_id: path.coordinator_candidate_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/coordinators/candidates/{coordinator_candidate_id}'].delete update: x-apievangelist-phrasing: intent: Delete a coordinator candidate effect: destructive questions: - How do I remove a host from the coordinator candidate list? - Can I delete a coordinator candidate by its ID? instructions: - text: Delete coordinator candidate {coordinator_candidate_id}. slots: coordinator_candidate_id: path.coordinator_candidate_id - text: Drop {coordinator_candidate_id} from the coordinator candidates. slots: coordinator_candidate_id: path.coordinator_candidate_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/coordinators/candidates/{coordinator_candidate_id}/_promote'].post update: x-apievangelist-phrasing: intent: Promote a candidate to coordinator effect: write questions: - How do I promote a candidate host into a coordinator? - Can I add capacity to the coordinator layer by promoting a candidate? instructions: - text: Promote coordinator candidate {coordinator_candidate_id}. slots: coordinator_candidate_id: path.coordinator_candidate_id - text: Make {coordinator_candidate_id} a coordinator. slots: coordinator_candidate_id: path.coordinator_candidate_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/coordinators/{coordinator_id}'].get update: x-apievangelist-phrasing: intent: Get a coordinator effect: read questions: - How do I see the overview of one coordinator? - What is the state of a particular coordinator host? instructions: - text: Get coordinator {coordinator_id}. slots: coordinator_id: path.coordinator_id - text: Show me the overview of coordinator {coordinator_id}. slots: coordinator_id: path.coordinator_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/coordinators/{coordinator_id}/_demote'].post update: x-apievangelist-phrasing: intent: Demote a coordinator effect: destructive questions: - How do I demote a coordinator and remove ZooKeeper from its host? - Can I take a host out of the coordinator role? instructions: - text: Demote coordinator {coordinator_id}. slots: coordinator_id: path.coordinator_id - text: Remove ZooKeeper from {coordinator_id} by demoting it. slots: coordinator_id: path.coordinator_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/proxies'].get update: x-apievangelist-phrasing: intent: List proxies effect: read questions: - Which proxies are running on my platform? - How do I get an overview of all proxies? instructions: - text: List all proxies. - text: Give me an overview of every proxy. method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/proxies/filtered-groups'].post update: x-apievangelist-phrasing: intent: Create a filtered proxy group (deprecated) effect: write questions: - How do I define a filtered group of proxies with an expected count? - Is creating filtered proxy groups still supported or deprecated? instructions: - text: Create a filtered proxy group with filters {filters} expecting {expected_proxies_count} proxies. slots: filters: requestBody.filters expected_proxies_count: requestBody.expected_proxies_count - text: Create proxy group {id} matching {filters} with at least {expected_proxies_count} proxies. slots: id: requestBody.id filters: requestBody.filters expected_proxies_count: requestBody.expected_proxies_count method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/proxies/filtered-groups/{proxies_filtered_group_id}'].get update: x-apievangelist-phrasing: intent: Get a filtered proxy group (deprecated) effect: read questions: - How do I read the filters of one filtered proxy group? - What expected proxy count is set on a given filtered group? instructions: - text: Get filtered proxy group {proxies_filtered_group_id}. slots: proxies_filtered_group_id: path.proxies_filtered_group_id - text: Show the filters on proxy group {proxies_filtered_group_id}. slots: proxies_filtered_group_id: path.proxies_filtered_group_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/proxies/filtered-groups/{proxies_filtered_group_id}'].put update: x-apievangelist-phrasing: intent: Update a filtered proxy group (deprecated) effect: write questions: - How do I change the filters or expected count of a filtered proxy group? - Can I update a proxy group only if it's still at the version I read? instructions: - text: Update proxy group {proxies_filtered_group_id} with filters {filters} and expected count {expected_proxies_count}. slots: proxies_filtered_group_id: path.proxies_filtered_group_id filters: requestBody.filters expected_proxies_count: requestBody.expected_proxies_count - text: Raise the expected proxies for group {proxies_filtered_group_id} to {expected_proxies_count}, keeping filters {filters}. slots: proxies_filtered_group_id: path.proxies_filtered_group_id expected_proxies_count: requestBody.expected_proxies_count filters: requestBody.filters method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/proxies/filtered-groups/{proxies_filtered_group_id}'].delete update: x-apievangelist-phrasing: intent: Delete a filtered proxy group (deprecated) effect: destructive questions: - How do I delete a filtered group of proxies? - Can I remove a proxy group by ID with a version check? instructions: - text: Delete filtered proxy group {proxies_filtered_group_id}. slots: proxies_filtered_group_id: path.proxies_filtered_group_id - text: Remove proxy group {proxies_filtered_group_id} at version {version}. slots: proxies_filtered_group_id: path.proxies_filtered_group_id version: query.version method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/proxies/filtered-groups/{proxies_filtered_group_id}/health'].get update: x-apievangelist-phrasing: intent: Check health of a filtered proxy group effect: read questions: - Is a particular filtered group of proxies healthy? - Can I check whether a proxy group has reached an expected status? instructions: - text: Check the health of proxy group {proxies_filtered_group_id}. slots: proxies_filtered_group_id: path.proxies_filtered_group_id - text: Tell me if proxy group {proxies_filtered_group_id} is at status {expect_status}. slots: proxies_filtered_group_id: path.proxies_filtered_group_id expect_status: query.expect_status method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/proxies/health'].get update: x-apievangelist-phrasing: intent: Check health of all proxies effect: read questions: - Are all of my proxies healthy right now? - How do I check the overall proxy health against an expected status? instructions: - text: Check the health of all proxies. - text: Tell me whether every proxy is at status {expect_status}. slots: expect_status: query.expect_status method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/proxies/settings'].get update: x-apievangelist-phrasing: intent: Get proxy settings effect: read questions: - What settings apply to all proxies, like the signature validity window? - How do I view the current proxy settings? instructions: - text: Show the proxy settings. - text: Get the settings shared by all proxies. method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/proxies/settings'].put update: x-apievangelist-phrasing: intent: Overwrite proxy settings effect: write questions: - How do I replace the proxy settings, including the signature secret? - Does overwriting proxy settings delete fields I don't specify? instructions: - text: 'Set proxy settings: expected count {expected_proxies_count}, secret {signature_secret}, validity {signature_valid_for_millis} ms, HTTP {http_settings}.' slots: expected_proxies_count: requestBody.expected_proxies_count signature_secret: requestBody.signature_secret signature_valid_for_millis: requestBody.signature_valid_for_millis http_settings: requestBody.http_settings - text: Overwrite the proxy signature validity to {signature_valid_for_millis} ms with secret {signature_secret}. slots: signature_valid_for_millis: requestBody.signature_valid_for_millis signature_secret: requestBody.signature_secret method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/proxies/settings'].patch update: x-apievangelist-phrasing: intent: Patch proxy settings effect: write questions: - Can I change one proxy setting without resending the whole configuration? - How do I apply a partial update to the proxy settings? instructions: - text: Patch the proxy settings. - text: Apply a partial proxy settings change at version {version}. slots: version: query.version method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/proxies/{proxy_id}'].get update: x-apievangelist-phrasing: intent: Get a proxy effect: read questions: - How do I look up one proxy by its ID? - What are the details of a specific proxy instance? instructions: - text: Get proxy {proxy_id}. slots: proxy_id: path.proxy_id - text: Show me the details of proxy {proxy_id}. slots: proxy_id: path.proxy_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/runners'].get update: x-apievangelist-phrasing: intent: List runners effect: read questions: - What runners are in my ECE installation? - Can I filter the runner overview with a query string? instructions: - text: List all runners. - text: List runners matching {q}. slots: q: query.q method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/runners/_resync'].post update: x-apievangelist-phrasing: intent: Resynchronize all runners in the index effect: write questions: - How do I resync every runner's information into the search index? - Can a bulk runner resync skip documents that are already current? instructions: - text: Resynchronize all runners in the background. - text: Resync every runner with skip_matching_version {skip_matching_version}. slots: skip_matching_version: query.skip_matching_version method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/runners/_search'].post update: x-apievangelist-phrasing: intent: Search runners with a query effect: read questions: - Which runners match an Elasticsearch query I provide? - Can I page through runner search results using a cursor? instructions: - text: Search runners with query {query}. slots: query: requestBody.query - text: Fetch the next page of runner hits from cursor {cursor}. slots: cursor: requestBody.cursor method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/runners/{runner_id}'].get update: x-apievangelist-phrasing: intent: Get a runner effect: read questions: - How do I look up one runner by its ID? - What roles and state does a specific runner have? instructions: - text: Get runner {runner_id}. slots: runner_id: path.runner_id - text: Show me the details of runner {runner_id}. slots: runner_id: path.runner_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/runners/{runner_id}'].delete update: x-apievangelist-phrasing: intent: Delete a runner effect: destructive questions: - How do I remove a runner from the platform? - Can I delete a decommissioned runner by its ID? instructions: - text: Delete runner {runner_id}. slots: runner_id: path.runner_id - text: Remove decommissioned runner {runner_id}. slots: runner_id: path.runner_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/runners/{runner_id}/_resync'].post update: x-apievangelist-phrasing: intent: Resynchronize one runner effect: write questions: - How do I immediately refresh one runner in the search index and cache? - Can I resync a single runner instead of all runners? instructions: - text: Resync runner {runner_id} now. slots: runner_id: path.runner_id - text: Refresh the index and cache for runner {runner_id}. slots: runner_id: path.runner_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/runners/{runner_id}/logging_settings'].get update: x-apievangelist-phrasing: intent: Get a runner's logging settings effect: read questions: - What log levels is a runner using? - How do I check the logging configuration of one runner? instructions: - text: Show the logging settings for runner {runner_id}. slots: runner_id: path.runner_id - text: Tell me the log levels on runner {runner_id}. slots: runner_id: path.runner_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/runners/{runner_id}/logging_settings'].put update: x-apievangelist-phrasing: intent: Set a runner's logging levels effect: write questions: - How do I override the log levels on a runner? - Can I switch a runner to more verbose logging? instructions: - text: Set runner {runner_id} logging levels to {logging_levels}. slots: runner_id: path.runner_id logging_levels: requestBody.logging_levels - text: Replace runner {runner_id} log level overrides with {logging_levels}. slots: runner_id: path.runner_id logging_levels: requestBody.logging_levels method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/runners/{runner_id}/logging_settings'].delete update: x-apievangelist-phrasing: intent: Reset a runner's logging to defaults effect: destructive questions: - How do I restore the default logging on a runner? - Can I clear the custom log levels on a runner? instructions: - text: Reset runner {runner_id} logging to defaults. slots: runner_id: path.runner_id - text: Clear the custom log levels on runner {runner_id}. slots: runner_id: path.runner_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/runners/{runner_id}/logging_settings'].patch update: x-apievangelist-phrasing: intent: Patch a runner's logging settings effect: write questions: - Can I change a single runner log level and keep the rest? - How do I merge-patch logging changes into a runner? instructions: - text: Patch the logging settings of runner {runner_id}. slots: runner_id: path.runner_id - text: Merge one log level change into runner {runner_id}. slots: runner_id: path.runner_id method: generated generated: '2026-09-26' - target: $.paths['/platform/infrastructure/runners/{runner_id}/roles'].put update: x-apievangelist-phrasing: intent: Set the roles a runner holds effect: write questions: - How do I assign roles like allocator or proxy to a runner? - Can I bless a runner for its roles while I set them? instructions: - text: Set the roles of runner {runner_id} to {roles}. slots: runner_id: path.runner_id roles: requestBody.roles - text: Assign roles {roles} to runner {runner_id} and bless it with bless {bless}. slots: roles: requestBody.roles runner_id: path.runner_id bless: query.bless method: generated generated: '2026-09-26' - target: $.paths['/platform/license'].get update: x-apievangelist-phrasing: intent: Get the platform license effect: read questions: - What license is installed on my ECE platform? - When does my current Elastic Cloud Enterprise license expire? instructions: - text: Show the installed license. - text: Get the current platform license details. method: generated generated: '2026-09-26' - target: $.paths['/platform/license'].put update: x-apievangelist-phrasing: intent: Add or update the platform license effect: write questions: - How do I install a new license on ECE? - Can I replace an expiring license with a renewed one? instructions: - text: Install license {license}. slots: license: requestBody.license - text: Replace the platform license with {license}. slots: license: requestBody.license method: generated generated: '2026-09-26' - target: $.paths['/platform/license'].delete update: x-apievangelist-phrasing: intent: Delete the platform license effect: destructive questions: - How do I remove the license from my ECE platform? - Can I uninstall the current license from the platform entirely? instructions: - text: Delete the platform license. - text: Remove the installed ECE license. method: generated generated: '2026-09-26'