Appearance
me
25 endpoints at a glance
| Method | Path | Summary |
|---|---|---|
GET | /me/albums/owned | List Owned |
POST | /me/albums/owned | Mark Owned |
DELETE | /me/albums/owned/{canonical_id} | Mark Not Owned |
GET | /me/albums/wishlist | List Wishlist |
POST | /me/albums/wishlist | Add To Wishlist |
DELETE | /me/albums/wishlist/{canonical_id} | Remove From Wishlist |
GET | /me/comments | List My Comments |
DELETE | /me/comments/{comment_id} | Delete Comment |
PATCH | /me/comments/{comment_id} | Edit Comment |
GET | /me/comments/{kind}/{canonical_id} | List Item Comments |
POST | /me/comments/{kind}/{canonical_id} | Add Item Comment |
POST | /me/comments/counts | Comment Counts |
GET | /me/favorites/albums | List Favorite Albums |
POST | /me/favorites/albums | Favorite Album |
DELETE | /me/favorites/albums/{canonical_id} | Unfavorite Album |
GET | /me/favorites/artists | List Favorite Artists |
POST | /me/favorites/artists | Favorite Artist |
DELETE | /me/favorites/artists/{canonical_id} | Unfavorite Artist |
GET | /me/favorites/tracks | List Favorite Tracks |
POST | /me/favorites/tracks | Favorite Track |
DELETE | /me/favorites/tracks/{canonical_id} | Unfavorite Track |
GET | /me/stats/albums/{canonical_id} | Stats Album |
GET | /me/stats/artists/{canonical_id} | Stats Artist |
GET | /me/stats/tracks/{canonical_id} | Stats Track |
GET | /me/tasks/{task_id} | Get My Task |
me
List Favorite Artists
Favorite Artist
Unfavorite Artist
List Favorite Albums
Favorite Album
Unfavorite Album
List Favorite Tracks
Favorite Track
Unfavorite Track
List Wishlist
Add To Wishlist
Remove From Wishlist
List Owned
Mark Owned
Mark Not Owned
Comment Counts
POST
/me/comments/counts
Batch visible-comment counts: {"<kind>::<id>": n} for the
requested items. One round-trip for list-row indicators.
Parameters
Header Parameters
authorization
x-api-key
Request Body
application/json
JSON "items": [ { "kind": "string", "canonical_id": "string" } ]
{
}
Responses
Successful Response
application/json
JSON "additionalProperties": 0
{
}
List My Comments
GET
/me/comments
All of the caller's notes, newest-first (the My Notes page). Each
note carries an item summary (title / subtitle / cover) so the
page can render a real entity row, not a bare canonical id.
Parameters
Header Parameters
authorization
x-api-key
Responses
Successful Response
application/json
JSON { "additionalProperties": "string" }
[
]
List Item Comments
GET
/me/comments/{kind}/{canonical_id}
The thread on one entity, oldest-first. Admins see everyone's
notes; regular users see only their own.
Parameters
Header Parameters
authorization
x-api-key
Path Parameters
kind*
Type
Requiredstring
canonical_id*
Type
Requiredstring
Responses
Successful Response
application/json
JSON { "additionalProperties": "string" }
[
]
Add Item Comment
Delete Comment
Edit Comment
PATCH
/me/comments/{comment_id}
Edit own note. Author-scoped — 404 if it isn't yours (admins
included; they can read others' but not mutate them).
Parameters
Header Parameters
authorization
x-api-key
Path Parameters
comment_id*
Type
Requiredstring
Request Body
application/json
JSON "body": "string"
{
}
Responses
Successful Response
application/json
JSON "additionalProperties": "string"
{
}
Get My Task
GET
/me/tasks/{task_id}
Poll a background task that this user started.
Returns the same shape as GET /admin/task-history/{id} but
refuses to leak rows started by anyone else. The composable
useBackgroundTask polls this endpoint every 2s for SPA-driven
sync flows where the caller is the task owner.
Parameters
Header Parameters
authorization
x-api-key
Path Parameters
task_id*
Type
Requiredstring
Responses
Successful Response
application/json
JSON "additionalProperties": "string"
{
}