> ## Documentation Index
> Fetch the complete documentation index at: https://www.edenai.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update the organization's settings

> Changes the organization's name, role-based access control, default guardrail, zero data retention, allowed regions or SSO requirement. Only the fields you send are changed. Every change except the default guardrail is recorded in your audit log, as it is from the dashboard. The request is applied whole or not at all: an invalid field (400) changes nothing. Single sign-on itself and directory sync are set up from the dashboard. Requires the `manage:write` scope.



## OpenAPI

````yaml https://api.edenai.run/v2/info/splitted-schema/management_api/openapi.json patch /v3/manage/organization/
openapi: 3.0.3
info:
  title: Organization Management
  version: '2.0'
  description: Your project description
servers:
  - url: https://api.edenai.run
security: []
paths:
  /v3/manage/organization/:
    patch:
      tags:
        - Organization
      summary: Update the organization's settings
      description: >-
        Changes the organization's name, role-based access control, default
        guardrail, zero data retention, allowed regions or SSO requirement. Only
        the fields you send are changed. Every change except the default
        guardrail is recorded in your audit log, as it is from the dashboard.
        The request is applied whole or not at all: an invalid field (400)
        changes nothing. Single sign-on itself and directory sync are set up
        from the dashboard. Requires the `manage:write` scope.
      operationId: manage_organization_partial_update
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedManageOrganizationUpdateRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PatchedManageOrganizationUpdateRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/PatchedManageOrganizationUpdateRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManageOrganization'
          description: ''
      security:
        - ManagementKeyAuth: []
components:
  schemas:
    PatchedManageOrganizationUpdateRequest:
      type: object
      description: >-
        Settings to change; only the fields you send are changed.


        `name`: up to 200 characters, no line breaks or invisible characters.
        `rbac_enabled`: turning

        it on gives every member without a role the Member role; turning it off
        keeps the roles but

        stops enforcing them. `default_guardrail_id`: one of the organization's
        guardrails, or null for

        none. `zero_data_retention`: turning it on also turns request saving and
        the response cache off

        for every member. `allowed_regions`: `eu`, `us` and/or `ap`, empty for
        any. `sso_required`

        needs single sign-on to be set up first.
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 200
        zero_data_retention:
          type: boolean
        allowed_regions:
          type: array
          items:
            $ref: '#/components/schemas/AllowedRegionsEnum'
        rbac_enabled:
          type: boolean
        default_guardrail_id:
          type: integer
          nullable: true
        sso_required:
          type: boolean
    ManageOrganization:
      type: object
      description: >-
        The organization's settings.


        `rbac_enabled`: whether roles decide what members may do.
        `default_guardrail` applies to every

        member and key unless a closer guardrail (key, member, role) sets the
        same limit; it may be

        paused (`is_active: false`). `zero_data_retention`: Eden AI stores no
        request content and

        routes only to providers that retain none. `allowed_regions`: the
        regions requests may be

        processed in, empty for any. `sso_enabled` and `scim_enabled` say
        whether single sign-on and

        directory sync are set up (from the dashboard); `sso_required` refuses
        any other sign-in.

        `audit_logs_enabled` says whether changes are recorded in your audit
        log.
      properties:
        id:
          type: integer
        name:
          type: string
        rbac_enabled:
          type: boolean
        default_guardrail:
          allOf:
            - $ref: '#/components/schemas/DefaultGuardrail'
          nullable: true
          readOnly: true
        zero_data_retention:
          type: boolean
        allowed_regions:
          type: array
          items:
            $ref: '#/components/schemas/AllowedRegionsEnum'
        sso_enabled:
          type: boolean
          readOnly: true
        sso_required:
          type: boolean
        scim_enabled:
          type: boolean
        audit_logs_enabled:
          type: boolean
          readOnly: true
      required:
        - allowed_regions
        - audit_logs_enabled
        - default_guardrail
        - id
        - name
        - rbac_enabled
        - scim_enabled
        - sso_enabled
        - sso_required
        - zero_data_retention
    AllowedRegionsEnum:
      enum:
        - eu
        - us
        - ap
      type: string
      description: |-
        * `eu` - Europe
        * `us` - United States
        * `ap` - Asia-Pacific
    DefaultGuardrail:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        is_active:
          type: boolean
      required:
        - id
        - is_active
        - name
  securitySchemes:
    ManagementKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
      description: >-
        A management key (created from the organization dashboard or with `POST
        /v3/manage/auth-keys`), sent as `Authorization: Bearer
        <management_key>`. Inference API keys (`sk-eden...`) are not accepted on
        these endpoints.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.