---
title: "Update milestone"
method: POST
path: "/sites/{site_id}/milestones/{milestone_id}"
tags: ["Milestones"]
---

# Update milestone

`POST /sites/{site_id}/milestones/{milestone_id}`

Update a milestone. Both `name` and `milestone_date` are required.

**Permissions:** Requires write access to the site (`manage:{site_id}`).

**Returns:** A milestone object.

## Path parameters

- `site_id` string, required
- `milestone_id` string, required

## Request body

- object
  - `name` string, required — The name of the milestone (up to 30 characters).
  - `milestone_date` string, required — The date of the milestone in `YYYY-MM-DD` format.

## Response `200`

Successful response

## Other responses

- `400` — Bad request. Returned for validation failures and other request problems. Send `Accept: application/json` to receive errors as JSON.
- `401` — Authentication failed — the API token is missing, malformed or invalid.

---

[API](https://skmtc.net/usefathom/apis/fathom-analytics-api.md) · [All operations](https://skmtc.net/usefathom/apis/fathom-analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usefathom/fathom-analytics-api/revisions/50679caad756/schema)