Complexity

Learn how to query the complexity of an API call using the monday.com platform API

Query complexity defines the cost of each operation you make. Each API token is allotted a fixed complexity limit for a given period to help manage the load placed on the API.

Queries

You can use the complexity query to retrieve complexity data via the API.

  • Returns a JSON object containing the complexity cost of your queries
  • Can be included in any API request to return the cost of that specific query or mutation.
query {
  complexity {
    before
    query
    after
    reset_in_x_seconds
  }
  boards (ids: 1234567890) {
    items {
      id
      name
    }
  }
}
mutation {
  complexity {
    query
    before
    after
  }
  create_item(board_id:1234567890, item_name:"test item") {
    id
  }
}

Fields

You can use the following fields to specify what information your complexity query will return.

FieldDescription
after Int!The remaining complexity after the query's execution.
before Int!The remaining complexity before the query's execution.
query Int!This specific query's complexity.
reset_in_x_seconds Int!The length of time (in seconds) before the complexity budget resets.