title: comments sidebarTitle: comments#

backend.api.tracks.comments#

Track timed comments endpoints.

Functions#

get_track_comments source#

get_track_comments(track_id: int, db: Annotated[AsyncSession, Depends(get_db)]) -> CommentsListResponse

get all comments for a track, ordered by timestamp.

public endpoint - no auth required.

create_comment source#

create_comment(track_id: int, body: CommentCreate, db: Annotated[AsyncSession, Depends(get_db)], auth_session: AuthSession = Depends(require_auth)) -> CommentResponse

create a timed comment on a track.

requires auth. track owner must have allow_comments enabled. the comment is visible immediately; the ATProto record is created in background.

delete_comment source#

delete_comment(comment_id: int, db: Annotated[AsyncSession, Depends(get_db)], auth_session: AuthSession = Depends(require_auth)) -> DeletedResponse

delete a comment. only the author can delete their own comments.

the comment is removed immediately; the ATProto record is deleted in background.

update_comment source#

update_comment(comment_id: int, body: CommentUpdate, db: Annotated[AsyncSession, Depends(get_db)], auth_session: AuthSession = Depends(require_auth)) -> CommentResponse

update a comment's text. only the author can edit their own comments.

the comment is updated immediately; the ATProto record is updated in background.

Classes#

CommentCreate source#

request body for creating a comment.

CommentUpdate source#

request body for updating a comment.

CommentResponse source#

response model for a single comment.

CommentsListResponse source#

response model for list of comments.