Appearance
Upload Quiz Custom Logo
Upload a custom logo image for a specific quiz.
Overview
This endpoint allows you to upload a custom logo image for a quiz. The image will be stored and associated with the quiz for display purposes.
Method: POST
Endpoint:/api/v1/namespaces/:namespaceId/quizzes/:quizId/customLogo
Requires administrative authentication.
Request
Headers
http
x-api-key: {your_api_key} # Required
Content-Type: multipart/form-dataPath Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
namespaceId | string | ✅ | Namespace unique ID |
quizId | string | ✅ | Quiz unique ID |
Form Data
| Parameter | Type | Required | Description |
|---|---|---|---|
customLogo | file | ✅ | Image file (PNG, JPG, or JPEG only) |
Response
json
{
"quiz": {
"id": "sample-quiz",
"name": "sample-quiz",
"primaryColor": "#9b8163",
"cta": "https://sample.net",
"ctaTitle": "More info on sample.net",
"clientTerm": "clients",
"customHeader": "custom header",
"logoUrl": "https://storage.googleapis.com/your-project-here/sample-namespace/logo.png",
"tennantId": "sample-namespace-mmd4q",
"quizStatus": {}
}
}Error Responses
400 Bad Request– If the file is not a valid image format
json
{
"error": "Only png, jpg, and jpeg images are allowed"
}500 Internal Server Error– If the namespace does not exist
json
{
"error": "namespace does not exist"
}500 Internal Server Error– If the quiz does not exist
json
{
"error": "quiz does not exist"
}Authorization Requirements
This endpoint requires authentication with one of the following permissions:
- System administrator
- Namespace administrator