---
title: "List Starred Components"
method: GET
path: "/v1/starred_components"
tags: ["v1", "starred_components"]
---

# List Starred Components

`GET /v1/starred_components`

## Request

- Base URL: `https://thrustlab.com`
- URL: `https://thrustlab.com/v1/starred_components`
- Auth: HTTP bearer

List the caller's stars across all projects, newest first, cursor-paginated.

Supports flat-filter narrowing by project and component type.

Query parameters: project (optional, prefixed or UUID; cross-user → 404),
component_type (optional; motor|battery|propeller), limit (1-100,
default 25), cursor (pagination token).

Returns a list response with data, has_more, and next_cursor fields.
Each row carries its own star_<ksuid> id, both parent prefixed identifiers,
and created_at timestamp.

## Query parameters

- `project` string, nullable
- `component_type` string, nullable
- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- StarredComponentListResponse
  - `data` StarredComponentResource[], required
    - `component_id` string, required
    - `component_type` string, required
    - `created_at` string, date-time, required
    - `id` string, required
    - `object` string
    - `project_id` string, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `object` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thrustlab/apis/thrustlab-api.md) · [All operations](https://skmtc.dev/thrustlab/apis/thrustlab-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thrustlab/apis/thrustlab-api/revisions/c19717e52529?raw)
