# Change the branding

`PUT /org/{orgId}/branding` · Rivier · workspace

Change the branding; fields left out stay as they are. Needs an admin (a person who is owner or admin, or an admin key).

- Scope: workspace:write
- Sdk: workspace.orgBranding.set
- Cli: branding set

## Parameters

- `orgId` (path, required), string

## Request body

`application/json`

```json
{
  "type": "object",
  "properties": {
    "displayName": {
      "type": "string",
      "maxLength": 200
    },
    "legalName": {
      "type": "string",
      "maxLength": 200
    },
    "address": {
      "type": "string",
      "maxLength": 1000
    },
    "country": {
      "type": "string",
      "maxLength": 2,
      "pattern": "^([A-Za-z]{2})?$"
    },
    "taxId": {
      "type": "string",
      "maxLength": 60
    },
    "registration": {
      "type": "string",
      "maxLength": 60
    },
    "bank": {
      "type": "string",
      "maxLength": 2000
    },
    "footer": {
      "type": "string",
      "maxLength": 1000
    },
    "accent": {
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "pattern": "^#[0-9a-fA-F]{6}$"
        }
      ]
    },
    "font": {
      "type": "string",
      "enum": [
        "system",
        "sans",
        "serif",
        "rounded",
        "mono"
      ]
    },
    "fromName": {
      "type": "string",
      "maxLength": 120
    },
    "replyTo": {
      "anyOf": [
        {
          "type": "string",
          "const": ""
        },
        {
          "type": "string",
          "format": "email",
          "maxLength": 254
        }
      ]
    },
    "language": {
      "type": "string",
      "pattern": "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
      "maxLength": 20
    },
    "removeLogo": {
      "type": "boolean"
    },
    "removeDarkLogo": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}
```

## Responses

- `200`: Success
- `400`: The request was malformed
- `401`: No valid credential
- `403`: The credential lacks the scope, origin or address
- `429`: Over the key's rate limit; see Retry-After

## Example

```sh
curl -X PUT 'https://api.rivier.ai/org/{orgId}/branding' \
  -H 'Authorization: Bearer $KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "displayName": "string",
  "legalName": "string",
  "address": "string",
  "country": "string",
  "taxId": "string",
  "registration": "string",
  "bank": "string",
  "footer": "string"
}'
```