# Update an organization (/docs/api-reference/organizations/OrganizationsController_update)

`PATCH /api/organizations/{orgId}`

Base URL: https://api.xentr.ai

Authentication: bearer token (`Authorization: Bearer <token>`).

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | yes | string | Organization ID |

## Request body

Required.

Content type: `application/json`

```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Organization name"
    },
    "slug": {
      "type": "string",
      "description": "URL-friendly slug"
    },
    "tier": {
      "type": "string",
      "description": "Subscription tier",
      "enum": [
        "basic",
        "iot",
        "ai"
      ]
    },
    "timezone": {
      "type": "string",
      "description": "Timezone"
    },
    "locale": {
      "type": "string",
      "description": "Locale"
    },
    "oeeTarget": {
      "type": "object",
      "description": "OEE target percentage"
    },
    "address": {
      "type": "string",
      "description": "Physical address"
    },
    "mapPin": {
      "nullable": true,
      "description": "Verified map coordinates; null removes the saved pin.",
      "type": "object",
      "allOf": [
        {
          "type": "object",
          "properties": {
            "latitude": {
              "type": "number",
              "minimum": -90,
              "maximum": 90
            },
            "longitude": {
              "type": "number",
              "minimum": -180,
              "maximum": 180
            }
          },
          "required": [
            "latitude",
            "longitude"
          ]
        }
      ]
    },
    "phone": {
      "type": "string",
      "description": "Phone number"
    },
    "email": {
      "type": "string",
      "description": "Contact email"
    },
    "logoUrl": {
      "type": "string",
      "description": "Logo URL"
    }
  }
}
```

## Responses

### 200: Organization updated

### 404: Organization not found