Skip to main content
PATCH
/
api
/
v1
/
users
/
:id
Update User
curl --request PATCH \
  --url https://api.example.com/api/v1/users/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "middle_name": "<string>",
  "filing_status": "<string>",
  "employment_type": "<string>"
}
'
{
  "id": 1,
  "email": "[email protected]",
  "first_name": "Jane",
  "last_name": "Smith",
  "filing_status": "married_jointly",
  "employment_type": "w2"
}
Updates the authenticated user’s profile. Only the user themselves can update their profile (enforced server-side).

​
Path Parameters

​
id
integer
required
The user’s ID. Must match the authenticated user.

​
Request Body

​
first_name
string
First name.
​
last_name
string
Last name.
​
middle_name
string
Middle name.
​
filing_status
string
Tax filing status. One of: single, married_jointly, married_separately, head_of_household.
​
employment_type
string
Employment classification. One of: w2, 1099.

​
Request

curl -X PATCH \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"filing_status": "married_jointly", "employment_type": "w2"}' \
  https://app.taxhomebase.com/api/v1/users/1

​
Response

{
  "id": 1,
  "email": "[email protected]",
  "first_name": "Jane",
  "last_name": "Smith",
  "filing_status": "married_jointly",
  "employment_type": "w2"
}

​
Errors

StatusErrorCause
400Invalid filing statusfiling_status not in allowed values
400Invalid employment typeemployment_type not in allowed values
403ForbiddenAttempting to update another user’s profile
404User not foundUser ID doesn’t exist