support Contact Support | system status System Status
Page Contents

    SSAI API Error Reference

    This topic provides an error reference for the SSAI API.

    General error messages

    Status Name Message Cause
    400 BAD_REQUEST Invalid JSON body on request There's an error in JSON for the request body; could be a basic JSON issue, or an incorrect type for a field value
    400 BAD_REQUEST "error": "{fieldname} field is required Request body is missing the indicated required field
    400 AD_CONFIG_NOT_FOUND Ad config not found Ad configuration specified in an SSAI request was not found
    400 AD_CONFIG_INACTIVE Ad config is inactive Ad configuration specified in an SSAI request is inactive
    401 UNAUTHORIZED Permission denied. Missing or invalid OAuth access token. If you did supply an access token, it may not have for the appropriate scope for this request
    403 NOT_AVAILABLE Resource is not available. The resource you are requesting is temporarily unavailable - this may be a temporary condition while some kind of processing of the video is in progress, but if the message persists, contact Support.
    404 NOT_FOUND Resource does not exist. You requested a resource that does not exist - you might be trying to update an ad configuration or get an ad trace on a session that no longer exists. This error will also be returned if you use and HTTP method not allowed on the endpoint.
    500 UNKNOWN an unknown internal error occurred Issue in Brightcove system - try again later.
    503 SERVICE_UNAVAILABLE The API is temporarily unavailable Backend issue - try again later.
    504 TIMEOUT something took too long Server likely too busy - try again later.

    Page last updated on 28 Sep 2020