harness_list
List and filter Harness resources with pagination. Auto-detects scope and resource type from a Harness UI URL.
Instructions
List Harness resources with filtering and pagination. Accepts a Harness URL to auto-extract scope.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Harness UI URL — auto-extracts org, project, and type | |
| page | No | Page number, 0-indexed | |
| size | No | Page size (1–100) | |
| org_id | No | Organization identifier (overrides default) | |
| params | No | Additional identifiers for nested resources (e.g. repo_id for pull requests). Call harness_describe for fields per resource_type. | |
| compact | No | Strip verbose metadata from list items, keeping only essential fields (default true) | |
| filters | No | Resource-specific filters as key-value pairs. Available keys across enabled resource types: search_term, module, filter_type, pipeline_id, status, branch, my_deployments, execution_id, approval_status, approval_type, node_execution_id, sort, order, env_type, type, category, connector_names, connector_identifiers, connectivity_statuses, connector_connectivity_modes, description, inheriting_credentials_from_delegate, tags, include_all_connectors_available_at_scope, environment_id, deployment_type, secret_identifier, secret_name, secret_manager_identifiers, include_all_secrets_accessible_at_scope, audit_resource_type, action, start_time, end_time, all, delegate_name, delegate_type, host_name, delegate_group_identifier, delegate_instance_filter, auto_upgrade, version_status, name, query, git_ref, path, since, until, committer, inherited, search, package_type, template_type, template_list_type, global, metadata_only, entity_type, folder_id, kind, scope_level, owned_by_me, favorites, owner, lifecycle, sort_type, sort_order, is_custom, entity_identifier, state, after, before, offset, workspace_id, rollout_status_id, segment_name, repo_creds_id, agent_id, app_name, namespace, resource_name, group, version, scope, experiment_name, infra_id, experiment_ids, start_date, end_date, target_network_map_ids, my_experiments, exclude_automation, probe_ids, infra_type, sort_field, sort_ascending, experiment_run_ids, notify_ids, hub_identity, infrastructure_type, infrastructure, include_all_scope, experiment_id, is_identity, include_legacy_infra, infra_scope, is_ai_enabled, is_enterprise, fault_id, permissions_required, only_templatised_faults, environment_type, minimal, agent_identity, cloud_filter, view_state, view_type, view_ids, folder_name_pattern, group_by, time_filter, limit, time_resolution, min_saving, perspective_id, anomaly_view, search_text, order_by_field, order_by_direction, min_amount, min_anomalous_spend, value_type, value_sub_type, is_cluster_query, is_cluster_hourly_data, search_key, page, size, aspect, integration_type, profile_id, team_ref_id, date_start, date_end, granularity, metric_type, artifact_type, source_id, artifact_id, dependency_type, oss_risk_filter, standards, enforcement_id, purl, drift_id, severity_codes, issue_types, target_ids, target_types, pipeline_ids, scan_tools, exemption_statuses, stages, steps, product_names, include_exempted, origins, origin_statuses, epss, epss_percentile, severity_overridden, reachability, exploitability, page_existing, page_size_existing, page_new, page_size_new, migration_type, dbschema_id, dbinstance_id, object_type, principal_type, role_identifier, resource_group_identifier, include_parent_scopes, identifiers, sort_orders, page_token, has_module, module_type, only_favorites, identifier_filter, exclude_rego, include_policy_set_count, entity, created_date_from, created_date_to, include_child_scopes, freeze_status, service_id, target_id, dataset_id, metric_set_id, run_id, eval_id, set_id, suite_id, trace_id, label, annotator_type, tag, provider, activity_id, kinds, annotations, object_kind, severity, impacted_service, environment, commander, text, reported_after, reported_before, sort_direction, service, deployed_after, deployed_before. Call harness_describe for filters available on a specific resource_type. | |
| project_id | No | Project identifier (overrides default) | |
| search_term | No | Filter results by name or keyword | |
| resource_type | No | Resource type to list. Auto-detected from url. | |
| resource_scope | No | Scope to query. Use account for account-level resources and to omit org/project defaults; org injects only org; project injects org+project. Auto-detected from url. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Current page number (0-indexed) when provided by the API | |
| items | No | Array of resource objects or primitive values when the API returns a canonical list | |
| total | No | Total number of matching resources when provided by the API |