Repository navigation
feat: [BE] Add pagination to published components endpoint #179
Description
Description
The GET /api/published_components/ endpoint currently returns all components with no pagination. There are existing TODO comments in the code acknowledging this:
# TODO: Implement paging
# TODO: Implement filtering/search
# TODO: Implement visibility/access controlAs the component library grows and a Components tab is added to the homepage, this needs pagination support.
Part of TangleML/tangle-ui#1963
Implementation
Follow the same pagination pattern used by GET /api/pipeline_runs/:
- Add
page_sizequery param (default 20) - Add
page_tokenquery param for cursor-based pagination (base64-encoded offset) - Add
next_page_tokento response - Add
total_countto response (component count is much smaller than runs, so a full count is fine here)
Response change
@dataclasses.dataclass(kw_only=True)
class ListPublishedComponentsResponse:
published_components: list[PublishedComponentResponse]
next_page_token: str | None = None # NEW
total_count: int | None = None # NEWRelevant file
component_library_api_server.py—list()method
Activity
[-]feat: Add pagination to published components endpoint[/-][+]feat: [BE] Add pagination to published components endpoint[/+]yuechao-qin commentedon Mar 19, 2026
Just trying to get a sense of priority / urgency:
Ark-kun commentedon Mar 19, 2026
Agreed.
I'm a bit skeptical here.
Mbeaulne commentedon Mar 23, 2026
Good questions — here's where things stand:
Mbeaulne commentedon Mar 23, 2026
Curious what's driving the skepticism — is it the assumption that component counts will stay small enough to make a full
total_countcheap? How many components are we realistically expecting over time?yuechao-qin commentedon Mar 25, 2026
@Mbeaulne i think this is a good candidate for my goal of creating an experimental API in oasis-backend. I will need to 1) create a design doc and review it with the team and then 2) implement it. Curious how urgent are you wanting this feature. My thought is might have an release by mid April if everything goes smoothly.