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

Request

Path parameters

websiteId

string

Website ObjectId. From List websites (_id field). Example: 665f0b3c4d2e1a0012345678.

Query parameters

goalName

string

required

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

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 require a dft_ token and owner role.

Errors

400 — Missing or invalid goalName query parameter.

See API errors for the standard error envelope, auth failures, validation errors, permission errors, and rate limits.

✍️ Something missing? Suggest features.

🤖 AI agent or LLM? Read this page as markdown