# Ditto Audio Sync/library API

**Canonical:** https://apis.io/apis/ditto-audio/ditto-audio-sync-library-api/  
**Provider:** Ditto Audio — https://apis.io/providers/ditto-audio/  
**Base URL:** https://ditto.audio/v1  
**Documentation:** https://ditto.audio/docs/reference

Ditto Audio Sync/library API is one of 30 APIs that [Ditto Audio](https://apis.io/providers/ditto-audio/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include sync/library. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Reader cloud sync — books, reading progress, file backup

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/sync/books` | List your cloud library (each book annotated with rendered-audio coverage) |
| GET | `/v1/sync/books/{bookId}` | Get one library book |
| PUT | `/v1/sync/books/{bookId}` | Add/update a book in your library |
| DELETE | `/v1/sync/books/{bookId}` | Remove a book from your library (+ its cloud file) |
| GET | `/v1/sync/books/{bookId}/progress` | Get reading progress for a book |
| PUT | `/v1/sync/books/{bookId}/progress` | Update reading progress for a book |
| GET | `/v1/sync/books/{bookId}/bookmarks` | Sync library controller bookmarks |
| GET | `/v1/sync/books/{bookId}/annotations` | Sync library controller annotations |
| GET | `/v1/sync/books/{bookId}/audio` | Sync library controller audio |
| POST | `/v1/sync/books/{bookId}/file/presign` | Presigned PUT to upload the book file to your cloud |
| POST | `/v1/sync/books/{bookId}/file/confirm` | Confirm the upload landed (records size + hash) |
| GET | `/v1/sync/books/{bookId}/file` | Presigned URL to download the cloud book file |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/ditto-audio/openapi/ditto-audio-sync-library-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/ditto-audio/json-schema/ditto-audio-speech-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/ditto-audio/json-schema/ditto-audio-create-audio-batch-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/ditto-audio/json-schema/ditto-audio-speech-batch-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/ditto-audio/json-schema/ditto-audio-create-voice-model-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/ditto-audio/json-schema/ditto-audio-update-voice-model-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/ditto-audio/json-schema/ditto-audio-create-custom-voice-dto-schema.json

## Other Ditto Audio APIs (12)

- [Ditto Audio Admin/db API](https://apis.io/apis/ditto-audio/ditto-audio-admin-db-api/)
- [Ditto Audio Admin/inference API](https://apis.io/apis/ditto-audio/ditto-audio-admin-inference-api/)
- [Ditto Audio Admin/models API](https://apis.io/apis/ditto-audio/ditto-audio-admin-models-api/)
- [Ditto Audio API Keys API](https://apis.io/apis/ditto-audio/ditto-audio-api-keys-api/)
- [Ditto Audio Audio API](https://apis.io/apis/ditto-audio/ditto-audio-audio-api/)
- [Ditto Audio Auth API](https://apis.io/apis/ditto-audio/ditto-audio-auth-api/)
- [Ditto Audio Chunks API](https://apis.io/apis/ditto-audio/ditto-audio-chunks-api/)
- [Ditto Audio Docs API](https://apis.io/apis/ditto-audio/ditto-audio-docs-api/)
- [Ditto Audio Favorites API](https://apis.io/apis/ditto-audio/ditto-audio-favorites-api/)
- [Ditto Audio Health API](https://apis.io/apis/ditto-audio/ditto-audio-health-api/)
- [Ditto Audio Inference API](https://apis.io/apis/ditto-audio/ditto-audio-inference-api/)
- [Ditto Audio license (native client) API](https://apis.io/apis/ditto-audio/ditto-audio-license-native-client-api/)

## Tags

sync/library

---

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