# Goal \[UPDATE]

```
PUT 
/goals/:goalId
```

**Required Permissions**: `Goal Edit` or `Goal Admin`

> **caution**
>
> Regular fields provided in the request will be updated. Regular fields not included in the request body will retain their existing values.
>
> However, if relationship fields (`tags`, `owners`, or `teams`) are included in the request, ALL existing related records will be DELETED and replaced with only those provided in the request.

## Request

## Responses

* 200
* 400
* 401
* 403
* 404

OK

Bad Request

Unauthorized

Forbidden

Goal not found