Skip to main content

System Brand Settings

1 API call in this section.

Update Brand Settings

System Configuration / System Brand Settings
PUT/system-brand-settings/:id?language=en

Update system brand settings. Requires system admin access. All fields are optional but must match their expected data types. Headers: - Authorization: Bearer token for authentication (required) - Content-Type: application/json (required) - X-API-Key: Alternative authentication method using API key Path Parameters: - id: ID of the system brand settings to update Query Parameters: - language (optional): Language code for localized response messages (e.g., 'en') Request Body Fields (all optional): - brand_name: JSONB object with language keys - assets: JSONB object for brand assets - colors: JSONB object for brand colors - configurations: JSONB object for brand configurations - landing_page: JSONB object for landing page visibility, hero, docs, quick access, modules, and auth images - is_active: Boolean value to enable/disable the brand settings - default_preset_id: String value for the default preset ID Validation Rules: - brand_name must be a JSONB object - assets must be a JSONB object - colors must be a JSONB object - configurations must be a JSONB object - landing_page must be a JSONB object - is_active must be a boolean - default_preset_id must be a string

Send a bearer token in the Authorization header for an authenticated OnDi user session.
Request
curl
1curl --request PUT "$ONDI_BASE_URL/system-brand-settings/:id?language=en" \2  --header "Authorization: Bearer {{access_token}}" \3  --header "Content-Type: application/json" \4  --header "Content-Type: application/json" \5  --data '{6  "brand_name": {7    "en": "Ondi",8    "ar": "",9    "ku": ""10  },11  "landing_page": {12    "book_demo_link": {13      "visible": true14    },15    "hero": {16      "title": "Ondi",17      "subtitle": "Right on the distribution",18      "description": "Manage e-commerce, restaurant operations, delivery logistics, and more all from a single unified platform.",19      "image": ""20    },21    "documentation": {22      "visible": true,23      "platform": {24        "visible": true,25        "url": "https://docs.ondi.io"26      },27      "api": {28        "visible": true,29        "url": "https://api-docs.ondi.io"30      }31    },32    "quick_access": {33      "visible": true,34      "items": [35        {36          "id": "store-front",37          "visible": true,38          "title": "Store Front",39          "description": "Customer-facing e-commerce storefront",40          "image": "",41          "link_text": "store.ondi.io",42          "link_url": "https://store.ondi.io"43        }44      ]45    },46    "modules": {47      "visible": true,48      "items": [49        {50          "id": "store-front",51          "visible": true,52          "title": "Store front (E-Commerce)",53          "description": "Complete online store solution with product management, inventory, and checkout."54        }55      ]56    },57    "auth_images": {58      "login": "",59      "forgot_password": ""60    }61  },62  "configurations": {63    "theme": "dark"64  },65  "is_active": true,66  "default_preset_id": "preset-123"67}'
Request body
json
1{2  "brand_name": {3    "en": "Ondi",4    "ar": "",5    "ku": ""6  },7  "landing_page": {8    "book_demo_link": {9      "visible": true10    },11    "hero": {12      "title": "Ondi",13      "subtitle": "Right on the distribution",14      "description": "Manage e-commerce, restaurant operations, delivery logistics, and more all from a single unified platform.",15      "image": ""16    },17    "documentation": {18      "visible": true,19      "platform": {20        "visible": true,21        "url": "https://docs.ondi.io"22      },23      "api": {24        "visible": true,25        "url": "https://api-docs.ondi.io"26      }27    },28    "quick_access": {29      "visible": true,30      "items": [31        {32          "id": "store-front",33          "visible": true,34          "title": "Store Front",35          "description": "Customer-facing e-commerce storefront",36          "image": "",37          "link_text": "store.ondi.io",38          "link_url": "https://store.ondi.io"39        }40      ]41    },42    "modules": {43      "visible": true,44      "items": [45        {46          "id": "store-front",47          "visible": true,48          "title": "Store front (E-Commerce)",49          "description": "Complete online store solution with product management, inventory, and checkout."50        }51      ]52    },53    "auth_images": {54      "login": "",55      "forgot_password": ""56    }57  },58  "configurations": {59    "theme": "dark"60  },61  "is_active": true,62  "default_preset_id": "preset-123"63}

Path parameters

idRequired
path string

ID of the system brand settings to update

Query parameters

languageOptional
query string

en

Language code for response localization (Optional, default: en)

Request body fields

brand_nameExample
object

Example field from the request body.

brand_name.enExample
string

Example field from the request body.

brand_name.arExample
string

Example field from the request body.

brand_name.kuExample
string

Example field from the request body.

landing_pageExample
object

Example field from the request body.

landing_page.book_demo_linkExample
object

Example field from the request body.

landing_page.book_demo_link.visibleExample
boolean

Example field from the request body.

landing_page.heroExample
object

Example field from the request body.

landing_page.hero.titleExample
string

Example field from the request body.

landing_page.hero.subtitleExample
string

Example field from the request body.

landing_page.hero.descriptionExample
string

Example field from the request body.

landing_page.hero.imageExample
string

Example field from the request body.

landing_page.documentationExample
object

Example field from the request body.

landing_page.documentation.visibleExample
boolean

Example field from the request body.

landing_page.documentation.platformExample
object

Example field from the request body.

landing_page.documentation.apiExample
object

Example field from the request body.

landing_page.quick_accessExample
object

Example field from the request body.

landing_page.quick_access.visibleExample
boolean

Example field from the request body.

landing_page.quick_access.itemsExample
array<object>

Example field from the request body.

landing_page.modulesExample
object

Example field from the request body.

landing_page.modules.visibleExample
boolean

Example field from the request body.

landing_page.modules.itemsExample
array<object>

Example field from the request body.

landing_page.auth_imagesExample
object

Example field from the request body.

landing_page.auth_images.loginExample
string

Example field from the request body.

landing_page.auth_images.forgot_passwordExample
string

Example field from the request body.

configurationsExample
object

Example field from the request body.

configurations.themeExample
string

Example field from the request body.

is_activeExample
boolean

Example field from the request body.

default_preset_idExample
string

Example field from the request body.

Headers

AuthorizationOptional
header string

Bearer {{access_token}}

Content-TypeOptional
header string

application/json

Responses

Success Response200OK
Response body
json
1{2  "success": true,3  "message": "System brand settings updated successfully",4  "systemBrandSettings": {5    "id": "1",6    "brand_name": {7      "en": "Ondi",8      "ar": "",9      "ku": ""10    },11    "assets": {12      "logo": "new-logo-url",13      "favicon": "new-favicon-url"14    },15    "colors": {16      "primary": "#111111",17      "secondary": "#222222"18    },19    "configurations": {20      "theme": "dark"21    },22    "landing_page": {23      "book_demo_link": {24        "visible": true25      },26      "hero": {27        "title": "Ondi",28        "subtitle": "Right on the distribution",29        "description": "Manage e-commerce, restaurant operations, delivery logistics, and more all from a single unified platform.",30        "image": ""31      },32      "documentation": {33        "visible": true,34        "platform": {35          "visible": true,36          "url": "https://docs.ondi.io"37        },38        "api": {39          "visible": true,40          "url": "https://api-docs.ondi.io"41        }42      },43      "quick_access": {44        "visible": true,45        "items": [46          {47            "id": "store-front",48            "visible": true,49            "title": "Store Front",50            "description": "Customer-facing e-commerce storefront",51            "image": "",52            "link_text": "store.ondi.io",53            "link_url": "https://store.ondi.io"54          }55        ]56      },57      "modules": {58        "visible": true,59        "items": [60          {61            "id": "store-front",62            "visible": true,63            "title": "Store front (E-Commerce)",64            "description": "Complete online store solution with product management, inventory, and checkout."65          }66        ]67      },68      "auth_images": {69        "login": "",70        "forgot_password": ""71      }72    },73    "is_active": true,74    "default_preset_id": "preset-123",75    "created_at": "2023-01-01T00:00:00Z",76    "updated_at": "2023-06-15T12:30:45Z",77    "updated_by": "user-id-123"78  }79}
Error - Unauthorized401Unauthorized
Response body
json
1{2  "success": false,3  "message": "Unauthorized"4}
Error - Internal Server Error500Internal Server Error
Response body
json
1{2  "success": false,3  "message": "Internal server error"4}
Success (200 OK)200
Response body
json
1{2  "success": true,3  "message": "System brand settings updated successfully",4  "systemBrandSettings": {5    "id": "1",6    "brand_name": {7      "en": "Ondi",8      "ar": "",9      "ku": ""10    },11    "landing_page": {12      "book_demo_link": {13        "visible": true14      },15      "hero": {16        "title": "Ondi",17        "subtitle": "Right on the distribution",18        "description": "Manage e-commerce, restaurant operations, delivery logistics, and more all from a single unified platform.",19        "image": ""20      }21    },22    "is_active": true,23    "default_preset_id": "preset-123"24  }25}
Error (400 Bad Request)400
Response body
json
1{2  "success": false,3  "message": "landing_page must be a JSONB object"4}
Error (403 Forbidden)403
Response body
json
1{2  "success": false,3  "message": "Insufficient permissions"4}
Error (404 Not Found)404
Response body
json
1{2  "success": false,3  "message": "Invalid route"4}