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.
| Field | Description | 
|---|---|
| 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. | 
