58 lines
1.2 KiB
Markdown
58 lines
1.2 KiB
Markdown
# List Collections
|
|
|
|
Get all collections for the authenticated user.
|
|
|
|
**Endpoint**: `GET /api/collections`
|
|
**Auth**: Required
|
|
**Content-Type**: `application/json`
|
|
|
|
## Query Parameters
|
|
|
|
| Parameter | Type | Required | Description |
|
|
|-----------|------|-----------|-------------|
|
|
| limit | integer | No | Number of collections to return (default: 50) |
|
|
| offset | integer | No | Number of collections to skip (default: 0) |
|
|
|
|
## Response (200 OK)
|
|
|
|
```json
|
|
{
|
|
"collections": [
|
|
{
|
|
"id": "550e8400-e29b-41d4-a716-446655440000",
|
|
"name": "Science Fiction",
|
|
"description": "My sci-fi collection",
|
|
"color": "#FF5733",
|
|
"icon": "🚀",
|
|
"auto_assign_rules": [
|
|
{
|
|
"field": "genre",
|
|
"operator": "equals",
|
|
"value": "Science Fiction",
|
|
"priority": 1,
|
|
"enabled": true
|
|
}
|
|
],
|
|
"view_settings": {
|
|
"kobo": {
|
|
"view_mode": "grid",
|
|
"sort_order": "name",
|
|
"items_per_page": 24
|
|
}
|
|
},
|
|
"created_at": "2026-02-01T10:00:00Z"
|
|
}
|
|
],
|
|
"total": 1
|
|
}
|
|
```
|
|
|
|
## Error Responses
|
|
|
|
| Code | Description |
|
|
|------|-------------|
|
|
| 401 | Authentication required |
|
|
| 500 | Internal server error |
|
|
|
|
## Try It Out
|