# Delete store logo (`delete_store_logo`)

Removes the Store logo, which branded emails show, or the logo of the hosted Customiser Links page, and deletes the stored file unless something else still uses it. The file cannot be recovered through this API, so the call needs confirm: true. A logo that is already empty is reported as not found. It requires the store:write scope and an idempotency_key, and supports dry_run.

- Source URL: https://www.signcustomiser.com/help/mcp/tools/delete_store_logo/
- Markdown URL: https://www.signcustomiser.com/help/mcp/tools/delete_store_logo.md
- MCP endpoint: https://mcp.signcustomiser.com
- Required scope: `store:write`
- Behaviour: destructive write

## Purpose

Take the Store logo or the Customiser Links page logo away.

## Annotations

| Hint | Value |
| --- | --- |
| readOnlyHint | false |
| destructiveHint | true |
| idempotentHint | true |
| openWorldHint | false |

## Prerequisites

- get_store or get_customiser_links to confirm that the logo is set.
- A merchant has connected this store and approved the store:write scope.

## Side effects

- Clears the logo and deletes its file permanently, unless something else still uses it.
- Claims the idempotency_key for at least 24 hours.

## Arguments

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `logo` | string | yes | Which logo to remove: store for the Store logo that branded emails show, customiser_links for the hosted Customiser Links page logo. One of: `store`, `customiser_links`. |
| `confirm` | boolean | unless `dry_run` is true | Must be true to apply the change, because the file is deleted permanently. Without it the call returns a confirmation_required error and changes nothing. |
| `idempotency_key` | string | unless `dry_run` is true | A client-generated key unique to this logical write, such as a UUID. Required: repeating the call with the same key and the same arguments replays the original result instead of writing twice, and the same key with different arguments is an idempotency_key_conflict. |
| `dry_run` | boolean | no | When true, the logo is checked and nothing is removed is checked and nothing is written: the result is the same verdict the apply would have reached, and a problem the apply would have raised comes back as the same tool error. Defaults to false. A dry run claims no key. A dry run does not require the confirm argument. |

## Result

The logo that was cleared, the file that was removed, and the Store or the Customiser Links page as it now stands. A dry run returns the delete verdict and removes nothing.

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `request_id` | string | yes |  |
| `store` | object | yes |  |
| `store.id` | integer | yes |  |
| `store.name` | string | yes |  |
| `logo` | string | yes | The logo the call addressed. One of: `store`, `customiser_links`. |
| `removed_file` | object | no | The file that was removed. Absent on a dry run. |
| `removed_file.filename` | string or null | no | Always null: the Store keeps only the stored path of its logo. |
| `removed_file.url` | string | yes |  |
| `resource` | object | no | The Store, or the Customiser Links page, as it now stands with logo_url null. Absent on a dry run. |
| `idempotent_replay` | boolean | no | True when this call replayed a previously recorded response for the same idempotency_key instead of applying the write again. |
| `dry_run` | boolean | no | Present and true only when dry_run was requested. |
| `valid` | boolean | no | Present only on a dry run, and always true: a failing dry run returns a tool error instead. |
| `verdict` | object | no | Present only on a dry run: the delete verdict. |

## Error cases

| Code | Recovery |
| --- | --- |
| `confirmation_required` | Send confirm: true. The file is deleted permanently and cannot be recovered through this API. |
| `insufficient_scope` | The connection was approved without store:write. Ask the merchant to reconnect and approve it, or to remove the connector and add it again if the approval screen does not offer it. |
| `resource_not_found` | The logo is already empty. |

## Example: Remove the Customiser Links page logo

Request:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_store_logo",
    "arguments": {
      "logo": "customiser_links",
      "confirm": true,
      "idempotency_key": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d"
    }
  }
}
```

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t",
      "store": {
        "id": 12,
        "name": "Demo Signs"
      },
      "logo": "customiser_links",
      "removed_file": {
        "filename": null,
        "url": "https://cdn.signcustomiser.com/files/8a1d4c2e.png"
      },
      "resource": {
        "enabled": true,
        "return_url": "https://demosigns.example",
        "theme_colour": "#FFFFFF",
        "logo_url": null,
        "updated_at": "2026-11-16T09:30:00Z"
      },
      "idempotent_replay": false
    }
  }
}
```

## Example: The connection was not granted store:write (error)

Request:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_store_logo",
    "arguments": {
      "logo": "store",
      "confirm": true,
      "idempotency_key": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d"
    }
  }
}
```

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": true,
    "structuredContent": {
      "error": {
        "code": "insufficient_scope",
        "title": "Insufficient scope",
        "detail": "The tool [delete_store_logo] requires the store:write scope, which this connection was not granted.",
        "recovery": "The connection was authorised without the scope this tool needs. Ask the merchant to reconnect the Sign Customiser connector and approve the scope named in required_scopes. If the approval screen does not offer that permission, ask them to remove the connector from this AI agent and add it again. Do not retry this call.",
        "required_scopes": [
          "store:write"
        ],
        "granted_scopes": [
          "store:read"
        ]
      }
    }
  }
}
```
