---
title: "corestack_company_performance_audit_update"
url: https://docs.corefinity.com/mcp/tools/corestack_company_performance_audit_update
type: tool
last_updated: 2026-11-13
feature: performance-audits
related:
  - https://docs.corefinity.com/guides/tools/performance-audits.md
---
# corestack_company_performance_audit_update

**Change a performance audit.** Change a performance audit's name, environments, pages, number of requests, user agent, server location, or its shared report's sections and login; only what you send changes. Scope: write.

- Scope: `write`
- Runs as a task: no

## When to use it

Change a performance audit as the Control Panel's edit form does: its name, environments, pages, number of requests, user agent or server location, and its shared report's sections and login. Only the arguments you send change; the saved results stay until the audit runs again (corestack_company_performance_audit_run). While a run is queued or running only the shared report's settings can change.

## Inputs

- `audit_id` (integer, ≥ 1, required)
- `name` (string, 1–255)
- `domains` (array, 1–10, replaces the environments): each `{environment, url, http_username?, http_password?}`; `environment` up to 100 characters and unique, `url` an http or https URL. A domain that leaves out `http_username` or `http_password` keeps the one saved for the environment of that name; send an empty string to remove it. Neither is ever answered (`http_auth` says whether one is set).
- `page_types` (array, 1–20, replaces the pages): each `{title, path?, check_cache?}`; `title` up to 100 characters and unique.
- `number_of_requests` (integer, 1–20)
- `user_agent` (string, up to 255)
- `server_location` (integer): a server location's id.
- `report_sections` (array): the shared report's sections in order, each `{key, enabled}`, keys as corestack_company_performance_audit_get answers them under `report.sections`. The headline always stays first and the contact block last; a section left out keeps its place and whether it shows, and the sections sent take the places they held, in the order sent.
- `report_password_protected` (boolean): whether the shared link asks for a username and password first. Turning it on needs a username and a password, sent now or set before.
- `report_username` (string, up to 64): the username the shared link asks for.
- `report_password` (string, 10 to 72 characters and at most 72 bytes, so fewer with accented letters, with no NUL character and not only spaces; any other is refused with `invalid_arguments`): the password the shared link asks for. Never answered; leave it out to keep the one set. Changing the protection, the username or the password signs out everyone who unlocked the link before.

Answers the audit as corestack_company_performance_audit_get does, without its results and log.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "audit_id": {
      "minimum": 1,
      "type": "integer"
    },
    "domains": {
      "items": {
        "properties": {
          "environment": {
            "maxLength": 100,
            "type": "string"
          },
          "http_password": {
            "maxLength": 255,
            "type": "string"
          },
          "http_username": {
            "maxLength": 255,
            "type": "string"
          },
          "url": {
            "maxLength": 255,
            "type": "string"
          }
        },
        "required": [
          "environment",
          "url"
        ],
        "type": "object"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array"
    },
    "name": {
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    },
    "number_of_requests": {
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "page_types": {
      "items": {
        "properties": {
          "check_cache": {
            "type": "boolean"
          },
          "path": {
            "maxLength": 255,
            "type": "string"
          },
          "title": {
            "maxLength": 100,
            "type": "string"
          }
        },
        "required": [
          "title"
        ],
        "type": "object"
      },
      "maxItems": 20,
      "minItems": 1,
      "type": "array"
    },
    "report_password": {
      "description": "Write-only: never answered. Leave it out to keep the one set.",
      "maxLength": 72,
      "minLength": 10,
      "type": "string"
    },
    "report_password_protected": {
      "description": "Whether the shared link asks for a username and password first.",
      "type": "boolean"
    },
    "report_sections": {
      "description": "The report's sections in order, each shown or not; the headline stays first and the contact block last.",
      "items": {
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "key": {
            "enum": [
              "hero",
              "at_a_glance",
              "response_times",
              "gap",
              "improvement",
              "absolute_times",
              "waterfall",
              "filmstrip",
              "full_table",
              "google_scores",
              "definitions",
              "method",
              "timing_breakdown",
              "samples",
              "status_codes",
              "response_headers",
              "raw_lighthouse_json",
              "all_metrics",
              "cta"
            ],
            "type": "string"
          }
        },
        "required": [
          "key",
          "enabled"
        ],
        "type": "object"
      },
      "maxItems": 19,
      "type": "array"
    },
    "report_username": {
      "maxLength": 64,
      "type": "string"
    },
    "server_location": {
      "minimum": 1,
      "type": "integer"
    },
    "user_agent": {
      "maxLength": 255,
      "type": "string"
    }
  },
  "required": [
    "audit_id"
  ],
  "type": "object"
}
```

## Refusals

- `tenant_mismatch`: no such audit, or it belongs to a company you may not access.
- `run_in_progress`: the audit is queued or running and you sent something a run reads (anything but the shared report's settings); wait for it to finish (corestack_company_performance_audit_get), then change it.
- `invalid_arguments`: a value the edit form would refuse (an empty name, a URL that is not http or https, two environments or pages with the same name, an unknown server location, an unknown report section, protection without a username or password, a password shorter than 10 characters).
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_company_performance_audit_update",
  "arguments": {
    "audit_id": 276,
    "name": "Before and after the move",
    "page_types": [
      {"title": "Home", "path": "/", "check_cache": true},
      {"title": "Basket", "path": "/checkout/cart/"}
    ]
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_company_performance_audit_update with audit_id 276, name Before and after the move, page_types [{"title":"Home","path":"/","check_cache":true},{"title":"Basket","path":"/checkout/cart/"}]. (Change a performance audit.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Performance audits](https://docs.corefinity.com/guides/tools/performance-audits.md)
