コンテンツにスキップ
commentor API
Esc
↑↓移動↵開く⌘Jプレビュー

文書と案件の結び付きを外す

文書のオーナー、またはその案件の管理の人が、文書と案件の結び付きを外す。個人トークンは access の範囲が必要。

DELETE/api/projects/{code}/docs/{reviewId}
Authorization
AuthorizationBearer token · headerrequired

本人用の個人トークン。発行時に選んだ範囲の操作を、本人の名義で行う。読み取りと本人のトークン操作は、範囲を問わず使える。

Path parameters
codestringrequired

案件コード。大文字・小文字は区別せず、大文字に正規化して扱う。

matches ^[A-Z0-9][A-Z0-9-]{0,31}$
reviewIdstringrequired

文書の ID。文書の URL /reviews/<reviewId> の末尾と同じ。

Responses
200

外した。

object
400

案件コードまたは文書 ID の形が違う(invalid_request)。

errorstringrequired

エラーの種類を表す短いコード。対処を分けるときはこの値を見る。

statusintegerrequired

HTTP ステータスと同じ値。

currentRevisioninteger

409 comments revision conflict のとき、文書の今の commentsRevision。

latestVersionIdstring

409 stale_target_version のとき、文書の最新版の ID。

401

トークンが無いか、この文書を読む権限が無い。

errorstringrequired

エラーの種類を表す短いコード。対処を分けるときはこの値を見る。

statusintegerrequired

HTTP ステータスと同じ値。

currentRevisioninteger

409 comments revision conflict のとき、文書の今の commentsRevision。

latestVersionIdstring

409 stale_target_version のとき、文書の最新版の ID。

403

結び付きを外す権限が無い(forbidden)か、個人トークンの範囲が不足している(insufficient_scope)。

errorstringrequired

エラーの種類を表す短いコード。対処を分けるときはこの値を見る。

statusintegerrequired

HTTP ステータスと同じ値。

currentRevisioninteger

409 comments revision conflict のとき、文書の今の commentsRevision。

latestVersionIdstring

409 stale_target_version のとき、文書の最新版の ID。

404

文書が無い(not found)。

errorstringrequired

エラーの種類を表す短いコード。対処を分けるときはこの値を見る。

statusintegerrequired

HTTP ステータスと同じ値。

currentRevisioninteger

409 comments revision conflict のとき、文書の今の commentsRevision。

latestVersionIdstring

409 stale_target_version のとき、文書の最新版の ID。

409

指定した案件が今の結び付け先と違う(project_link_mismatch)か、同時変更と競合した(project_conflict)。

errorstringrequired

エラーの種類を表す短いコード。対処を分けるときはこの値を見る。

statusintegerrequired

HTTP ステータスと同じ値。

currentRevisioninteger

409 comments revision conflict のとき、文書の今の commentsRevision。

latestVersionIdstring

409 stale_target_version のとき、文書の最新版の ID。

Request
curl -X DELETE 'https://comment-review.fsmarketing.workers.dev/api/projects/EX-AA/docs/review_example01' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Response
{}