Errors
This page describes the common HTTP response codes that applies to all Picsart APIs.
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.
Updated 2 months ago