dotCMS logodotCMS logo
OverviewAuthorBuildManageReference
dotCMS Github RepodotCMS Github RepodotCMS Discourse CommunityChat With Us
Overview
ReleasesIntroductionGuides and Tutorials
No Overview side nav found for /docs/error-codes-rest-api.

dotCMS

Universal content management, made simple.

GitHubTwitterLinkedIndotCMS Discourse Community
dotDev HomeBlogChangelogsCurrent releasesAboutContactPrivacy PolicyTrust Center

© 2026 dotCMS. All rights reserved.

    Assistant

    Responses are generated using AI and may contain mistakes.

    Hi, I'm an AI assistant with access to documentation and other content.

    Tip: You can toggle this pane with ⌘/ or ⌘K.

    Try asking

    Enter to send · Shift+Enter for newline

    Error Codes: REST API

    When troubleshooting failed REST API calls, error codes can be helpful in diagnosing the cause for the failure. There are many cases where a missing role permission on a host, folder, or content type, may cause an intentional restriction error. Here is a list of the types of codes returned after a REST API calls to help determine if the call was successful and, if not, what type of permission failure exists:

    ###401 Error Code: (Unauthorized)###
    A user has not logged in and attempts to access a restricted REST service

    ###403 Error Code (Forbidden)###
    When the user has logged in, and attempts to access a restricted REST service over which the user has no permission

    ###200 Code (OK)###
    When the user has logged in and attempts to access a restricted REST service, over which the user does have permission, and the call executes successfully

    ###500 Error Code (Internal Service Error)###
    When the user has logged in, and attempts to access a restricted REST service over which the user does have permission, but there is an error processing the request