Skip to main content

Star Rating - Set Widget Logo

Endpoint

/i/feedback/logo

Overview

Uploads a logo file and returns generated logo filename for widget configuration.

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions

Requires star_rating Create permission.

Request Parameters

ParameterTypeRequiredDescription
api_keyStringConditionalRequired if auth_token is not provided.
auth_tokenStringConditionalRequired if api_key is not provided.
identifierStringYesFile identifier used as output filename prefix.
logoFileNoImage file; if omitted, upload helper still returns success branch.

Examples

/i/feedback/logo?
api_key=YOUR_API_KEY&
identifier=widget_logo_1

Multipart form body:

logo=@/path/to/logo.png

Response

Success Response

{
"result": "widget_logo_1.png"
}

Response Fields

FieldTypeDescription
resultStringStored filename (identifier.ext) when upload succeeds.

Error Responses

  • 400
{
"result": "Invalid image format. Must be png or jpeg"
}
  • 400
{
"result": "Invalid file extension. Must be .png, .jpg, .gif or .jpeg"
}
  • 400
{
"result": "Failed to upload image"
}

Standard authentication/authorization errors from create validation can also be returned.

Behavior

  • Uses shared file-upload helper with same validation rules as upload endpoint.
  • Returns result as plain filename string through wrapped result response.
Implementation details

Database Collections

This endpoint does not read or write MongoDB collections directly.