---
title: "Favorite a repository for the current user"
method: POST
path: "/api/v1/preferences/repos/favorites"
tags: ["Preferences"]
---

# Favorite a repository for the current user

`POST /api/v1/preferences/repos/favorites`

## Request body

- object
  - `repo_id` string, required — Internal repository id

## Response `200`

Pinned and recent repositories after mutation

- object
  - `pinned` object[], required
    - `repo_id` string, required
    - `full_name` string, required
    - `runners_enabled` boolean, required
    - `trails_enabled` boolean, required
    - `last_used_at` string, nullable — Timestamp from this user's retained recent list, including unpin/import recency. Null when unavailable; absent on older servers.
    - `provider` 'github' | 'entire'
  - `recent` object[], required
    - `repo_id` string, required
    - `full_name` string, required
    - `runners_enabled` boolean, required
    - `trails_enabled` boolean, required
    - `last_used_at` string, nullable — Timestamp from this user's retained recent list, including unpin/import recency. Null when unavailable; absent on older servers.
    - `provider` 'github' | 'entire'

## Other responses

- `400` — Invalid request body
- `401` — Not authenticated
- `404` — Repository is missing or inaccessible
- `409` — Favorite repo limit reached

## Changes

- **2026-09-24** `0eb4157af08b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/preferences/repos/favorites/post.md)

---

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