> ## 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 - Update dimensions (internalId)

> Creates, updates, or removes custom dimension definitions on the organization. The request body is the full set of dimensions to apply: definitions in the body are upserted; definitions present on the organization but absent from the body may be removed. After applying changes, the API rebuilds the dimension lists, custom fields, and the dimension script for the organization. The organization must be writable.



## OpenAPI

````yaml openapi/findity-admin-api-1.json PUT /organizations/{internalId}/customdimensions/
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/{internalId}/customdimensions/:
    put:
      tags:
        - dimensions
      summary: V0 - Update dimensions (internalId)
      description: >-
        Creates, updates, or removes custom dimension definitions on the
        organization. The request body is the full set of dimensions to apply:
        definitions in the body are upserted; definitions present on the
        organization but absent from the body may be removed. After applying
        changes, the API rebuilds the dimension lists, custom fields, and the
        dimension script for the organization. The organization must be
        writable.
      operationId: 2147aae6-6ae4-457d-81f1-1f9e488bf5a2
      parameters:
        - $ref: '#/components/parameters/internalId'
        - name: Content-Type
          in: header
          schema:
            type: string
            default: text/plain; charset=utf-8
            description: Standard `application/json` content type.
        - name: X-Findity-ApiVersion
          in: header
          schema:
            type: string
            default: '3'
            description: Findity API version. Use `3` for the current admin API.
      requestBody:
        description: >-
          The full set of custom dimension definitions to apply to the
          organization.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ArrayOfDimensions'
      responses:
        '200':
          description: Custom dimension definitions saved.
          content:
            application/json:
              example:
                result: success
                description: custom dimension definition updated
                dimensions:
                  - id: 5e1a8d1b3c4f4d2db8a6e1d7c2f5a3b9
                    definition: null
                    description: Project
                    type: CUSTOM
                    level: EXPENSE
                    presetLocation: NONE
                    controlType: LIST_SEARCHABLE
                    userOverridable: true
                    externalSourceId: project
                    useDateInterval: false
                    recipientId: null
                    useAsRecipientFilter: false
                    visibleIfNoPreset: true
                    hideDimensionValues: false
                    usedInCarbonFootprint: false
                    deviateOnCreditRow: false
                    deviatingCreditRowValue: null
components:
  parameters:
    internalId:
      in: path
      name: internalId
      required: true
      description: The internal id of the organization
      schema:
        type: string
      example: 6aeb86c4fb154c46b2b5a1977245ac67
  schemas:
    ArrayOfDimensions:
      type: array
      items:
        type: object
        properties:
          externalSourceId:
            type: string
            description: >-
              Can be used to address a dimension with a globally unique id from
              external system
          description:
            type: string
            description: Name of dimension
          level:
            type: string
            enum:
              - EXPENSE
              - EXPENSE_REPORT
            description: Where the dimension is presented
          controlType:
            type: string
            enum:
              - LIST_SEARCHABLE
              - TEXT
            description: If the dimension is a fixed list or a free text field
          presetLocation:
            type: string
            enum:
              - NONE
              - EMPLOYEE
              - DEPARTMENT
              - CATEGORY
            description: If preset is used, this defines where the preset is set
          userOverridable:
            type: boolean
            description: If preset is used, this controls if user can change the preset
          visibleIfNoPreset:
            type: boolean
            description: >-
              If preset is not used, this indicates if the dimension should be
              shown or not
        example:
          externalSourceId: project
          description: Project
          level: EXPENSE
          controlType: LIST_SEARCHABLE
          presetLocation: NONE
          userOverridable: true
          visibleIfNoPreset: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````