---
title: "新增或修改条目收藏"
method: PUT
path: "/p1/collections/subjects/{subjectID}"
tags: ["collection"]
---

# 新增或修改条目收藏

`PUT /p1/collections/subjects/{subjectID}`

## Path parameters

- `subjectID` integer, required

## Request body

- CollectSubject
  - `comment` string — 评价
  - `private` boolean — 仅自己可见
  - `progress` boolean — 是否自动完成条目进度，仅在 `type` 为 `看过` 时有效，并且不会产生对应的时间线记录： - 书籍条目会检查总的话数和卷数，并更新收藏进度到最新; - 动画和三次元会标记所有正片章节为已完成，并同时更新收藏进度
  - `rate` integer — 评分，0 表示删除评分
  - `tags` string[]
  - `type` 1 | 2 | 3 | 4 | 5 — 条目收藏状态 - 1 = 想看 - 2 = 看过 - 3 = 在看 - 4 = 搁置 - 5 = 抛弃

## Response `200`

Default Response

- object

## Other responses

- `429` — default error response type
- `500` — 意料之外的服务器错误

---

[API](https://skmtc.net/bangumi/apis/bangumi-private-api.md) · [All operations](https://skmtc.net/bangumi/apis/bangumi-private-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bangumi/bangumi-private-api/revisions/645c5a56dde8/schema)