Skip to main content
PATCH
商談ログを部分更新

承認

Authorization
string
header
必須

Stockwork が発行する API キー(sk_ プレフィックス、base62 ランダム ≥ 40 文字)。 キーには 1 つの role(read / analyst / write / admin)が紐付き、 各エンドポイントの必要 role 以上であることが要求される(対応表は info.description 参照)。

パスパラメータ

record_id
string
必須

Stockwork record_id(18 文字英数字)

Pattern: ^[A-Za-z0-9]{18}$

ボディ

application/json
properties
object
必須

部分更新可。送信したプロパティのみが更新される。

レスポンス

更新成功

商談ログの単一レコード表現。MeetingLog に要約(summaries)を加えたもの。 取得 / 作成 / 更新の応答で返る(一覧・検索では返らない)。

id
string
必須

Stockwork record_id(18 文字)

例:

"Ml4aB9xY2zKt7Qw1Pn"

properties
object
必須

商談ログのプロパティ集合。deal_id(親取引)・meeting_date・content を中心に、 meeting_name / genre(商談カテゴリ)/ participants 等のコアフィールドと 組織別カスタムプロパティが同じ namespace で扱われる。

created_at
string<date-time>
必須
updated_at
string<date-time>
必須

レコードの値が最後に変わった日時。コアフィールド・カスタムプロパティ・アクティビティ件数などの集計値のいずれかが実際に変わったときに進む。商談ログやメールなどの活動を記録した場合も、それが集計値を動かすためこの日時が進む。同じ値での再保存や、他レコードとの紐付け変更では進まない。

summaries
object[]
必須

紐づくヒアリングシート(要約)。read-only。未生成時は空配列。