---
title: "章节收藏信息"
method: PATCH
path: "/v0/users/-/collections/{subject_id}/episodes"
tags: ["收藏"]
---

# 章节收藏信息

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

## Request

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

同时会重新计算条目的完成度

## Path parameters

- `subject_id` integer, required: 条目 ID

## Request body

- object
  - `episode_id` integer[], required
  - `type` 1 | 2 | 3, required: - `0`: 未收藏 - `1`: 想看 - `2`: 看过 - `3`: 抛弃

## Response `204`

Successful Response

## Other responses

- `400`: Bad Request
- `401`: not authorized
- `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-09-04** (v0) `20cdcab50c94`: 1 breaking
  - removed the enum value `0.00` of the request property `type`
- **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/episodes/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)
