> ## 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 an approval section > Updates an existing approval section. The `type` field is required in the body and must match the section's type. The `organizationId` path parameter supports both the Findity id and the partner-side `externalId`. ## OpenAPI ````yaml /openapi/findity-admin-api.json put /organizations/{organizationId}/approval/sections/{sectionId} 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}/approval/sections/{sectionId}: put: tags: - Approval summary: Update an approval section description: > Updates an existing approval section. The `type` field is required in the body and must match the section's type. The `organizationId` path parameter supports both the Findity id and the partner-side `externalId`. operationId: adminUpdateApprovalSection parameters: - $ref: '#/components/parameters/organizationIdOrExternalIdInPath' - $ref: '#/components/parameters/sectionIdPath' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ApprovalSectionUpdateRequest' example: type: DEPARTMENT active: true sortOrder: 0 numberOfRequiredApprovals: 2 sendToUnauthorizedApprovers: false responses: '200': description: Approval section successfully updated content: application/json: schema: $ref: '#/components/schemas/ApprovalSection' examples: Approval section updated: value: id: abcdd5f401cf43549a688045b5ceef9b active: true type: DEPARTMENT numberOfRequiredApprovals: 2 sendToUnauthorizedApprovers: false sortOrder: 0 '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/400Error' examples: Number of approvals exceeds main setup or is lower than 1: value: result: error code: INVALID_VALUE_FOR_NUMBER_OF_APPROVALS description: >- Number of approvals has to have minimum value of 1 and cannot be higher than value on default approval setup Approval section type cannot be changed: value: result: error code: APPROVAL_SECTION_TYPE_CANNOT_BE_CHANGED description: Approval section type cannot be changed '404': description: Not found error content: application/json: schema: $ref: '#/components/schemas/404Error' examples: Organization not found: value: result: error code: ORGANIZATION_NOT_FOUND description: Organization not found No active license found for approval for organization: value: result: error code: LICENSE_APPROVAL_NOT_FOUND description: Active license for approval flow not found Approval section not found: value: result: error code: APPROVAL_SECTION_NOT_FOUND description: Section with id {sectionId} is not found components: parameters: organizationIdOrExternalIdInPath: in: path name: organizationId required: true description: >- Unique identifier of the organization. String in UUID without dashes (32-character hex string) if access is done via values from Findity system otherwise, id of external system can be used schema: type: string examples: Findity unique id: value: 05b8daba9ba14a49846fe77883248cf0 External system unique id: value: a31a7372-3397-3924-ffcd-b7b4795e42eb sectionIdPath: in: path name: sectionId required: true description: >- Unique identifier of the approval section. String in UUID without dashes (32-character hex string). schema: $ref: '#/components/schemas/Uuid' example: abcdd5f401cf43549a688045b5ceef9b schemas: ApprovalSectionUpdateRequest: type: object description: >- Request body for updating an existing approval section. Only the fields present in the body are updated. required: - type properties: type: type: string description: >- Type of the approval section. Must match the existing section's type and is used to validate the request. enum: - DEPARTMENT - DIMENSION active: type: boolean description: >- Whether the section is active. When omitted the current value is preserved. sortOrder: type: integer description: > Zero-based position of the section within the organization's list of approval sections. Changing sortOrder reorders sibling sections accordingly. When omitted the current value is preserved. minimum: 0 format: int32 sendToUnauthorizedApprovers: type: boolean description: >- Whether expense reports should be sent to approvers who are not otherwise authorized on the section item. When omitted the current value is preserved. numberOfRequiredApprovals: type: integer description: > Number of sequential approvals required for expense reports evaluated against this section. Must be at least 1 and cannot exceed the value set on the main approval setup. When null or omitted the current value is preserved. minimum: 1 maximum: 3 nullable: true ApprovalSection: type: object description: >- A single approval section — either based on organizational units (DEPARTMENT) or on a custom dimension (DIMENSION). required: - id - type - active - sortOrder properties: id: allOf: - $ref: '#/components/schemas/Uuid' readOnly: true description: Findity identifier of the approval section. active: type: boolean description: Whether the section is active for approval routing. type: type: string description: > Type of the approval section. DEPARTMENT — based on organizational unit structure; DIMENSION — based on a custom expense dimension. enum: - DEPARTMENT - DIMENSION numberOfRequiredApprovals: type: integer description: >- Number of sequential approvals required for expense reports evaluated against this section. minimum: 1 maximum: 3 nullable: true sendToUnauthorizedApprovers: type: boolean description: >- Whether expense reports are sent to approvers who are not otherwise authorized on the section item. sortOrder: type: integer description: >- Zero-based position of the section within the organization's list of approval sections. minimum: 0 format: int32 customDimensionDefinition: type: object description: >- Custom dimension the section is bound to. Present only when type is DIMENSION. nullable: true required: - id properties: id: allOf: - $ref: '#/components/schemas/Uuid' description: Findity identifier of the custom dimension definition. name: type: string description: Human-readable name of the custom dimension definition. maxLength: 255 400Error: type: object properties: result: type: string code: type: string description: type: string 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}' Uuid: type: string pattern: ^[0-9a-fA-F]{32}$ description: UUID without dashes (32-character hex string) securitySchemes: bearerAuth: type: http scheme: bearer ````