---
title: "修改用户单个收藏"
method: PATCH
path: "/v0/users/-/collections/{subject_id}"
tags: ["收藏"]
---

# 修改用户单个收藏

`PATCH /v0/users/-/collections/{subject_id}`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

修改条目收藏状态

由于直接修改剧集条目的完成度可能会引起意料之外效果，只能用于修改书籍类条目的完成度。

PATCH 方法的所有请求体字段均可选

## Path parameters

- `subject_id` integer, required: 条目 ID

## Request body

- UserSubjectCollectionModifyPayload: 所有的字段均可选
  - `type` 1 | 2 | 3 | 4 | 5: - `1`: 想看 - `2`: 看过 - `3`: 在看 - `4`: 搁置 - `5`: 抛弃
  - `rate` integer: 评分，`0` 表示删除评分
  - `ep_status` integer: 只能用于修改书籍条目进度
  - `vol_status` integer: 只能用于修改书籍条目进度
  - `comment` string: 评价
  - `private` boolean: 仅自己可见
  - `tags` string[]: 不传或者 `null` 都会被忽略，传 `[]` 则会删除所有 tag。

## Response `204`

Successful Response

## Other responses

- `400`: Validation Error
- `401`: Unauthorized
- `404`: 用户不存在或者条目未收藏

## Changes

- **2022-11-19** (v0) `bb6bcec42206`: 3 warning, 3 info
  - removed the optional property `detail` from the response with the `400` status
  - removed the optional property `detail` from the response with the `401` status
  - removed the optional property `detail` from the response with the `404` status
  - added the optional property `details` to the response with the `400` status
  - …2 more
- **2022-08-13** (v0) `ba1aa467063a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bangumi/apis/bangumi-open-api/changes/v0/users/-/collections/:subject_id/patch.md)

---

[API](https://skmtc.dev/bangumi/apis/bangumi-open-api.md) - [All operations](https://skmtc.dev/bangumi/apis/bangumi-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bangumi/apis/bangumi-open-api/revisions/6aafdbda7895?raw)