Common Errors
Client Errors
invalid_image
The image you provided is not a valid skin image. The error message should contain more details about what is wrong with the image.
Solution
Make sure the image is a valid skin and try again.
Images should be:
- PNG format
- 64x64 or 64x32 pixels
- between 1KB and 20KB in size
invalid_image_url
The URL you provided does not point to a valid image. The error message should contain more details about what is wrong with the URL.
This commonly happens if you use a URL that points to a webpage instead of an image file (e.g. https://imgur.com/k8W9wJ0 instead of https://i.imgur.com/k8W9wJ0.png).
Solution
Make sure the URL points to a valid image and try again.
invalid_user
The user you provided does not exist or is not valid.
Solution
Provide a valid Minecraft UUID of a player and try again.
rate_limit (429)
You have exceeded the rate limit for this endpoint. The error message should contain more information about the rate limit and when you can make another request.
Check the X-RateLimit-Limit
, X-RateLimit-Remaining
, and Retry-After
headers, as well as the rateLimit
object in the response for more information.
Solution
Wait until the rate limit resets and try again later.
invalid_content_type (415)
The content type of the request is not supported. The error message should contain more information about what is wrong with the content type.
Solution
Make sure the request has the correct content type (application/json
or multipart/form-data
) and try again.
If you are using a library to make the request with multipart/form-data
, make sure it sets the correct content type and boundary (usually you should avoid setting the content-type header manually).
missing_file
No skin file was provided in the request.
Solution
Make sure to include a skin file in the request and try again.
The file should be sent as a file
field in a multipart/form-data
request. See invalid_content_type above for potential issues with the content type.
invalid_api_key
The API key you provided is not valid. The error message should contain more information about what is wrong with the API key.
Client not allowed
: You configured your API to only allow requests from specific IPs, but the request did not come from one of those IPs.Origin not allowed
: You configured your API to only allow requests from specific web origins, but the request did not come from one of those origins.Agent not allowed
: You configured your API to only allow requests from specific user agents, but the request did not come from one of those user agents.
Solution
Make sure to provide a valid API key in the Authorization
header and try again.
validation_error
The request contains invalid or missing parameters. The error message should contain more information about what is wrong with the request.
Solution
Refer to the API Reference and make sure the request parameters are correct.
Server Errors
skin_change_failed
Something went wrong trying to upload the skin to Mojang. The error message may contain more information about what went wrong.
This can happen if the skin file is invalid or there are issues with the Mojang servers.
This also happens if the skin image is banned by Mojang.
Solution
Try again later or with a different skin image.
invalid_skin_data
The skin was successfully uploaded to Mojang, but something went wrong while downloading the texture data. The error message may contain more information about what went wrong.
Solution
Try again later.
generator_timeout
The skin generation process took too long and was canceled.
Solution
Try again later.
job_failed
The skin generation process failed. The error message may contain more information about what went wrong.
Solution
Try again later.
no_account_available
There are currently no accounts available to generate skins. This can happen if all accounts are currently in use or if there are issues with the account pool.
(This error should not happen normally)
Solution
Try again later.
internal_error
An internal server error occurred. The error message may contain more information about what went wrong.
This should not happen normally and indicates an issue with the MineSkin servers. Please report this error on the MineSkin Discord or on GitHub.
Solution
Try again later.
unexpected_error
See internal_error.