Errors

The Degreed API uses the following error codes:

Error Code	Meaning
400	Bad Request. Your request is invalid. There are several reasons why this can be the case. The error response provides further information about the specific reason why the request cannot be honored.
401	Unauthorized. Your API key is invalid.
403	Forbidden. You don't have the right to visit this resource. This may be because the owner of the record may have marked it private. This error displays when posting the client authentication request and the client credentials or scopes are incorrect. Commonly, you have attempted to assign scopes to an access_token that its API key does not possess. Please verify the client credentials and scopes.
404	Not Found. The resource could not be found.
405	Method Not Allowed. You tried to access a resource with an invalid method.
406	Not Acceptable. The format is not valid. We only accept JSON.
409	Resource conflict. You cannot use the same ExternalID or URL to identify multiple resources. Check to make sure you don't have a user, content, etc., with the same URL or ExternalID.
410	Gone. The resource requested has been removed from our servers.
429	Too Many Requests. You have submitted too many requests. Degreed limits the number of calls a single API client can make to 70 requests per minute (rpm). If you exceed the limit, this response is returned. See Rate Limiting for more information.
500	Internal Server Error. We had a problem with our server. Try again later.
503	Service Unavailable. Possibilities include that: (a) We're temporarily offline for maintenance. (b) Our service is currently experiencing a very high volume of demand. You can write your application to retry the attempt 30-120 seconds later and likely resolve the problem.