Update an employee's state taxes

PUT {{baseUrl}}/v1/employees/:employee_uuid/state_taxes

Update attributes relevant for an employee's state taxes.

As described for the GET endpoint, the answers must be supplied in the effective-dated format, but currently only a single answer will be accepted - valid_from and valid_up_to must be "2010-01-01" and null respectively.

scope: employee_state_taxes:write

Request Body

{"states"=>[{"state"=>"<string>", "questions"=>[{"key"=>"<string>", "answers"=>[{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, {"value"=>"<Error: Too many levels of nesting to fake this schema>"}]}, {"key"=>"<string>", "answers"=>[{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, {"value"=>"<Error: Too many levels of nesting to fake this schema>"}]}]}, {"state"=>"<string>", "questions"=>[{"key"=>"<string>", "answers"=>[{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, {"value"=>"<Error: Too many levels of nesting to fake this schema>"}]}, {"key"=>"<string>", "answers"=>[{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, {"value"=>"<Error: Too many levels of nesting to fake this schema>"}]}]}]}

HEADERS

KeyDatatypeRequiredDescription
X-Gusto-API-VersionstringDetermines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;employee_uuid&quot;:&quot;92fa4d30-e284-43d0-a26e-605619c04beb&quot;,&quot;file_new_hire_report&quot;:false,&quot;is_work_state&quot;:true,&quot;state&quot;:&quot;CA&quot;,&quot;questions&quot;:[{&quot;label&quot;:&quot;Filing Status&quot;,&quot;description&quot;:&quot;The Head of Household status applies to unmarried individuals who have a relative living with them in their home. If unsure, read the \u003ca target=&#39;_blank&#39; data-bypass rel=&#39;noopener noreferrer&#39; tabindex=&#39;99&#39; href=&#39;https://www.ftb.ca.gov/file/personal/filing-status/index.html&#39;\u003eCA Filing Status explanation\u003c/a\u003e.\n&quot;,&quot;key&quot;:&quot;filing_status&quot;,&quot;input_question_format&quot;:{&quot;type&quot;:&quot;Select&quot;,&quot;options&quot;:[{&quot;value&quot;:&quot;S&quot;,&quot;label&quot;:&quot;Single&quot;},{&quot;value&quot;:&quot;M&quot;,&quot;label&quot;:&quot;Married one income&quot;},{&quot;value&quot;:&quot;MD&quot;,&quot;label&quot;:&quot;Married dual income&quot;},{&quot;value&quot;:&quot;H&quot;,&quot;label&quot;:&quot;Head of household&quot;},{&quot;value&quot;:&quot;E&quot;,&quot;label&quot;:&quot;Do Not Withhold&quot;}]},&quot;answers&quot;:[{&quot;value&quot;:&quot;S&quot;,&quot;valid_from&quot;:&quot;2010-01-01&quot;,&quot;valid_up_to&quot;:null}]},{&quot;label&quot;:&quot;Withholding Allowance&quot;,&quot;description&quot;:&quot;This value is needed to calculate the employee&#39;s CA income tax withholding. If unsure, use the \u003ca target=&#39;_blank&#39; data-bypass rel=&#39;noopener noreferrer&#39; tabindex=&#39;99&#39; href=&#39;http://www.edd.ca.gov/pdf_pub_ctr/de4.pdf&#39;\u003eCA DE-4 form\u003c/a\u003e to calculate the value manually.\n&quot;,&quot;key&quot;:&quot;withholding_allowance&quot;,&quot;input_question_format&quot;:{&quot;type&quot;:&quot;Number&quot;},&quot;answers&quot;:[{&quot;value&quot;:1,&quot;valid_from&quot;:&quot;2010-01-01&quot;,&quot;valid_up_to&quot;:null}]},{&quot;label&quot;:&quot;Additional Withholding&quot;,&quot;description&quot;:&quot;You can withhold an additional amount of California income taxes here.&quot;,&quot;key&quot;:&quot;additional_withholding&quot;,&quot;input_question_format&quot;:{&quot;type&quot;:&quot;Currency&quot;},&quot;answers&quot;:[{&quot;value&quot;:&quot;0.0&quot;,&quot;valid_from&quot;:&quot;2010-01-01&quot;,&quot;valid_up_to&quot;:null}]},{&quot;label&quot;:&quot;File a New Hire Report?&quot;,&quot;description&quot;:&quot;State law requires you to file a new hire report within 20 days of hiring or re-hiring an employee.&quot;,&quot;key&quot;:&quot;file_new_hire_report&quot;,&quot;input_question_format&quot;:{&quot;type&quot;:&quot;Select&quot;},&quot;answers&quot;:[{&quot;value&quot;:true,&quot;valid_from&quot;:&quot;2010-01-01&quot;,&quot;valid_up_to&quot;:null}]}]}