---
title: "Errors"
description: "Understand the structured errors returned by the API."
canonical: "https://sleevy.app/docs/errors"
source: "https://sleevy.app/docs/errors.md"
---

# Errors



Errors are JSON objects with a stable `_tag` and a human-readable `message`. Some errors include the relevant URL, saved-item ID, or folder ID.

## Error shape [#error-shape]

```json
{
  "_tag": "Unauthorized",
  "message": "Missing or invalid credentials."
}
```

## Status codes [#status-codes]

* `400` — invalid URL, folder name, or request input
* `401` — missing or invalid credentials
* `404` — saved item or folder not found
* `409` — folder name conflict
* `429` — API-key rate limit exceeded