Harness MCP Server

Official

Overview Schema Source Related Servers Discussions Admin

harness_update

DestructiveIdempotent

Update existing Harness resources, including pipelines and input sets, by supplying a YAML or JSON definition or a Harness URL to auto-extract identifiers.

Instructions

Update an existing Harness resource. For pipelines/input sets: pass body as a YAML string directly (recommended for complex definitions), or use body.yamlPipeline/body.pipeline. You can pass a Harness URL to auto-extract identifiers. Response includes openInHarness link to the updated resource when applicable.

Input Schema

Name	Required	Description
`url`	No	A Harness UI URL — org, project, resource type, ID, and supported resource_scope are extracted automatically
`body`	Yes	The updated resource definition body. For pipelines: pass a YAML string directly, or an object with yamlPipeline (YAML string) or pipeline (JSON object)
`org_id`	No	Org identifier. Required unless a Harness URL is passed (no configured default).
`params`	No	Additional identifiers (e.g. pipeline_id for triggers/input sets, version_label for templates).
`confirm`	No	User-approved confirmation for medium/high-risk operations when the client cannot show a prompt. Set only with user intent; never overrides a user's decline.
`project_id`	No	Project identifier. Required for project-scoped resources unless a Harness URL is passed (no configured default).
`resource_id`	No	The identifier of the resource to update. Optional when url contains the resource ID.
`resource_type`	Yes	The type of resource to update
`resource_scope`	No	account\|org\|project. Omit for the resource's default scope. Never use account to skip a known org/project. Auto-detected from url.

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed7 schema fields changedv3.2.35Oct 24, 2026

changedInput schema / properties / confirm / description

Previous value: -"Set to true to confirm the operation. Only required when the operation risk is medium_write or above AND the client cannot surface a confirmation prompt — e.g. managed MCP that does not advertise elicitation, or an elicitation that fails at runtime. Has no effect for low-risk updates. Does NOT override an explicit decline from a client that completed an elicitation prompt — a user's decline is authoritative."New value: +"User-approved confirmation for medium/high-risk operations when the client cannot show a prompt. Set only with user intent; never overrides a user's decline."

changedInput schema / properties / org_id / description

Previous value: -"Organization identifier. Required for org- and project-scoped resources unless a Harness URL is passed. This session has no configured default (common in hosted/multi-user HTTP) — pass the current org_id on the first call. Do not omit it."New value: +"Org identifier. Required unless a Harness URL is passed (no configured default)."

changedInput schema / properties / project_id / description

Previous value: -"Project identifier. Required for project-scoped resources unless a Harness URL is passed. This session has no configured default (common in hosted/multi-user HTTP) — pass the current project_id on the first call. Do not omit it."New value: +"Project identifier. Required for project-scoped resources unless a Harness URL is passed (no configured default)."

changedInput schema / properties / resource_scope / description

Previous value: -"Scope for the operation. account: account-level resources only — do not use account to skip a known org/project. org: org-level (org_id). project: org+project. Omit to use the resource's default scope. Auto-detected from url when present."New value: +"account|org|project. Omit for the resource's default scope. Never use account to skip a known org/project. Auto-detected from url."

removedInput schema / properties / resource_type / enum

Removed value: -[
-  "agent",
-  "ai_budget",
-  "alert",
-  "chaos_hub",
-  "chaos_input_set",
-  "chaos_loadtest",
-  "chaos_risk_scan",
-  "chaos_service",
-  "connector",
-  "cost_budget",
-  "cost_budget_group",
-  "cost_category",
-  "cost_perspective",
-  "cost_perspective_folder",
-  "database_instance",
-  "database_schema",
-  "environment",
-  "eval_annotation",
-  "eval_dataset",
-  "eval_dataset_item",
-  "eval_git_settings",
-  "eval_metric",
-  "eval_metric_set",
-  "eval_metric_set_entry",
-  "eval_registry_item",
-  "eval_suite",
-  "eval_target",
-  "evaluation",
-  "file_store",
-  "fme_environment",
-  "fme_experiment",
-  "fme_experiment_alerting",
-  "fme_experiment_settings",
-  "fme_feature_flag",
-  "fme_feature_flag_definition",
-  "fme_identity",
-  "fme_metric",
-  "fme_rule_based_segment_definition",
-  "fme_segment",
-  "fme_segment_definition",
-  "fme_segment_keys",
-  "freeze_window",
-  "gitops_app_project_mapping",
-  "gitops_application",
-  "gitops_applicationset",
-  "iacm_module",
-  "iacm_provider",
-  "iacm_variable_set",
-  "iacm_workspace",
-  "idp_entity",
-  "incident",
-  "infrastructure",
-  "input_set",
-  "organization",
-  "pipeline",
-  "pipeline_v1",
-  "policy",
-  "policy_set",
-  "pr_comment",
-  "project",
-  "pull_request",
-  "quarantine",
-  "registry",
-  "release_activity",
-  "release_process",
-  "repo_rule",
-  "repository",
-  "scorecard",
-  "scorecard_check",
-  "scs_auto_pr_config",
-  "service",
-  "service_override",
-  "space_rule",
-  "template",
-  "template_v1",
-  "trigger",
-  "unit_metric",
-  "user_group"
-]

addedInput schema / properties / resource_type / minLength
```
Added value: +1
```

removedOutput schema / description

Removed value: -"Updated resource object"

Changed1 schema field changedv3.2.32Oct 5, 2026

changedInput schema / properties / resource_type / enum

Previous value: -[
-  "agent",
-  "ai_budget",
-  "alert",
-  "chaos_hub",
-  "chaos_input_set",
-  "chaos_loadtest",
-  "chaos_risk_scan",
-  "chaos_service",
-  "connector",
-  "cost_budget",
-  "cost_budget_group",
-  "cost_category",
-  "cost_perspective",
-  "cost_perspective_folder",
-  "database_instance",
-  "database_schema",
-  "environment",
-  "eval_annotation",
-  "eval_dataset",
-  "eval_dataset_item",
-  "eval_git_settings",
-  "eval_metric",
-  "eval_metric_set",
-  "eval_metric_set_entry",
-  "eval_registry_item",
-  "eval_suite",
-  "eval_target",
-  "evaluation",
-  "file_store",
-  "fme_environment",
-  "fme_experiment",
-  "fme_experiment_settings",
-  "fme_feature_flag",
-  "fme_feature_flag_definition",
-  "fme_identity",
-  "fme_metric",
-  "fme_rule_based_segment_definition",
-  "fme_segment",
-  "fme_segment_definition",
-  "fme_segment_keys",
-  "freeze_window",
-  "gitops_app_project_mapping",
-  "gitops_application",
-  "gitops_applicationset",
-  "iacm_module",
-  "iacm_provider",
-  "iacm_variable_set",
-  "iacm_workspace",
-  "idp_entity",
-  "incident",
-  "infrastructure",
-  "input_set",
-  "organization",
-  "pipeline",
-  "pipeline_v1",
-  "policy",
-  "policy_set",
-  "pr_comment",
-  "project",
-  "pull_request",
-  "quarantine",
-  "registry",
-  "release_activity",
-  "release_process",
-  "repo_rule",
-  "repository",
-  "scorecard",
-  "scorecard_check",
-  "scs_auto_pr_config",
-  "service",
-  "service_override",
-  "space_rule",
-  "template",
-  "template_v1",
-  "trigger",
-  "unit_metric",
-  "user_group"
-]New value: +[
+  "agent",
+  "ai_budget",
+  "alert",
+  "chaos_hub",
+  "chaos_input_set",
+  "chaos_loadtest",
+  "chaos_risk_scan",
+  "chaos_service",
+  "connector",
+  "cost_budget",
+  "cost_budget_group",
+  "cost_category",
+  "cost_perspective",
+  "cost_perspective_folder",
+  "database_instance",
+  "database_schema",
+  "environment",
+  "eval_annotation",
+  "eval_dataset",
+  "eval_dataset_item",
+  "eval_git_settings",
+  "eval_metric",
+  "eval_metric_set",
+  "eval_metric_set_entry",
+  "eval_registry_item",
+  "eval_suite",
+  "eval_target",
+  "evaluation",
+  "file_store",
+  "fme_environment",
+  "fme_experiment",
+  "fme_experiment_alerting",
+  "fme_experiment_settings",
+  "fme_feature_flag",
+  "fme_feature_flag_definition",
+  "fme_identity",
+  "fme_metric",
+  "fme_rule_based_segment_definition",
+  "fme_segment",
+  "fme_segment_definition",
+  "fme_segment_keys",
+  "freeze_window",
+  "gitops_app_project_mapping",
+  "gitops_application",
+  "gitops_applicationset",
+  "iacm_module",
+  "iacm_provider",
+  "iacm_variable_set",
+  "iacm_workspace",
+  "idp_entity",
+  "incident",
+  "infrastructure",
+  "input_set",
+  "organization",
+  "pipeline",
+  "pipeline_v1",
+  "policy",
+  "policy_set",
+  "pr_comment",
+  "project",
+  "pull_request",
+  "quarantine",
+  "registry",
+  "release_activity",
+  "release_process",
+  "repo_rule",
+  "repository",
+  "scorecard",
+  "scorecard_check",
+  "scs_auto_pr_config",
+  "service",
+  "service_override",
+  "space_rule",
+  "template",
+  "template_v1",
+  "trigger",
+  "unit_metric",
+  "user_group"
+]

Changed1 schema field changedv3.2.31Sep 30, 2026

changedInput schema / properties / resource_type / enum

Previous value: -[
-  "agent",
-  "ai_budget",
-  "alert",
-  "chaos_hub",
-  "chaos_input_set",
-  "chaos_loadtest",
-  "chaos_risk_scan",
-  "chaos_service",
-  "connector",
-  "cost_budget",
-  "cost_budget_group",
-  "cost_category",
-  "cost_perspective",
-  "cost_perspective_folder",
-  "database_instance",
-  "database_schema",
-  "environment",
-  "eval_annotation",
-  "eval_dataset",
-  "eval_dataset_item",
-  "eval_git_settings",
-  "eval_metric",
-  "eval_metric_set",
-  "eval_metric_set_entry",
-  "eval_registry_item",
-  "eval_suite",
-  "eval_target",
-  "evaluation",
-  "file_store",
-  "fme_environment",
-  "fme_feature_flag",
-  "fme_feature_flag_definition",
-  "fme_identity",
-  "fme_metric",
-  "fme_rule_based_segment_definition",
-  "fme_segment",
-  "fme_segment_definition",
-  "fme_segment_keys",
-  "freeze_window",
-  "gitops_application",
-  "gitops_applicationset",
-  "iacm_module",
-  "iacm_provider",
-  "iacm_variable_set",
-  "iacm_workspace",
-  "idp_entity",
-  "incident",
-  "infrastructure",
-  "input_set",
-  "organization",
-  "pipeline",
-  "pipeline_v1",
-  "policy",
-  "policy_set",
-  "pr_comment",
-  "project",
-  "pull_request",
-  "registry",
-  "release_activity",
-  "release_process",
-  "repo_rule",
-  "repository",
-  "scorecard",
-  "scorecard_check",
-  "scs_auto_pr_config",
-  "service",
-  "service_override",
-  "space_rule",
-  "template",
-  "template_v1",
-  "trigger",
-  "unit_metric",
-  "user_group"
-]New value: +[
+  "agent",
+  "ai_budget",
+  "alert",
+  "chaos_hub",
+  "chaos_input_set",
+  "chaos_loadtest",
+  "chaos_risk_scan",
+  "chaos_service",
+  "connector",
+  "cost_budget",
+  "cost_budget_group",
+  "cost_category",
+  "cost_perspective",
+  "cost_perspective_folder",
+  "database_instance",
+  "database_schema",
+  "environment",
+  "eval_annotation",
+  "eval_dataset",
+  "eval_dataset_item",
+  "eval_git_settings",
+  "eval_metric",
+  "eval_metric_set",
+  "eval_metric_set_entry",
+  "eval_registry_item",
+  "eval_suite",
+  "eval_target",
+  "evaluation",
+  "file_store",
+  "fme_environment",
+  "fme_experiment",
+  "fme_experiment_settings",
+  "fme_feature_flag",
+  "fme_feature_flag_definition",
+  "fme_identity",
+  "fme_metric",
+  "fme_rule_based_segment_definition",
+  "fme_segment",
+  "fme_segment_definition",
+  "fme_segment_keys",
+  "freeze_window",
+  "gitops_app_project_mapping",
+  "gitops_application",
+  "gitops_applicationset",
+  "iacm_module",
+  "iacm_provider",
+  "iacm_variable_set",
+  "iacm_workspace",
+  "idp_entity",
+  "incident",
+  "infrastructure",
+  "input_set",
+  "organization",
+  "pipeline",
+  "pipeline_v1",
+  "policy",
+  "policy_set",
+  "pr_comment",
+  "project",
+  "pull_request",
+  "quarantine",
+  "registry",
+  "release_activity",
+  "release_process",
+  "repo_rule",
+  "repository",
+  "scorecard",
+  "scorecard_check",
+  "scs_auto_pr_config",
+  "service",
+  "service_override",
+  "space_rule",
+  "template",
+  "template_v1",
+  "trigger",
+  "unit_metric",
+  "user_group"
+]

Changed1 schema field changedv3.2.28Sep 17, 2026

changedInput schema / properties / resource_type / enum

Previous value: -[
-  "agent",
-  "alert",
-  "chaos_hub",
-  "chaos_input_set",
-  "chaos_loadtest",
-  "chaos_risk_scan",
-  "chaos_service",
-  "connector",
-  "cost_budget",
-  "cost_budget_group",
-  "cost_category",
-  "cost_perspective",
-  "cost_perspective_folder",
-  "database_instance",
-  "database_schema",
-  "environment",
-  "eval_annotation",
-  "eval_dataset",
-  "eval_dataset_item",
-  "eval_git_settings",
-  "eval_metric",
-  "eval_metric_set",
-  "eval_metric_set_entry",
-  "eval_registry_item",
-  "eval_suite",
-  "eval_target",
-  "evaluation",
-  "file_store",
-  "fme_environment",
-  "fme_feature_flag",
-  "fme_feature_flag_definition",
-  "fme_identity",
-  "fme_metric",
-  "fme_rule_based_segment_definition",
-  "fme_segment",
-  "fme_segment_definition",
-  "fme_segment_keys",
-  "freeze_window",
-  "gitops_application",
-  "gitops_applicationset",
-  "iacm_module",
-  "iacm_provider",
-  "iacm_variable_set",
-  "iacm_workspace",
-  "idp_entity",
-  "incident",
-  "infrastructure",
-  "input_set",
-  "organization",
-  "pipeline",
-  "pipeline_v1",
-  "policy",
-  "policy_set",
-  "pr_comment",
-  "project",
-  "pull_request",
-  "registry",
-  "release_activity",
-  "release_process",
-  "repo_rule",
-  "repository",
-  "scorecard",
-  "scorecard_check",
-  "scs_auto_pr_config",
-  "service",
-  "service_override",
-  "space_rule",
-  "template",
-  "template_v1",
-  "trigger",
-  "unit_metric"
-]New value: +[
+  "agent",
+  "ai_budget",
+  "alert",
+  "chaos_hub",
+  "chaos_input_set",
+  "chaos_loadtest",
+  "chaos_risk_scan",
+  "chaos_service",
+  "connector",
+  "cost_budget",
+  "cost_budget_group",
+  "cost_category",
+  "cost_perspective",
+  "cost_perspective_folder",
+  "database_instance",
+  "database_schema",
+  "environment",
+  "eval_annotation",
+  "eval_dataset",
+  "eval_dataset_item",
+  "eval_git_settings",
+  "eval_metric",
+  "eval_metric_set",
+  "eval_metric_set_entry",
+  "eval_registry_item",
+  "eval_suite",
+  "eval_target",
+  "evaluation",
+  "file_store",
+  "fme_environment",
+  "fme_feature_flag",
+  "fme_feature_flag_definition",
+  "fme_identity",
+  "fme_metric",
+  "fme_rule_based_segment_definition",
+  "fme_segment",
+  "fme_segment_definition",
+  "fme_segment_keys",
+  "freeze_window",
+  "gitops_application",
+  "gitops_applicationset",
+  "iacm_module",
+  "iacm_provider",
+  "iacm_variable_set",
+  "iacm_workspace",
+  "idp_entity",
+  "incident",
+  "infrastructure",
+  "input_set",
+  "organization",
+  "pipeline",
+  "pipeline_v1",
+  "policy",
+  "policy_set",
+  "pr_comment",
+  "project",
+  "pull_request",
+  "registry",
+  "release_activity",
+  "release_process",
+  "repo_rule",
+  "repository",
+  "scorecard",
+  "scorecard_check",
+  "scs_auto_pr_config",
+  "service",
+  "service_override",
+  "space_rule",
+  "template",
+  "template_v1",
+  "trigger",
+  "unit_metric",
+  "user_group"
+]

Changed1 schema field changedv3.2.27Sep 13, 2026

changedInput schema / properties / resource_type / enum

Previous value: -[
-  "agent",
-  "alert",
-  "chaos_hub",
-  "chaos_input_set",
-  "chaos_loadtest",
-  "chaos_risk_scan",
-  "chaos_service",
-  "connector",
-  "cost_budget",
-  "cost_budget_group",
-  "cost_category",
-  "cost_perspective",
-  "cost_perspective_folder",
-  "database_instance",
-  "database_schema",
-  "environment",
-  "eval_annotation",
-  "eval_dataset",
-  "eval_dataset_item",
-  "eval_git_settings",
-  "eval_metric",
-  "eval_metric_set",
-  "eval_metric_set_entry",
-  "eval_registry_item",
-  "eval_suite",
-  "eval_target",
-  "evaluation",
-  "file_store",
-  "fme_environment",
-  "fme_feature_flag",
-  "fme_feature_flag_definition",
-  "fme_identity",
-  "fme_rule_based_segment_definition",
-  "fme_segment",
-  "fme_segment_definition",
-  "fme_segment_keys",
-  "freeze_window",
-  "gitops_application",
-  "gitops_applicationset",
-  "iacm_module",
-  "iacm_provider",
-  "iacm_variable_set",
-  "iacm_workspace",
-  "idp_entity",
-  "incident",
-  "infrastructure",
-  "input_set",
-  "organization",
-  "pipeline",
-  "pipeline_v1",
-  "policy",
-  "policy_set",
-  "pr_comment",
-  "project",
-  "pull_request",
-  "release_activity",
-  "release_process",
-  "repo_rule",
-  "repository",
-  "scorecard",
-  "scorecard_check",
-  "scs_auto_pr_config",
-  "service",
-  "service_override",
-  "space_rule",
-  "template",
-  "template_v1",
-  "trigger",
-  "unit_metric"
-]New value: +[
+  "agent",
+  "alert",
+  "chaos_hub",
+  "chaos_input_set",
+  "chaos_loadtest",
+  "chaos_risk_scan",
+  "chaos_service",
+  "connector",
+  "cost_budget",
+  "cost_budget_group",
+  "cost_category",
+  "cost_perspective",
+  "cost_perspective_folder",
+  "database_instance",
+  "database_schema",
+  "environment",
+  "eval_annotation",
+  "eval_dataset",
+  "eval_dataset_item",
+  "eval_git_settings",
+  "eval_metric",
+  "eval_metric_set",
+  "eval_metric_set_entry",
+  "eval_registry_item",
+  "eval_suite",
+  "eval_target",
+  "evaluation",
+  "file_store",
+  "fme_environment",
+  "fme_feature_flag",
+  "fme_feature_flag_definition",
+  "fme_identity",
+  "fme_metric",
+  "fme_rule_based_segment_definition",
+  "fme_segment",
+  "fme_segment_definition",
+  "fme_segment_keys",
+  "freeze_window",
+  "gitops_application",
+  "gitops_applicationset",
+  "iacm_module",
+  "iacm_provider",
+  "iacm_variable_set",
+  "iacm_workspace",
+  "idp_entity",
+  "incident",
+  "infrastructure",
+  "input_set",
+  "organization",
+  "pipeline",
+  "pipeline_v1",
+  "policy",
+  "policy_set",
+  "pr_comment",
+  "project",
+  "pull_request",
+  "registry",
+  "release_activity",
+  "release_process",
+  "repo_rule",
+  "repository",
+  "scorecard",
+  "scorecard_check",
+  "scs_auto_pr_config",
+  "service",
+  "service_override",
+  "space_rule",
+  "template",
+  "template_v1",
+  "trigger",
+  "unit_metric"
+]

Changed1 schema field changedv3.2.26Sep 10, 2026

changedInput schema / properties / resource_type / enum

Previous value: -[
-  "agent",
-  "alert",
-  "chaos_hub",
-  "chaos_input_set",
-  "chaos_loadtest",
-  "chaos_risk_scan",
-  "chaos_service",
-  "connector",
-  "cost_budget",
-  "cost_budget_group",
-  "cost_category",
-  "cost_perspective",
-  "cost_perspective_folder",
-  "database_instance",
-  "database_schema",
-  "environment",
-  "eval_annotation",
-  "eval_dataset",
-  "eval_dataset_item",
-  "eval_git_settings",
-  "eval_metric",
-  "eval_metric_set",
-  "eval_metric_set_entry",
-  "eval_registry_item",
-  "eval_suite",
-  "eval_target",
-  "evaluation",
-  "file_store",
-  "fme_environment",
-  "fme_feature_flag",
-  "fme_feature_flag_definition",
-  "fme_identity",
-  "fme_rule_based_segment_definition",
-  "fme_segment_definition",
-  "fme_segment_keys",
-  "freeze_window",
-  "gitops_application",
-  "gitops_applicationset",
-  "iacm_module",
-  "iacm_provider",
-  "iacm_variable_set",
-  "iacm_workspace",
-  "idp_entity",
-  "incident",
-  "infrastructure",
-  "input_set",
-  "organization",
-  "pipeline",
-  "pipeline_v1",
-  "policy",
-  "policy_set",
-  "pr_comment",
-  "project",
-  "pull_request",
-  "release_activity",
-  "release_process",
-  "repo_rule",
-  "repository",
-  "scorecard",
-  "scorecard_check",
-  "scs_auto_pr_config",
-  "service",
-  "service_override",
-  "space_rule",
-  "template",
-  "template_v1",
-  "trigger",
-  "unit_metric"
-]New value: +[
+  "agent",
+  "alert",
+  "chaos_hub",
+  "chaos_input_set",
+  "chaos_loadtest",
+  "chaos_risk_scan",
+  "chaos_service",
+  "connector",
+  "cost_budget",
+  "cost_budget_group",
+  "cost_category",
+  "cost_perspective",
+  "cost_perspective_folder",
+  "database_instance",
+  "database_schema",
+  "environment",
+  "eval_annotation",
+  "eval_dataset",
+  "eval_dataset_item",
+  "eval_git_settings",
+  "eval_metric",
+  "eval_metric_set",
+  "eval_metric_set_entry",
+  "eval_registry_item",
+  "eval_suite",
+  "eval_target",
+  "evaluation",
+  "file_store",
+  "fme_environment",
+  "fme_feature_flag",
+  "fme_feature_flag_definition",
+  "fme_identity",
+  "fme_rule_based_segment_definition",
+  "fme_segment",
+  "fme_segment_definition",
+  "fme_segment_keys",
+  "freeze_window",
+  "gitops_application",
+  "gitops_applicationset",
+  "iacm_module",
+  "iacm_provider",
+  "iacm_variable_set",
+  "iacm_workspace",
+  "idp_entity",
+  "incident",
+  "infrastructure",
+  "input_set",
+  "organization",
+  "pipeline",
+  "pipeline_v1",
+  "policy",
+  "policy_set",
+  "pr_comment",
+  "project",
+  "pull_request",
+  "release_activity",
+  "release_process",
+  "repo_rule",
+  "repository",
+  "scorecard",
+  "scorecard_check",
+  "scs_auto_pr_config",
+  "service",
+  "service_override",
+  "space_rule",
+  "template",
+  "template_v1",
+  "trigger",
+  "unit_metric"
+]

Changed4 schema fields changedv3.2.22Sep 1, 2026

changedInput schema / properties / org_id / description

Previous value: -"Organization identifier (overrides default)"New value: +"Organization identifier. Required for org- and project-scoped resources unless a Harness URL is passed. This session has no configured default (common in hosted/multi-user HTTP) — pass the current org_id on the first call. Do not omit it."

changedInput schema / properties / project_id / description

Previous value: -"Project identifier (overrides default)"New value: +"Project identifier. Required for project-scoped resources unless a Harness URL is passed. This session has no configured default (common in hosted/multi-user HTTP) — pass the current project_id on the first call. Do not omit it."

changedInput schema / properties / resource_scope / description

Previous value: -"Scope for the operation. account: omit org/project (e.g. /v1/templates). org: org only. project: org+project. Auto-detected from url when present."New value: +"Scope for the operation. account: account-level resources only — do not use account to skip a known org/project. org: org-level (org_id). project: org+project. Omit to use the resource's default scope. Auto-detected from url when present."

changedInput schema / properties / resource_type / enum

Previous value: -[
-  "agent",
-  "chaos_hub",
-  "chaos_input_set",
-  "chaos_loadtest",
-  "chaos_risk_scan",
-  "chaos_service",
-  "connector",
-  "cost_budget",
-  "cost_budget_group",
-  "cost_category",
-  "cost_perspective",
-  "cost_perspective_folder",
-  "database_instance",
-  "database_schema",
-  "environment",
-  "eval_annotation",
-  "eval_dataset",
-  "eval_dataset_item",
-  "eval_git_settings",
-  "eval_metric",
-  "eval_metric_set",
-  "eval_metric_set_entry",
-  "eval_registry_item",
-  "eval_suite",
-  "eval_target",
-  "evaluation",
-  "file_store",
-  "fme_environment",
-  "fme_feature_flag",
-  "fme_feature_flag_definition",
-  "fme_identity",
-  "fme_rule_based_segment_definition",
-  "fme_segment_definition",
-  "fme_segment_keys",
-  "freeze_window",
-  "gitops_application",
-  "gitops_applicationset",
-  "iacm_module",
-  "iacm_provider",
-  "iacm_variable_set",
-  "iacm_workspace",
-  "idp_entity",
-  "incident",
-  "infrastructure",
-  "input_set",
-  "organization",
-  "pipeline",
-  "pipeline_v1",
-  "policy",
-  "policy_set",
-  "pr_comment",
-  "project",
-  "pull_request",
-  "release_activity",
-  "release_process",
-  "repo_rule",
-  "repository",
-  "scorecard",
-  "scorecard_check",
-  "scs_auto_pr_config",
-  "service",
-  "service_override",
-  "space_rule",
-  "template",
-  "template_v1",
-  "trigger",
-  "unit_metric"
-]New value: +[
+  "agent",
+  "alert",
+  "chaos_hub",
+  "chaos_input_set",
+  "chaos_loadtest",
+  "chaos_risk_scan",
+  "chaos_service",
+  "connector",
+  "cost_budget",
+  "cost_budget_group",
+  "cost_category",
+  "cost_perspective",
+  "cost_perspective_folder",
+  "database_instance",
+  "database_schema",
+  "environment",
+  "eval_annotation",
+  "eval_dataset",
+  "eval_dataset_item",
+  "eval_git_settings",
+  "eval_metric",
+  "eval_metric_set",
+  "eval_metric_set_entry",
+  "eval_registry_item",
+  "eval_suite",
+  "eval_target",
+  "evaluation",
+  "file_store",
+  "fme_environment",
+  "fme_feature_flag",
+  "fme_feature_flag_definition",
+  "fme_identity",
+  "fme_rule_based_segment_definition",
+  "fme_segment_definition",
+  "fme_segment_keys",
+  "freeze_window",
+  "gitops_application",
+  "gitops_applicationset",
+  "iacm_module",
+  "iacm_provider",
+  "iacm_variable_set",
+  "iacm_workspace",
+  "idp_entity",
+  "incident",
+  "infrastructure",
+  "input_set",
+  "organization",
+  "pipeline",
+  "pipeline_v1",
+  "policy",
+  "policy_set",
+  "pr_comment",
+  "project",
+  "pull_request",
+  "release_activity",
+  "release_process",
+  "repo_rule",
+  "repository",
+  "scorecard",
+  "scorecard_check",
+  "scs_auto_pr_config",
+  "service",
+  "service_override",
+  "space_rule",
+  "template",
+  "template_v1",
+  "trigger",
+  "unit_metric"
+]

Changed1 schema field changedv3.2.21Aug 26, 2026

changedInput schema / properties / resource_type / enum

Previous value: -[
-  "agent",
-  "chaos_hub",
-  "chaos_input_set",
-  "chaos_loadtest",
-  "chaos_risk_scan",
-  "chaos_service",
-  "connector",
-  "cost_budget",
-  "cost_budget_group",
-  "cost_category",
-  "cost_perspective",
-  "cost_perspective_folder",
-  "database_instance",
-  "database_schema",
-  "environment",
-  "eval_annotation",
-  "eval_dataset",
-  "eval_dataset_item",
-  "eval_git_settings",
-  "eval_metric",
-  "eval_metric_set",
-  "eval_metric_set_entry",
-  "eval_registry_item",
-  "eval_suite",
-  "eval_target",
-  "evaluation",
-  "file_store",
-  "fme_feature_flag",
-  "fme_feature_flag_definition",
-  "fme_identity",
-  "fme_rule_based_segment_definition",
-  "fme_segment_definition",
-  "fme_segment_keys",
-  "freeze_window",
-  "gitops_application",
-  "gitops_applicationset",
-  "iacm_module",
-  "iacm_variable_set",
-  "iacm_workspace",
-  "idp_entity",
-  "incident",
-  "infrastructure",
-  "input_set",
-  "organization",
-  "pipeline",
-  "pipeline_v1",
-  "policy",
-  "policy_set",
-  "pr_comment",
-  "project",
-  "pull_request",
-  "repo_rule",
-  "repository",
-  "scorecard",
-  "scorecard_check",
-  "scs_auto_pr_config",
-  "service",
-  "service_override",
-  "space_rule",
-  "template",
-  "template_v1",
-  "trigger",
-  "unit_metric"
-]New value: +[
+  "agent",
+  "chaos_hub",
+  "chaos_input_set",
+  "chaos_loadtest",
+  "chaos_risk_scan",
+  "chaos_service",
+  "connector",
+  "cost_budget",
+  "cost_budget_group",
+  "cost_category",
+  "cost_perspective",
+  "cost_perspective_folder",
+  "database_instance",
+  "database_schema",
+  "environment",
+  "eval_annotation",
+  "eval_dataset",
+  "eval_dataset_item",
+  "eval_git_settings",
+  "eval_metric",
+  "eval_metric_set",
+  "eval_metric_set_entry",
+  "eval_registry_item",
+  "eval_suite",
+  "eval_target",
+  "evaluation",
+  "file_store",
+  "fme_environment",
+  "fme_feature_flag",
+  "fme_feature_flag_definition",
+  "fme_identity",
+  "fme_rule_based_segment_definition",
+  "fme_segment_definition",
+  "fme_segment_keys",
+  "freeze_window",
+  "gitops_application",
+  "gitops_applicationset",
+  "iacm_module",
+  "iacm_provider",
+  "iacm_variable_set",
+  "iacm_workspace",
+  "idp_entity",
+  "incident",
+  "infrastructure",
+  "input_set",
+  "organization",
+  "pipeline",
+  "pipeline_v1",
+  "policy",
+  "policy_set",
+  "pr_comment",
+  "project",
+  "pull_request",
+  "release_activity",
+  "release_process",
+  "repo_rule",
+  "repository",
+  "scorecard",
+  "scorecard_check",
+  "scs_auto_pr_config",
+  "service",
+  "service_override",
+  "space_rule",
+  "template",
+  "template_v1",
+  "trigger",
+  "unit_metric"
+]

Changed1 schema field changedv3.2.20Aug 19, 2026

changedInput schema / properties / resource_type / enum

Previous value: -[
-  "agent",
-  "chaos_hub",
-  "chaos_input_set",
-  "chaos_risk_scan",
-  "connector",
-  "cost_category",
-  "cost_perspective",
-  "cost_perspective_folder",
-  "database_instance",
-  "database_schema",
-  "environment",
-  "eval_annotation",
-  "eval_dataset",
-  "eval_dataset_item",
-  "eval_git_settings",
-  "eval_metric",
-  "eval_metric_set",
-  "eval_metric_set_entry",
-  "eval_registry_item",
-  "eval_suite",
-  "eval_target",
-  "evaluation",
-  "file_store",
-  "fme_feature_flag",
-  "fme_feature_flag_definition",
-  "fme_identity",
-  "fme_rule_based_segment_definition",
-  "fme_segment_keys",
-  "freeze_window",
-  "gitops_application",
-  "gitops_applicationset",
-  "idp_entity",
-  "incident",
-  "infrastructure",
-  "input_set",
-  "organization",
-  "pipeline",
-  "pipeline_v1",
-  "policy",
-  "policy_set",
-  "pr_comment",
-  "project",
-  "pull_request",
-  "repo_rule",
-  "repository",
-  "scorecard",
-  "scorecard_check",
-  "scs_auto_pr_config",
-  "service",
-  "service_override",
-  "space_rule",
-  "template",
-  "template_v1",
-  "trigger",
-  "unit_metric"
-]New value: +[
+  "agent",
+  "chaos_hub",
+  "chaos_input_set",
+  "chaos_loadtest",
+  "chaos_risk_scan",
+  "chaos_service",
+  "connector",
+  "cost_budget",
+  "cost_budget_group",
+  "cost_category",
+  "cost_perspective",
+  "cost_perspective_folder",
+  "database_instance",
+  "database_schema",
+  "environment",
+  "eval_annotation",
+  "eval_dataset",
+  "eval_dataset_item",
+  "eval_git_settings",
+  "eval_metric",
+  "eval_metric_set",
+  "eval_metric_set_entry",
+  "eval_registry_item",
+  "eval_suite",
+  "eval_target",
+  "evaluation",
+  "file_store",
+  "fme_feature_flag",
+  "fme_feature_flag_definition",
+  "fme_identity",
+  "fme_rule_based_segment_definition",
+  "fme_segment_definition",
+  "fme_segment_keys",
+  "freeze_window",
+  "gitops_application",
+  "gitops_applicationset",
+  "iacm_module",
+  "iacm_variable_set",
+  "iacm_workspace",
+  "idp_entity",
+  "incident",
+  "infrastructure",
+  "input_set",
+  "organization",
+  "pipeline",
+  "pipeline_v1",
+  "policy",
+  "policy_set",
+  "pr_comment",
+  "project",
+  "pull_request",
+  "repo_rule",
+  "repository",
+  "scorecard",
+  "scorecard_check",
+  "scs_auto_pr_config",
+  "service",
+  "service_override",
+  "space_rule",
+  "template",
+  "template_v1",
+  "trigger",
+  "unit_metric"
+]

Changed1 schema field changedv3.2.17Aug 4, 2026

changedInput schema / properties / resource_type / enum

Previous value: -[
-  "agent",
-  "chaos_hub",
-  "chaos_input_set",
-  "connector",
-  "cost_category",
-  "cost_perspective",
-  "cost_perspective_folder",
-  "database_instance",
-  "database_schema",
-  "environment",
-  "eval_annotation",
-  "eval_dataset",
-  "eval_dataset_item",
-  "eval_git_settings",
-  "eval_metric",
-  "eval_metric_set",
-  "eval_metric_set_entry",
-  "eval_registry_item",
-  "eval_suite",
-  "eval_target",
-  "evaluation",
-  "file_store",
-  "fme_feature_flag",
-  "fme_feature_flag_definition",
-  "fme_identity",
-  "fme_rule_based_segment_definition",
-  "fme_segment_keys",
-  "freeze_window",
-  "gitops_application",
-  "gitops_applicationset",
-  "idp_entity",
-  "incident",
-  "infrastructure",
-  "input_set",
-  "organization",
-  "pipeline",
-  "pipeline_v1",
-  "policy",
-  "policy_set",
-  "pr_comment",
-  "project",
-  "pull_request",
-  "repo_rule",
-  "repository",
-  "scorecard",
-  "scorecard_check",
-  "scs_auto_pr_config",
-  "service",
-  "service_override",
-  "space_rule",
-  "template",
-  "template_v1",
-  "trigger",
-  "unit_metric"
-]New value: +[
+  "agent",
+  "chaos_hub",
+  "chaos_input_set",
+  "chaos_risk_scan",
+  "connector",
+  "cost_category",
+  "cost_perspective",
+  "cost_perspective_folder",
+  "database_instance",
+  "database_schema",
+  "environment",
+  "eval_annotation",
+  "eval_dataset",
+  "eval_dataset_item",
+  "eval_git_settings",
+  "eval_metric",
+  "eval_metric_set",
+  "eval_metric_set_entry",
+  "eval_registry_item",
+  "eval_suite",
+  "eval_target",
+  "evaluation",
+  "file_store",
+  "fme_feature_flag",
+  "fme_feature_flag_definition",
+  "fme_identity",
+  "fme_rule_based_segment_definition",
+  "fme_segment_keys",
+  "freeze_window",
+  "gitops_application",
+  "gitops_applicationset",
+  "idp_entity",
+  "incident",
+  "infrastructure",
+  "input_set",
+  "organization",
+  "pipeline",
+  "pipeline_v1",
+  "policy",
+  "policy_set",
+  "pr_comment",
+  "project",
+  "pull_request",
+  "repo_rule",
+  "repository",
+  "scorecard",
+  "scorecard_check",
+  "scs_auto_pr_config",
+  "service",
+  "service_override",
+  "space_rule",
+  "template",
+  "template_v1",
+  "trigger",
+  "unit_metric"
+]

First observedv3.2.10Jul 16, 2026

TDQS

B3.4/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructive=true, idempotent=true, and openWorld=true, so the safety profile is covered. The description adds body-format guidance and the openInHarness response link, but it does not clarify whether the update replaces or merges the existing resource definition, which is a key behavioral gap for a destructive update tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core action and then adds practical details in a compact four-sentence block. Every sentence carries useful information, with no obvious filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present and annotations covering risk/idempotency, the description does not need to explain return values. However, for a complex nine-parameter update tool, it leaves out important update semantics such as replacement versus merge behavior and when org/project/scope defaults apply.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all nine parameters in detail. The description reinforces the recommended YAML-string body format for pipelines and the URL auto-extraction behavior, but it mostly repeats schema-level information rather than adding substantial new parameter semantics.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: 'Update an existing Harness resource.' This clearly separates it from harness_create and harness_delete by implication, though it never names those siblings or explicitly says when not to use this tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives useful context for pipelines/input sets and mentions passing a Harness URL as an alternative input path. However, it does not explicitly say when to choose harness_update over harness_create, or what conditions make an update inappropriate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

harness_update

Instructions

Input Schema

Output Schema

Schema Changelog

TDQS

Other Tools