System Brand Settings
1 API call in this section.
Update Brand Settings
/system-brand-settings/:id?language=enUpdate 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
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}'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
idRequiredID of the system brand settings to update
Query parameters
languageOptionalen
Language code for response localization (Optional, default: en)
Request body fields
brand_nameExampleExample field from the request body.
brand_name.enExampleExample field from the request body.
brand_name.arExampleExample field from the request body.
brand_name.kuExampleExample field from the request body.
landing_pageExampleExample field from the request body.
landing_page.book_demo_linkExampleExample field from the request body.
landing_page.book_demo_link.visibleExampleExample field from the request body.
landing_page.heroExampleExample field from the request body.
landing_page.hero.titleExampleExample field from the request body.
landing_page.hero.subtitleExampleExample field from the request body.
landing_page.hero.descriptionExampleExample field from the request body.
landing_page.hero.imageExampleExample field from the request body.
landing_page.documentationExampleExample field from the request body.
landing_page.documentation.visibleExampleExample field from the request body.
landing_page.documentation.platformExampleExample field from the request body.
landing_page.documentation.apiExampleExample field from the request body.
landing_page.quick_accessExampleExample field from the request body.
landing_page.quick_access.visibleExampleExample field from the request body.
landing_page.quick_access.itemsExampleExample field from the request body.
landing_page.modulesExampleExample field from the request body.
landing_page.modules.visibleExampleExample field from the request body.
landing_page.modules.itemsExampleExample field from the request body.
landing_page.auth_imagesExampleExample field from the request body.
landing_page.auth_images.loginExampleExample field from the request body.
landing_page.auth_images.forgot_passwordExampleExample field from the request body.
configurationsExampleExample field from the request body.
configurations.themeExampleExample field from the request body.
is_activeExampleExample field from the request body.
default_preset_idExampleExample field from the request body.
Headers
AuthorizationOptionalBearer {{access_token}}
Content-TypeOptionalapplication/json
Responses
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}1{2 "success": false,3 "message": "Unauthorized"4}1{2 "success": false,3 "message": "Internal server error"4}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}1{2 "success": false,3 "message": "landing_page must be a JSONB object"4}1{2 "success": false,3 "message": "Insufficient permissions"4}1{2 "success": false,3 "message": "Invalid route"4}