---
updatedAt: 2026-07-06T17:34:06.000Z
agentTools:
  projectIndex: https://developers.yoodli.ai/llms.txt
---

# Update settings of an Organization in a Multi Org

Updates seat allocation of an Organization within a Multi Org.

Rate limit category: Medium API

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Yoodli API spec",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://app.yoodli.ai/api",
      "description": "Official API server"
    },
    {
      "url": "http://localhost:3001/api",
      "description": "(Yoodli internal use only) local server"
    }
  ],
  "tags": [
    {
      "name": "Multi Org Management",
      "x-tag-expanded": false,
      "description": "Operations on Multi Org feature."
    }
  ],
  "paths": {
    "/v3/enterprises/{enterpriseId}/orgs/{orgId}": {
      "patch": {
        "summary": "Update settings of an Organization in a Multi Org",
        "tags": [
          "Multi Org Management"
        ],
        "description": "Updates seat allocation of an Organization within a Multi Org.\n\nRate limit category: Medium API",
        "parameters": [
          {
            "name": "enterpriseId",
            "in": "path",
            "required": true,
            "description": "Multi Org ID.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "orgId",
            "in": "path",
            "required": true,
            "description": "Organization ID.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEnterpriseOrgRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Organization updated successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UpdateEnterpriseOrgResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body or seat allocation exceeds Multi Org limit.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Permission denied or Organization does not belong to this Multi Org.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Multi Org or Organization not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "Seat allocation is less than current usage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    },
    "schemas": {
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "description": "Error message. This is for developers, and not for end users or translated."
          },
          "code": {
            "type": "string",
            "description": "Error code.\n Some API provide this field to identify a known mode of failure.\n The user is Frontend is recommended to translate this error code into a user friendly error message."
          }
        },
        "required": [
          "error"
        ]
      },
      "UpdateEnterpriseOrgRequest": {
        "type": "object",
        "properties": {
          "seats_allocated": {
            "examples": [
              50
            ],
            "type": "number",
            "description": "New number of seats to allocate to the Organization from the Multi Org seat pool.\n Must be a non-negative integer and cannot be less than the current seat usage."
          }
        }
      },
      "UpdateEnterpriseOrgResponse": {
        "type": "object",
        "properties": {
          "success": {
            "examples": [
              true
            ],
            "type": "boolean",
            "description": "Whether the operation completed successfully."
          }
        },
        "required": [
          "success"
        ]
      }
    }
  }
}
```