All resources communicate error condition with standard HTTP status code. Below is an overview of all the supported codes, along with some suggestions that might help you fix things.
Our server is unable to understand the request. This is likely caused by a programming error on your side.
This means that we were not able to authenticate you based on the information provided in the request. Make sure you're sending a valid access_token.
If you're connecting using OAuth2, don't forget that tokens can expire. These will need to be refreshed. Not doing so can also result in getting a 401 error.
You don't have access to the requested resource.
The resource you requested is not found. Please double check the URL of your request.
Unsupported Media Type
You are probably not
Too Many Requests
Our API limits the rate at which you can perform certain actions.
Internal Server Error
Uh-oh. Something went wrong on our side. We're sorry. We keep track of these, and we'll try to fix it!
This means that we're having some trouble, and our servers are too busy to handle your request. You'll want to check for these and give your user a chance to retry the request. We keep track of these and try to make sure they don't happen.
This means the request is taking too long. However, it doesn't always mean that we didn't receive your request. We could still be chugging away on the changes you made, and this means that you may want to check before retrying.