オーナーを移譲する

本当のオーナーが、すでに一度ログインした組織メンバーへオーナーを移譲する。前のオーナーは編集者として残る。個人トークンは access の範囲が必要。

PUT/api/reviews/{reviewId}/owner

Authorization

AuthorizationBearer token · headerrequired

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

Path parameters

reviewIdstringrequired

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

Request body

requiredapplication/json

emailstring<email>required

Responses

200

移譲した。

reviewReview

文書とコメントの全体。ここに挙げた項目のほかにも、画面が使う項目が入る。

Show properties

reviewIdstring

titlestring

commentsRevisioninteger

コメントが書き換わるたびに 1 増える番号。書き込みで baseCommentsRevision として送る。

structureRevisioninteger

commentsComment[]

Show properties

Array of Comment

idstring

authorUser

書いた人。エージェント用トークンで書いたものは、トークンの持ち主の名義になる。

Show properties

idstring

providerstring

displayNamestring

categorystring

コメントの種類。note はメモ、revise は書き換えの提案、add は追記、delete は削除の提案、needs_review は確認、consult は相談。none は分類の無い旧いデータで、画面ではメモとして出す。

Allowed:notereviseadddeleteneeds_reviewconsultnone

statusstring

open は未解決、closed は解決済み。

Allowed:openclosed

bodystring

anchorobject

画面でコメントを表示する位置。書き込むときは anchor でなく Locator を送る。

threadThreadMessage[]

Show properties

Array of ThreadMessage

idstring

authorUser

書いた人。エージェント用トークンで書いたものは、トークンの持ち主の名義になる。

bodystring

createdTsstring<date-time>

statusEventsStatusEvent[]

Show properties

Array of StatusEvent

seqinteger

statusstring

Allowed:openclosed

byUser

書いた人。エージェント用トークンで書いたものは、トークンの持ち主の名義になる。

tsstring<date-time>

versionIdstring

コメントを付けた文書の版。

createdTsstring<date-time>

editedTsstring<date-time>

deletedTsstring<date-time>

削除されたコメントにだけ付く。画面には出ない。

aiReviewRunsRun[]

Show properties

Array of Run

idstring

kindstring

Allowed:ai_reviewvoice

statusstring

Allowed:runningcompletedfailedcancelled

titlestring

versionIdstring

commentIdsstring[]

summarystring

createdTsstring<date-time>

completedTsstring<date-time>

createdAtstring<date-time>

sourceobject

本文の出どころと版。

Show properties

versionsobject[]

版の一覧。古い順で、最後が最新の版。

Show properties

Array of object

versionIdstring

labelstring

createdAtinteger

版を作った時刻（UNIX 時間のミリ秒）。

sourceHashstring

_projectProjectLink

この文書に案件の結び付けがあるときだけ付く。

Show properties

codestringrequired

namestring | nullrequired

companystring | nullrequired

statusstringrequired

Allowed:activeinactive

inSnapshotbooleanrequired

rolestring | nullrequired

要求した本人の案件の役割。

Allowed:managereditorviewernull

400

メールアドレスの形が違う（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）か、移譲先が組織のメンバーではない（invite_not_member）。

errorstringrequired

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

statusintegerrequired

HTTP ステータスと同じ値。

currentRevisioninteger

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

latestVersionIdstring

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

404

文書・run・コメントのいずれかが無い。

errorstringrequired

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

statusintegerrequired

HTTP ステータスと同じ値。

currentRevisioninteger

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

latestVersionIdstring

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

409

移譲先がログインしていない（owner_not_logged_in）、Google の身分が複数ある（owner_ambiguous）、または現在のオーナーと同じ（owner_unchanged）。

errorstringrequired

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

statusintegerrequired

HTTP ステータスと同じ値。

currentRevisioninteger

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

latestVersionIdstring

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

Request

curl -X PUT 'https://comment-review.fsmarketing.workers.dev/api/reviews/review_example01/owner' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "someone@example.com"
}'

const response = await fetch("https://comment-review.fsmarketing.workers.dev/api/reviews/review_example01/owner", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"email\": \"someone@example.com\"\n}"
});

import requests

response = requests.put(
    "https://comment-review.fsmarketing.workers.dev/api/reviews/review_example01/owner",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"email\": \"someone@example.com\"\n}",
)

Response

{
  "review": {
    "reviewId": "string",
    "title": "string",
    "commentsRevision": 0,
    "structureRevision": 0,
    "comments": [
      {
        "id": "string",
        "author": {
          "id": "string",
          "provider": "string",
          "displayName": "string"
        },
        "category": "note",
        "status": "open",
        "body": "string",
        "anchor": {},
        "thread": [
          {
            "id": "string",
            "author": {
              "id": "string",
              "provider": "string",
              "displayName": "string"
            },
            "body": "string",
            "createdTs": "2019-08-24T14:15:22Z"
          }
        ],
        "statusEvents": [
          {
            "seq": 0,
            "status": "open",
            "by": {
              "id": "string",
              "provider": "string",
              "displayName": "string"
            },
            "ts": "2019-08-24T14:15:22Z"
          }
        ],
        "versionId": "string",
        "createdTs": "2019-08-24T14:15:22Z",
        "editedTs": "2019-08-24T14:15:22Z",
        "deletedTs": "2019-08-24T14:15:22Z"
      }
    ],
    "aiReviewRuns": [
      {
        "id": "string",
        "kind": "ai_review",
        "status": "running",
        "title": "string",
        "versionId": "string",
        "commentIds": [
          "string"
        ],
        "summary": "string",
        "createdTs": "2019-08-24T14:15:22Z",
        "completedTs": "2019-08-24T14:15:22Z"
      }
    ],
    "createdAt": "2019-08-24T14:15:22Z",
    "source": {
      "versions": [
        {
          "versionId": "string",
          "label": "string",
          "createdAt": 0,
          "sourceHash": "string"
        }
      ]
    },
    "_project": {
      "code": "EX-AA",
      "name": "string",
      "company": "string",
      "status": "active",
      "inSnapshot": true,
      "role": "manager"
    }
  }
}

{
  "error": "string",
  "status": 0,
  "currentRevision": 0,
  "latestVersionId": "string"
}

{
  "error": "string",
  "status": 0,
  "currentRevision": 0,
  "latestVersionId": "string"
}

{
  "error": "string",
  "status": 0,
  "currentRevision": 0,
  "latestVersionId": "string"
}

{
  "error": "review not found",
  "status": 404
}

{
  "error": "string",
  "status": 0,
  "currentRevision": 0,
  "latestVersionId": "string"
}