API/Errors

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