# update_org_settings (/docs/reference/mcp-tools/update_org_settings)



{/* Generated by apps/docs/scripts/generate-mcp-pages.mjs — do not edit by hand. */}

Update organization settings (Owner/Admin).

|                     |                        |
| ------------------- | ---------------------- |
| Required permission | `org:settings:write`   |
| Capability ID       | `orgs.settings.update` |
| Destructive         | No                     |

## Parameters [#parameters]

| Parameter           | Type                 | Required | Notes |
| ------------------- | -------------------- | -------- | ----- |
| `timezone`          | string               | no       |       |
| `locale`            | string               | no       |       |
| `weekStart`         | `SUNDAY` \| `MONDAY` | no       |       |
| `workingDays`       | array of integer     | no       |       |
| `workingHours`      | object               | no       |       |
| `logoUrl`           | string \| null       | no       |       |
| `allowPublicSignup` | boolean              | no       |       |

## Input schema (JSON Schema) [#input-schema-json-schema]

```json
{
  "type": "object",
  "properties": {
    "timezone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "locale": {
      "type": "string",
      "minLength": 2,
      "maxLength": 35
    },
    "weekStart": {
      "type": "string",
      "enum": [
        "SUNDAY",
        "MONDAY"
      ]
    },
    "workingDays": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 6
      }
    },
    "workingHours": {
      "type": "object",
      "properties": {
        "start": {
          "type": "string"
        },
        "end": {
          "type": "string"
        }
      },
      "required": [
        "start",
        "end"
      ],
      "additionalProperties": false
    },
    "logoUrl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "allowPublicSignup": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}
```

## Access control [#access-control]

A call succeeds only when the personal access token's scopes **and** the holder's role both allow `org:settings:write` (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.
