> ## Documentation Index
> Fetch the complete documentation index at: https://developer.findity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update tax code value

> Partially updates a value for the given tax code. Only fields included in the request body are updated; omitted fields are left unchanged. The `id` cannot be changed and is ignored if included in the request body. Returns 403 when the organization does not exist or the authenticated user is not an administrator of it. Returns 404 when the tax code or the value is not found.




## OpenAPI

````yaml /openapi/findity-admin-api.json put /organizations/{organizationId}/taxcodes/{taxCodeId}/values/{valueId}
openapi: 3.1.0
info:
  title: Findity Admin API
  description: Findity Admin API
  version: 1.0.0
servers:
  - url: https://stage-api.findity.com/api/v1/admin
  - url: https://api.findity.com/api/v1/admin
security:
  - bearerAuth: []
paths:
  /organizations/{organizationId}/taxcodes/{taxCodeId}/values/{valueId}:
    put:
      tags:
        - Tax codes
      summary: Update tax code value
      description: >
        Partially updates a value for the given tax code. Only fields included
        in the request body are updated; omitted fields are left unchanged. The
        `id` cannot be changed and is ignored if included in the request body.
        Returns 403 when the organization does not exist or the authenticated
        user is not an administrator of it. Returns 404 when the tax code or the
        value is not found.
      operationId: adminUpdateTaxCodeValue
      parameters:
        - name: organizationId
          in: path
          required: true
          description: >
            String. The organization's internal ID (32-character hex string) or
            its `externalSourceId`. When the value matches the format of an
            internal ID, the internal ID takes precedence.
          schema:
            type: string
            example: 11adfe2a080040e3892ffb89c21ec44e
        - name: taxCodeId
          in: path
          required: true
          description: >-
            String. The ID of the tax code whose value to update (32-character
            hex string), as returned in the `id` field of the list or GET
            response.
          schema:
            type: string
            example: 63b7a7802a644e8ca296c9796ffa7074
        - name: valueId
          in: path
          required: true
          description: >-
            String. The ID of the tax code value to update, as returned in the
            `id` field of the list values response.
          schema:
            type: string
            example: VAT25
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdminApiTaxCodeValuePutRequest'
            example:
              value: 50%
              sortOrder: 10
      responses:
        '200':
          description: OK — returns the updated tax code value
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminApiTaxCodeValue'
              example:
                id: VAT25
                value: 25%
                sortOrder: 0
                startDate: null
                endDate: null
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400Error'
              examples:
                Invalid JSON body:
                  value:
                    result: error
                    code: INVALID_JSON_BODY
                    description: Failed to parse json body.
                Invalid property value:
                  value:
                    result: error
                    code: INVALID_JSON_PROPERTY_VALUE
                    description: value is required
                Field exceeds max length:
                  value:
                    result: error
                    code: FIELD_EXCEEDS_MAX_LENGTH
                    description: value exceeds maximum length of 255 characters.
        '403':
          description: Forbidden — organization not found or access denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403Error'
              examples:
                Organization not found or access denied:
                  value:
                    result: error
                    description: Organization not found or access denied
        '404':
          description: Not found — tax code or value does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404Error'
              examples:
                Tax code not found:
                  value:
                    result: error
                    code: TAX_CODE_NOT_FOUND
                    description: Tax code not found
                Tax code value not found:
                  value:
                    result: error
                    code: TAX_CODE_VALUE_NOT_FOUND
                    description: Tax code value not found
components:
  schemas:
    AdminApiTaxCodeValuePutRequest:
      type: object
      properties:
        value:
          type: string
          description: >-
            Display text of the tax code value. Must be non-empty and not
            whitespace-only.
          maxLength: 255
        sortOrder:
          type: integer
          description: Sort position of the value within the list.
          nullable: true
        startDate:
          type: string
          format: date-time
          description: Date from which this value is active. ISO 8601 format.
          nullable: true
        endDate:
          type: string
          format: date-time
          description: Date until which this value is active. ISO 8601 format.
          nullable: true
    AdminApiTaxCodeValue:
      type: object
      required:
        - id
        - value
      properties:
        id:
          type: string
          description: Unique identifier of the tax code value.
        value:
          type: string
          description: Display text of the tax code value.
        sortOrder:
          type: integer
          description: Sort position of the value within the list. Null when not set.
          nullable: true
        startDate:
          type: string
          format: date-time
          description: Date from which this value is active. Null when not set.
          nullable: true
        endDate:
          type: string
          format: date-time
          description: Date until which this value is active. Null when not set.
          nullable: true
    400Error:
      type: object
      properties:
        result:
          type: string
        code:
          type: string
        description:
          type: string
    403Error:
      type: object
      properties:
        result:
          type: string
        description:
          type: string
      example:
        result: error
        description: Not allowed
    404Error:
      type: object
      properties:
        result:
          type: string
        code:
          type: string
        description:
          type: string
      example:
        result: error
        code: ORGANIZATION_NOT_FOUND
        description: 'Failed to get organization for id: {orgId}'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````