Source: https://datafa.st/docs/api/account/goal-customizations/delete
Markdown source: https://datafa.st/docs/api/account/goal-customizations/delete.md
Description: Reset one goal's display metadata. Requires goalName query parameter.

# Delete goal customization

`DELETE https://datafa.st/api/v1/admin/websites/{websiteId}/goals/customizations`

Remove saved display metadata for one goal. The goal returns to its default raw name and automatic chart color.

> **Related:** [Custom goals](/docs/custom-goals)

## Request

#### Path parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `websiteId` | string | — | Website ObjectId. From [List websites](/docs/api/account/websites/list) (`_id` field). Example: `665f0b3c4d2e1a0012345678`. |

#### Query parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `goalName` | string | Yes | Raw tracked goal name to reset. Example: `signup_started`. |

## Response

Returns a JSON object with `status: "success"` and endpoint-specific fields in `data`.

#### Response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[].deleted` | boolean | True when a saved customization was removed. |
| `data[].goalName` | string | Goal name that was reset. |

### Authentication

Use a `dft_` account token with `goals:write`.

A `df_` website API key for the same website can also call this route when the path `websiteId` matches the key's website. Write access with a `df_` key is capped at **member** level — owner-only actions such as [team management](/docs/api/account/team) require a `dft_` token and owner role.

### Errors

**400** — Missing or invalid `goalName` query parameter.

See [API errors](/docs/api#errors) for the standard error envelope, auth failures, validation errors, permission errors, and rate limits.

## Code examples

### Example request

```bash
curl -X DELETE "https://datafa.st/api/v1/admin/websites/{websiteId}/goals/customizations" \
  -H "Authorization: Bearer dft_xxx"
```

### Success response

```json
{
  "status": "success",
  "data": [{
    "deleted": true,
    "goalName": "signup_started"
  }]
}
```