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​

Countly API supports three authentication methods:

  1. api_key=YOUR_API_KEY
  2. auth_token=YOUR_AUTH_TOKEN
  3. countly-token: YOUR_AUTH_TOKEN

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.

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/Processing​

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

Database Collections​

This endpoint does not read or write MongoDB collections directly.

Examples​

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

Multipart form body:

logo=@/path/to/logo.png

Last Updated​

2026-03-07