Home
Content Delivery API
OverviewAPI EndpointsAuthenticationQuery ExplorerRate limitingComplexityYour first requestHow to fetch recordsPaginationFiltering recordsOrdering recordsLocalizationModular content fieldsTree-like collectionsImages and videosSEO and faviconMeta fields
    In this page
    Complexity

    Each query hitting our Content Delivery API has a complexity score based on which type of field and how many fields are present in it.

    Model root queries

    Root fields related to your models have a complexity score of 80.

    query {
      allArtists { # 80
        id
        name
      }
    }

    Also root fields like _allArtistsMeta and artist have a complexity score of 80 too.

    The following query has a complexity score of 162.

    query {
      _allArtistsMeta { # 80
        count # 1
      }
      artist(filter: {id: {eq: "10"}}) { # 80
        name # 1
      }
    }

    Model fields

    Each model subfield has a complexity of 1, apart from file, gallery, link, links and modular content fields which have a complexity of 10.

    The following query has a complexity score of 91.

    query {
      allArtists { # 80
        photo { # 10 (file field)
        	url # 1
        }
      }

    Upload root fields

    Root fields about uploads, _allUploadsMeta and upload, have a complexity score of 25 both.

    The following query has a complexity score of 52.

    query {  
      _allUploadsMeta { # 25
        count # 1
      }
      upload(filter: {id: {eq: "564"}}) { # 25
        url # 1
      }
    }

    Single instance models

    Root fields about single-instance records have a complexity score of 25.

    The following query has a complexity score of 27.

    query {  
      contactPage { # 25
        phoneNumber # 1
        emailAddress # 1
      }
    }

    Site query

    Root field _site has a complexity score of 10.

    The following query has a complexity score of 13.

    query {
      _site { # 10
        globalSeo { # 1
          siteName # 1
          titleSuffix # 1
        }
      }
    }

    Maximum complexity score

    The Content Delivery API sets the x-complexity header in the response to let you know the calculated complexity score for your submitted query.

    If the query complexity score is over 1200, you'll get an error from the Content Delivery API:

    {
      "errors": [
        {
          "message": "Query has complexity of 1276, which exceeds max complexity of 1200"
        }
      ]
    }

    Higher complexity score limit may apply to your project. Take a look at the "Plan and usage" section of your project in the Account dashboard.

    Questions?
    We're always happy to help with code or other questions you might have. Search our documentation, forum, contact support, or connect with our sales team. You can chat live with other developers in our Slack channel.