# Audiobookshelf API

**Canonical:** https://apis.io/apis/audiobookshelf/audiobookshelf-api/  
**Provider:** Audiobookshelf — https://apis.io/providers/audiobookshelf/  
**Documentation:** https://api.audiobookshelf.org

Audiobookshelf API is one of 2 APIs that [Audiobookshelf](https://apis.io/providers/audiobookshelf/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Audiobookshelf API as documented publicly: 58 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

## Operations (58)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/authorize` | Get Authorized User and Server Information |
| GET | `/api/backups` | Get All Backups |
| POST | `/api/backups` | Create a Backup |
| POST | `/api/backups/upload` | Upload a Backup |
| POST | `/api/cache/items/purge` | Purge Items Cache |
| POST | `/api/cache/purge` | Cache Purge All Cache |
| POST | `/api/feeds` | Close an RSS Feed |
| POST | `/api/feeds/collection` | Open an RSS Feed for a Collection |
| POST | `/api/feeds/item` | POST /api/feeds/item |
| POST | `/api/feeds/series` | Open an RSS Feed for a Series |
| GET | `/api/filesystem` | Get All Filesystem Paths |
| DELETE | `/api/items/all` | DELETE /api/items/all |
| POST | `/api/items/batch/delete` | POST /api/items/batch/delete |
| POST | `/api/items/batch/get` | POST /api/items/batch/get |
| POST | `/api/items/batch/quickmatch` | POST /api/items/batch/quickmatch |
| POST | `/api/items/batch/update` | POST /api/items/batch/update |
| POST | `/api/items/li_8gch9ve09orgn4fdz8/cover` | POST /api/items/li_8gch9ve09orgn4fdz8/cover |
| DELETE | `/api/libraries` | DELETE /api/libraries |
| GET | `/api/libraries` | Get All Libraries |
| PATCH | `/api/libraries` | PATCH /api/libraries |
| POST | `/api/libraries` | POST /api/libraries |
| POST | `/api/libraries/order` | POST /api/libraries/order |
| GET | `/api/me/items-in-progress` | GET /api/me/items-in-progress |
| GET | `/api/notificationdata` | Get Notification Event Data |
| GET | `/api/notifications` | Get Notification Settings |
| PATCH | `/api/notifications` | Update Notification Settings |
| POST | `/api/notifications` | Create a Notification |
| DELETE | `/api/notifications/{id}` | Delete a Notification |
| GET | `/api/notifications/{id}/test` | Send Notification Test |
| GET | `/api/notifications/test` | Fire Test Notification Event |
| POST | `/api/podcasts` | Create a Podcast |
| POST | `/api/podcasts/feed` | Get a Podcast's Feed |
| POST | `/api/podcasts/opml` | Get Podcast Feeds From OPML |
| GET | `/api/search/authors` | Search for an Author |
| GET | `/api/search/books` | GET /api/search/books |
| POST | `/api/search/books` | POST /api/search/books |
| GET | `/api/search/chapters` | Search for a Book's Chapters |
| GET | `/api/search/covers` | Search for Covers |
| GET | `/api/search/podcast` | Search for Podcasts |
| POST | `/api/session/local` | Sync a Local Session |
| POST | `/api/session/local-all` | Sync Local Sessions |
| GET | `/api/sessions` | Get All Sessions |
| PATCH | `/api/settings` | Update Server Settings |
| GET | `/api/tags` | Get All Tags |
| POST | `/api/tags/rename` | Rename a Tag |
| DELETE | `/api/tools/item` | Cancel an M4B Encode Task |
| POST | `/api/tools/item` | Encode a Book as M4B |
| POST | `/api/upload` | Upload Files |
| GET | `/api/users` | Get All Users |
| POST | `/api/users` | Create a User |
| GET | `/auth/openid` | OAuth2 Authorization Request |
| GET | `/auth/openid/mobile-redirect` | OAuth2 Mobile Redirect |
| GET | `/healthcheck` | Healthcheck |
| POST | `/init` | Initialize the Server |
| POST | `/login` | POST /login |
| POST | `/logout` | Logout |
| GET | `/ping` | Ping the Server |
| GET | `/status` | Check the Server's Status |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/audiobookshelf/openapi/_ae-authored/audiobookshelf-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/audiobookshelf/json-schema/audiobookshelf-post-login-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/audiobookshelf/json-schema/audiobookshelf-post-api-users-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/audiobookshelf/json-schema/audiobookshelf-post-api-notifications-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/audiobookshelf/json-schema/audiobookshelf-get-api-search-chapters-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/audiobookshelf/json-schema/audiobookshelf-post-api-upload-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/audiobookshelf/json-schema/audiobookshelf-delete-api-notifications-id-response-schema.json

## Other Audiobookshelf APIs (1)

- [Audiobookshelf API](https://apis.io/apis/audiobookshelf/audiobookshelf-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/audiobookshelf/audiobookshelf-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/audiobookshelf/.