Error format

Errors returned by the API have the following characteristics:

• HTTP status: Response will be 200 – OK for application-level errors. Other statuses will be returned for transport-layer errors, such as 500 - Internal server error, 429 - Too many requests or 400 - Bad request
• JSON response: Body will contain an errors array with further details about each error
• Partial data: Requests will return partial data, so the data object may also contain some information. For example, if you query 3 fields, you may get two back and one error.
• Retry-Afterheader : Errors will include the Retry-After header to indicate how long you need to wait before making another request

Sample format

Here’s an example of an application-level error:

$
  {
>
    "data" : [],
>
    "errors": [
>
      {
>
        "message": "User unauthorized to perform action",
>
        "locations": [
>
          {
>
            "line": 2,
>
            "column": 3
>
          }
>
        ],
>
        "path": [
>
          "me"
>
        ],
>
        "extensions": {
>
          "code": "UserUnauthorizedException",
>
          "error_data": {},
>
          "status_code": 403
>
        }
>
      }
>
    ],
>
    "account_id": 123456
>
  }

$
{
>
  "data": {
>
    "me": {
>
      "id": "4012689",
>
      "photo_thumb": null
>
    },
>
    "complexity": {
>
      "query": 12
>
    }
>
  },
>
  "errors": [
>
    {
>
      "message": "Photo unavailable.",
>
      "locations": [
>
        {
>
          "line": 4,
>
          "column": 5
>
        }
>
      ],
>
      "path": [
>
        "me",
>
        "photo_thumb"
>
       ],
>
      "extensions": {
>
        "code": "ASSET_UNAVAILABLE"
>
      }
>
    }
>
  ],
>
  "account_id": 18888528
>
}

Errors by status code

2xx errors

Errors with a 2xx status code indicate that monday.com is not accepting the requested action due to a platform platform restriction, limitation, or rule. These errors occur for various reasons, including passing invalid values, missing permissions, or reaching character limits.

Here are some of the most common errors:

4xx client errors

Errors with a 4xx status code indicate that something went wrong on the client’s (your) side. These errors occur for various reasons, including not having access to the requested information, using the API at too high a volume, or providing incorrect input.

Here are some of the most common errors:

• A user or team has subscribed to more than 10,000 boards | * Learn how to optimize board subscribers* Unsubscribe from, delete, or archive irrelevant boards | | Resource is currently locked, please try again later | 423 | The board is temporarily locked because another process is performing a concurrent update (e.g., column update, automation). During this time, write operations are blocked to ensure data consistency. | * Retry the request after a short delay* Avoid concurrent updates to the same board from multiple sources | | maxConcurrencyExceeded | 429 | You exceeded the maximum number of queries allowed at once | * Reduce the number of queries sent at once* Use a retry mechanism in your code | | Rate Limit Exceeded | 429 | You made more than 5,000 requests in one minute | Reduce the number of requests sent in one minute | | COMPLEXITY_BUDGET_EXHAUSTED | 429 | You have reached the complexity limit | * Utilize the limits and page arguments* Only request the information you need* Read more about rate limits | | IP_RATE_LIMIT_EXCEEDED | 429 | You have reached the IP limit | * Wait for specified period in the error response before retrying your call* Learn about optimizing your API usage |

5xx server errors

Errors with a 5xx status code indicate that something went wrong on the server (monday’s) side.

Here are some of the most common errors:

• Malformatted JSON column values | * Retry your request after a short period* Double-check your request’s format* Ensure your API token has the right permissions |

Rate limits

GraphQL overview

• Table of Contents

• • Error format

  • Errors by status code

  • • 2xx errors
    • 4xx client errors
    • 5xx server errors