> ## 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 custom dimension value

> Partially updates a value within a custom dimension definition. Only fields included in the request body are updated; omitted fields are left unchanged. 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 put /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}:
    put:
      tags:
        - Dimensions
      summary: Update custom dimension value
      description: >
        Partially updates a value within a custom dimension definition. Only
        fields included in the request body are updated; omitted fields are left
        unchanged. 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: adminUpdateCustomDimensionValue
      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 update, as returned in the
            `id` field of the list values response.
          schema:
            type: string
            example: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdminApiCustomDimensionValuePutRequest'
            example:
              value: Marketing Updated
              sortOrder: 1
      responses:
        '200':
          description: OK — returns the updated custom dimension value
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminApiCustomDimensionValue'
              example:
                id: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
                value: Marketing
                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.
                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: value is required
        '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:
    AdminApiCustomDimensionValuePutRequest:
      type: object
      properties:
        value:
          type: string
          description: >-
            Display text of the dimension 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
    AdminApiCustomDimensionValue:
      type: object
      required:
        - id
        - value
      properties:
        id:
          type: string
          description: Unique identifier of the dimension value.
        value:
          type: string
          description: Display text of the dimension 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

````