Method return values

All REST API methods return a standard HTTP status code, both in the HTTP header and in the JSON response payload if present.  Generally, when a method results in the successful creation of a URI-addressable object, such as a media ID, a status code of CREATED is returned.  In general, when an asynchronous request is accepted for processing, but not yet completed, ACCEPTED status is returned.  In such cases, applications that require a final status for the requested operation must poll the API to retrieve it.

All API methods may return INTERNAL_SERVER_ERROR(500) status.  All API methods may return BAD_REQUEST(400) to indicate some problem with the supplied request parameters.

In all cases, it is safe to interpret 2xx status codes as "success" and any others as "failure".