---
title: "Record that you opened a project"
method: POST
path: "/api/v1/preferences/projects/recent"
tags: ["Preferences"]
---

# Record that you opened a project

`POST /api/v1/preferences/projects/recent`

## Request

- Base URL: `https://entire.io` (the document declares no server; this is the origin it was published from)
- URL: `https://entire.io/api/v1/preferences/projects/recent`
- Auth: none declared
- TypeScript: <https://skmtc.dev/entire/apis/entire-api/docs/api/v1/preferences/projects/recent/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `project_id` string, required

## Response `200`

Favorite and recent projects

- object
  - `favorite_project_ids` string[], required: Every saved favorite, including projects you can no longer view.
  - `favorites` object[], required: Favorite projects you can view, in saved order.
    - `id` string, required
    - `name` string, required
    - `provider` 'github' | 'entire', required
    - `reference` object, required
      - `forge` 'gh' | 'et', required
      - `project` string, required
    - `favorited_at` string: When you favorited the project. Present on favorites only, and absent on favorites saved before this was recorded.
    - `last_used_at` string: When you last opened the project. Present on recent projects only.
  - `recent` object[], required: Projects you opened most recently, newest first. You keep your 10 newest recent repositories and projects combined.
    - `id` string, required
    - `name` string, required
    - `provider` 'github' | 'entire', required
    - `reference` object, required
      - `forge` 'gh' | 'et', required
      - `project` string, required
    - `favorited_at` string: When you favorited the project. Present on favorites only, and absent on favorites saved before this was recorded.
    - `last_used_at` string: When you last opened the project. Present on recent projects only.

## Other responses

- `401`: Not authenticated
- `409`: You already have 10 favorite repositories and projects combined
- `422`: Invalid project ID or request body

## Changes

- **2026-11-06** `7bb811a9983a`: 2 info
  - added the optional property `favorites/items/favorited_at` to the response with the `200` status
  - added the optional property `recent/items/favorited_at` to the response with the `200` status
- **2026-11-04** `d2440a3a7932`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/preferences/projects/recent/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/9a65986f3290?raw)