> ## 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

> Updates the description of an existing tax code. Returns 403 when the organization does not exist or the authenticated user is not an administrator of it. Returns 404 when the tax code is not found.




## OpenAPI

````yaml /openapi/findity-admin-api.json put /organizations/{organizationId}/taxcodes/{taxCodeId}
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}:
    put:
      tags:
        - Tax codes
      summary: Update tax code
      description: >
        Updates the description of an existing tax code. Returns 403 when the
        organization does not exist or the authenticated user is not an
        administrator of it. Returns 404 when the tax code is not found.
      operationId: adminUpdateTaxCode
      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 to update (32-character hex string),
            as returned in the `id` field of the list or GET response.
          schema:
            type: string
            example: 63b7a7802a644e8ca296c9796ffa7074
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdminApiTaxCodePutRequest'
            example:
              description: Swedish VAT 25% Updated
      responses:
        '200':
          description: OK — returns the updated tax code
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminApiTaxCode'
              example:
                id: 63b7a7802a644e8ca296c9796ffa7074
                description: Swedish VAT 25%
        '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.
                No known properties:
                  value:
                    result: error
                    code: NO_KNOWN_JSON_PROPERTIES
                    description: Request body contains no known properties
                Invalid property value:
                  value:
                    result: error
                    code: INVALID_JSON_PROPERTY_VALUE
                    description: Description is required
                Description too long:
                  value:
                    result: error
                    code: FIELD_EXCEEDS_MAX_LENGTH
                    description: Description 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 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
components:
  schemas:
    AdminApiTaxCodePutRequest:
      type: object
      required:
        - description
      properties:
        description:
          type: string
          description: >-
            Display name of the tax code. Must be non-empty and not
            whitespace-only.
          maxLength: 255
    AdminApiTaxCode:
      type: object
      required:
        - id
        - description
      properties:
        id:
          type: string
          description: Unique identifier for the tax code.
        description:
          type: string
          description: Display name of the tax code.
    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

````