文書とコメントを読む
文書の情報と、すべてのコメント・返信・解決の履歴を返す。削除されたコメントも deletedTs 付きで入るので、画面と同じ一覧にするときは除く。
書き込みに使う commentsRevision もここで取る。
/api/reviews/{reviewId}AuthorizationBearer token · headerrequiredエージェント用トークン。文書とコメントを読み、run の中でコメントを書くのに使う。ブラウザのログインと一緒に送らない。
AuthorizationBearer token · headerrequired取り込み用トークン。文書を上げる、版を追加する、文書の一覧と中身を読むのに使う。
AuthorizationBearer token · headerrequired本人用の個人トークン。発行時に選んだ範囲の操作を、本人の名義で行う。読み取りと本人のトークン操作は、範囲を問わず使える。
reviewIdstringrequired文書の ID。文書の URL /reviews/<reviewId> の末尾と同じ。
commentVersionsstring1 を付けると、各コメントがどの版に付いたかの情報を含める。
1読めた。
reviewReview文書とコメントの全体。ここに挙げた項目のほかにも、画面が使う項目が入る。
Show propertiesHide properties
reviewIdstringtitlestringcommentsRevisionintegerコメントが書き換わるたびに 1 増える番号。書き込みで baseCommentsRevision として送る。
structureRevisionintegercommentsComment[]Show propertiesHide properties
CommentidstringauthorUser書いた人。エージェント用トークンで書いたものは、トークンの持ち主の名義になる。
Show propertiesHide properties
idstringproviderstringdisplayNamestringcategorystringコメントの種類。note はメモ、revise は書き換えの提案、add は追記、delete は削除の提案、needs_review は確認、consult は相談。none は分類の無い旧いデータで、画面ではメモとして出す。
notereviseadddeleteneeds_reviewconsultnonestatusstringopen は未解決、closed は解決済み。
openclosedbodystringanchorobject画面でコメントを表示する位置。書き込むときは anchor でなく Locator を送る。
threadThreadMessage[]Show propertiesHide properties
ThreadMessageidstringauthorUser書いた人。エージェント用トークンで書いたものは、トークンの持ち主の名義になる。
bodystringcreatedTsstring<date-time>statusEventsStatusEvent[]Show propertiesHide properties
StatusEventseqintegerstatusstringopenclosedbyUser書いた人。エージェント用トークンで書いたものは、トークンの持ち主の名義になる。
tsstring<date-time>versionIdstringコメントを付けた文書の版。
createdTsstring<date-time>editedTsstring<date-time>deletedTsstring<date-time>削除されたコメントにだけ付く。画面には出ない。
aiReviewRunsRun[]Show propertiesHide properties
Runidstringkindstringai_reviewvoicestatusstringrunningcompletedfailedcancelledtitlestringversionIdstringcommentIdsstring[]summarystringcreatedTsstring<date-time>completedTsstring<date-time>createdAtstring<date-time>sourceobject本文の出どころと版。
Show propertiesHide properties
versionsobject[]版の一覧。古い順で、最後が最新の版。
Show propertiesHide properties
objectversionIdstringlabelstringcreatedAtinteger版を作った時刻（UNIX 時間のミリ秒）。
sourceHashstring_projectProjectLinkこの文書に案件の結び付けがあるときだけ付く。
Show propertiesHide properties
codestringrequirednamestring | nullrequiredcompanystring | nullrequiredstatusstringrequiredactiveinactiveinSnapshotbooleanrequiredrolestring | nullrequired要求した本人の案件の役割。
managereditorviewernullトークンが無いか、この文書を読む権限が無い。
errorstringrequiredエラーの種類を表す短いコード。対処を分けるときはこの値を見る。
statusintegerrequiredHTTP ステータスと同じ値。
currentRevisioninteger409 comments revision conflict のとき、文書の今の commentsRevision。
latestVersionIdstring409 stale_target_version のとき、文書の最新版の ID。
文書・run・コメントのいずれかが無い。
errorstringrequiredエラーの種類を表す短いコード。対処を分けるときはこの値を見る。
statusintegerrequiredHTTP ステータスと同じ値。
currentRevisioninteger409 comments revision conflict のとき、文書の今の commentsRevision。
latestVersionIdstring409 stale_target_version のとき、文書の最新版の ID。