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