Errors

Picsart uses conventional HTTP response codes to indicate the success or failure of an API request.

Error Code	Message	Description
200	Success	Congratulations, your call was successful.
400	Bad request	The server could not understand the request due to invalid syntax or input parameters that did not meet the requirements.
401	Unauthorized	Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response. Check if the APIKEY is provided in either the request header or in the query string.
403	Forbidden	The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401, the client's identity is known to the server.
404	Not Found	Not found. Verify that the request URL is spelled correctly and that the API you are trying to access exists. For example, ensure that you are not trying to access the wrong revision of an API.
405	Method Not Allowed	Method not allowed. You specified a method that is not supported. For example, you used the GET verb for an API call that requires the POST verb.
413	Request Entity Too Large	Request Entity Too Large.
415	Unsupported Media Type	The media format of the requested data is not supported by the server, so the server is rejecting the request. Typically, this error occurs on POST or PUT requests when the Content-type HTTP header is set to the wrong value. For example, an HTTP 415 error is returned if you POST the following to an API that only supports JSON: $ curl https://api.picsart.io/tools/demo/upscale -X POST -H "Content-type:text/xml" -d '' For GET requests, use the Accept header instead of the Content-type header.
429	Too Many Request	The rate limit was exceeded on Quota.
431	Request Header Fields Too Large	Request Header Fields Too Large.
500	Internal Server Error	The server encountered an unexpected condition that prevented it from fulfilling the request. If the error persists, please, check the service status at status.picsart.io.
503	Service Unavailable	The service is temporarily unavailable. Please, check the current status at status.picsart.io.

For high error rates, you can check the service status at status.picsart.io. There you can subscribe for updates, including upcoming maintenance. In case you don’t see the problem escalated on the Status page, please contact us with a Request type of ‘Troubleshooting’ or send a direct email to [email protected]. We will make sure to follow up as soon as possible.