---
method: POST
path: /api/sync/kobo/:token/sync-from-server
auth: device-token
area: kobo
---
<!-- source: internal/handlers/kobo.go:751 KoboHandler.SyncFromServer -->

# Sync From Server

> **Status: Coming Soon** — Native Kobo sync is not yet supported on real devices; this endpoint is under active development and may change.

Push content and metadata to Kobo device.

**Endpoint**: `POST /api/sync/kobo/:token/sync-from-server`
**Auth**: Required (Device authentication)

## Device Authentication

This endpoint requires device authentication (not user JWT). Kobo devices authenticate using their device credentials and access tokens.

## Request Body

| Field     | Type            | Required | Description                                   |
| --------- | --------------- | -------- | --------------------------------------------- |
| book_ids  | array of string | No       | Array of ContentIDs to sync                   |
| full_sync | boolean         | No       | Whether to perform full sync (default: false) |

### Example Request

```json example-request
{
  "book_ids": ["content-id-1", "content-id-2"],
  "full_sync": false
}
```

## Response (200 OK)

```json example-response
{
  "BookmarksSent": null,
  "BooksSynced": null,
  "HighlightsSent": null
}
```

## Error Responses

| Code | Description                  |
| ---- | ---------------------------- |
| 401  | Device authentication failed |
| 404  | Device not found             |

## Notes

This endpoint pushes library content from the server to the Kobo device. It's called during sync operations to update the device's library catalog.