---
title: "新增或修改用户单个条目收藏"
method: POST
path: "/v0/users/-/collections/{subject_id}"
tags: ["收藏"]
---

# 新增或修改用户单个条目收藏

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

## Request

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

修改条目收藏状态, 如果不存在则创建，如果存在则修改

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

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

## 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

- **2023-05-03** (v0) `1bcca6d2484d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bangumi/apis/bangumi-open-api/changes/v0/users/-/collections/:subject_id/post.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)