# Update site settings

**Publié le** : 2026-05-08
**Catégorie** : Settings & Config

## `PUT /site/settings`

**Update site settings**

Updates site settings. Only include the fields you want to change.

Required permissions: `sites.update`

### Request Body

Content-Type: `application/json`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | No | Display name. 1-255 characters |
| `domain` | string | No | 1-255 characters |
| `description` | string \| null | No | Description text |
| `logoUrl` | string \| null | No | Site logo URL |
| `faviconUrl` | string \| null | No | Site favicon URL |
| `timezone` | string | No | Max 100 characters |
| `isActive` | boolean | No | Boolean |
| `showBranding` | boolean | No | Boolean |
| `previewUrl` | string \| null | No | Frontend preview URL |


### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Unauthorized — invalid or missing API token |
| `403` | Forbidden — insufficient permissions |
| `422` | Validation error |


### Examples

```bash
curl -X PUT https://api.lynkow.com/v1/site/settings \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Updated Website",
    "timezone": "America/New_York",
    "previewUrl": "https://staging.example.com"
  }'
```

### Response Example

```json
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "My Updated Website",
  "domain": "www.example.com",
  "slug": "my-website",
  "description": "Company website and blog",
  "logoUrl": "https://cdn.lynkow.com/sites/abc123/logo.png",
  "faviconUrl": "https://cdn.lynkow.com/sites/abc123/favicon.ico",
  "timezone": "America/New_York",
  "isActive": true,
  "showBranding": false,
  "previewUrl": "https://staging.example.com",
  "organizationId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "createdAt": "2025-01-01T00:00:00.000Z",
  "updatedAt": "2025-04-06T11:00:00.000Z"
}
```

---