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

# Delete custom dimension value

> Permanently deletes a value from a custom dimension definition. Returns 400 when the value is in use and cannot be deleted. Returns 403 when the organization does not exist or the authenticated user is not an administrator of it. Returns 404 when the custom dimension definition or the value is not found.




## OpenAPI

````yaml /openapi/findity-admin-api.json delete /organizations/{organizationId}/customdimensions/{definitionId}/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}/customdimensions/{definitionId}/values/{valueId}:
    delete:
      tags:
        - Dimensions
      summary: Delete custom dimension value
      description: >
        Permanently deletes a value from a custom dimension definition. Returns
        400 when the value is in use and cannot be deleted. Returns 403 when the
        organization does not exist or the authenticated user is not an
        administrator of it. Returns 404 when the custom dimension definition or
        the value is not found.
      operationId: adminDeleteCustomDimensionValue
      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: definitionId
          in: path
          required: true
          description: >-
            String. The ID of the custom dimension definition, as returned in
            the `id` field of the GET definition response.
          schema:
            type: string
            example: abc123def456abc123def456abc123de
        - name: valueId
          in: path
          required: true
          description: >-
            String. The ID of the dimension value to delete, as returned in the
            `id` field of the list values response.
          schema:
            type: string
            example: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
      responses:
        '204':
          description: No Content — dimension value successfully deleted
        '400':
          description: Bad request — dimension value is in use and cannot be deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400Error'
              examples:
                Dimension value in use by tax rate configuration:
                  value:
                    result: error
                    code: CUSTOM_DIMENSION_VALUE_IN_USE
                    description: Dimension value is in use by tax rate configuration
                Dimension value in use as deviating credit row value:
                  value:
                    result: error
                    code: CUSTOM_DIMENSION_VALUE_IN_USE
                    description: Dimension value is in use as a deviating credit row value
                Dimension value in use by employee preset:
                  value:
                    result: error
                    code: CUSTOM_DIMENSION_VALUE_IN_USE
                    description: Dimension value is in use by active employee presets
        '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 — custom dimension definition or value does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404Error'
              examples:
                Custom dimension definition not found:
                  value:
                    result: error
                    code: CUSTOM_DIMENSION_DEFINITION_NOT_FOUND
                    description: Custom dimension definition not found
                Custom dimension value not found:
                  value:
                    result: error
                    code: CUSTOM_DIMENSION_VALUE_NOT_FOUND
                    description: Custom dimension value not found
components:
  schemas:
    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

````