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

# V0 - Manage approvers on values (externalId)

> Updates only the approver assignments on existing values of a custom dimension's list — leaves the values themselves untouched. Send the desired approver set per value in the body; pass `clearApproversNotInInput=true` to also strip approvers from values not mentioned. Use this to sync approver mappings from an HR or identity-management system without affecting the value catalogue.



## OpenAPI

````yaml openapi/findity-admin-api-1.json PUT /organizations/externalid/{externalId}/customdimensions/{definitionExternalId}/list/approvers/
openapi: 3.0.3
info:
  title: Findity Admin API
  description: ''
  version: 1.0.0
  contact:
    name: Findity Support
    email: support@findity.com
servers:
  - url: https://stage-expense.findity.com/api/admin
    description: Stage environment
  - url: https://expense.findity.com/api/admin
    description: Production environment
security:
  - bearerAuth: []
paths:
  /organizations/externalid/{externalId}/customdimensions/{definitionExternalId}/list/approvers/:
    put:
      tags:
        - dimension lists
      summary: V0 - Manage approvers on values (externalId)
      description: >-
        Updates only the approver assignments on existing values of a custom
        dimension's list — leaves the values themselves untouched. Send the
        desired approver set per value in the body; pass
        `clearApproversNotInInput=true` to also strip approvers from values not
        mentioned. Use this to sync approver mappings from an HR or
        identity-management system without affecting the value catalogue.
      operationId: e27b1441-7a53-4e4a-9d1f-60028944d800
      parameters:
        - $ref: '#/components/parameters/externalId'
        - name: X-Findity-ApiVersion
          in: header
          schema:
            type: string
            default: '3'
          description: Findity API version. Use `3` for the current admin API.
        - name: Content-Type
          in: header
          schema:
            type: string
            default: text/plain; charset=utf-8
          description: Standard `application/json` content type.
        - $ref: '#/components/parameters/definitionExternalId'
        - name: definitionExternalId
          in: header
          schema:
            type: string
            default: '3'
            description: ''
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                values:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                      approvers:
                        type: array
                        items:
                          type: object
                          properties:
                            externalSourceId:
                              type: string
                            sortOrder:
                              type: integer
                            personExternalSourceId:
                              type: string
                            delete:
                              type: boolean
            example:
              values:
                - id: proj-001
                  approvers:
                    - personExternalSourceId: emp-jane-smith
                      sortOrder: 0
                      amountLimit: null
                - id: proj-002
                  approvers:
                    - externalSourceId: approver-001
                      personExternalSourceId: emp-john-doe
                      sortOrder: 0
                      amountLimit: 5000
                    - id: 4ea7878a42406b3305c5d1087a3a86b0
                      personExternalSourceId: emp-carol-park
                      sortOrder: 1
                      amountLimit: null
      responses:
        '200':
          description: OK
          content:
            application/json:
              example:
                listKey: >-
                  CUSTOM_DIMENSIONS_b1c2d3e4f5a6b1c2d3e4f5a6b1c2d3e4_8ab28cb36ccde07d016ccdfb47d00216
                lastUpdated: '2026-05-28T14:35:00Z'
        '404':
          description: Not found
          content:
            application/json:
              example:
                result: error
                description: custom field list not found
components:
  parameters:
    externalId:
      in: path
      name: externalId
      required: true
      description: The external source id of the organization
      schema:
        type: string
      example: 6aeb86c4fb154c46b2b5a1977245ac67
    definitionExternalId:
      in: path
      name: definitionExternalId
      required: true
      description: The external id of the dimension
      schema:
        type: string
      example: 6aeb86c4fb154c46b2b5a1977245ac67
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````