Error Handling

The API uses conventional HTTP status codes to indicate the success or failure of a request.

HTTP Codes

• 200 OK - Success

  Everything worked as expected.

• 400 Bad Request - Invalid Request

  Usually occurs when the body JSON is malformed or required fields are missing.

• 404 Not Found - Not Found

  The sheet ID does not exist or the requested record was not found.

• 500 Server Error - Internal Error

  Something went wrong on the Sheetful server or in communication with Google.

Error Response Structure

When an error occurs, the response body will contain a JSON object with details:

{
  "error": {
    "code": "resource_not_found",
    "message": "The spreadsheet with the specified ID was not found."
  }
}