How to upload and retrieve your organisation’s branding logo
Organisation branding allows you to customise the visual appearance of your verification workflows with your own logo. The logo is applied at the organisation level and is visible to all members of your team.
Logo upload is managed through the Veridox dashboard — it is not available via the API. Only organisation owners can upload or change the logo.To upload your logo:
{ "error_code": "request.not-found", "error_message": "The resource '/organisations/branding-logo' does not exist.", "error_details": { "path": "/organisations/branding-logo" }}
// Handle different API key error scenariosasync function handleBrandingRequest(apiKey) { try { const response = await fetch('/api/organisation/branding', { headers: { 'X-API-Key': apiKey } }); if (!response.ok) { const error = await response.json(); switch (error.error_code) { case 'request.authentication.api-key.invalid': throw new Error('Invalid API key. Please check your key format.'); case 'request.authentication.api-key.expired': throw new Error('API key has expired. Please generate a new key.'); case 'request.authentication.api-key.membership-invalid': throw new Error('API key is no longer valid. Please contact your administrator.'); case 'request.not-found': // No logo uploaded - this is expected return null; default: throw new Error(error.error_message || 'Unknown error occurred'); } } return await response.json(); } catch (error) { console.error('Branding API error:', error); throw error; }}