curl --request POST \
--url https://api.strixai.jp/v1/calendar-events/{record_id}/recording/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"deal_linking": {
"deal_id": "Rb7XkQpYz3Lh9vMs2N",
"genre": "初回商談"
}
}
'import requests
url = "https://api.strixai.jp/v1/calendar-events/{record_id}/recording/"
payload = { "deal_linking": {
"deal_id": "Rb7XkQpYz3Lh9vMs2N",
"genre": "初回商談"
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({deal_linking: {deal_id: 'Rb7XkQpYz3Lh9vMs2N', genre: '初回商談'}})
};
fetch('https://api.strixai.jp/v1/calendar-events/{record_id}/recording/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.strixai.jp/v1/calendar-events/{record_id}/recording/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'deal_linking' => [
'deal_id' => 'Rb7XkQpYz3Lh9vMs2N',
'genre' => '初回商談'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.strixai.jp/v1/calendar-events/{record_id}/recording/"
payload := strings.NewReader("{\n \"deal_linking\": {\n \"deal_id\": \"Rb7XkQpYz3Lh9vMs2N\",\n \"genre\": \"初回商談\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.strixai.jp/v1/calendar-events/{record_id}/recording/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"deal_linking\": {\n \"deal_id\": \"Rb7XkQpYz3Lh9vMs2N\",\n \"genre\": \"初回商談\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.strixai.jp/v1/calendar-events/{record_id}/recording/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"deal_linking\": {\n \"deal_id\": \"Rb7XkQpYz3Lh9vMs2N\",\n \"genre\": \"初回商談\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "Ce7XkQpYz3Lh9vMs2N",
"title": "株式会社サンプル 定例",
"start_time": "2026-10-03T00:30:00Z",
"end_time": "2026-10-03T01:30:00Z",
"status": "active",
"meeting_url": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_sample",
"meeting_platform": "microsoft_teams",
"meeting_key": "mk_5c1f0d8e2a7b4c9d8e7f6a5b4c3d2e1f",
"owner_id": "Us7XkQpYz3Lh9vMs2N",
"organizer_email": "yamada@example.co.jp",
"ical_uid": "040000008200E00074C5B7101A82E0080000000000000000000000000000000",
"is_recurring": false,
"recording": {
"state": "scheduled",
"scheduled_by": "manual",
"meeting_record_id": "Mr7XkQpYz3Lh9vMs2N",
"is_representative": true
},
"deal_linking": {
"deal_id": "Rb7XkQpYz3Lh9vMs2N",
"genre": "初回商談",
"assignee_ids": [
"Ub3MqTzW5Ly8Nc1KsP"
],
"participants": "先方 佐藤様"
},
"created_at": "2026-09-28T02:00:00Z",
"updated_at": "2026-09-28T02:05:00Z"
}{
"error": {
"code": "validation_error",
"message": "リクエストの検証に失敗しました。",
"fields": [
{
"name": "properties.name",
"code": "required",
"message": "この項目は必須です。"
}
]
}
}{
"error": {
"code": "validation_error",
"message": "リクエストの検証に失敗しました。",
"fields": [
{
"name": "properties.name",
"code": "required",
"message": "この項目は必須です。"
}
]
}
}{
"error": {
"code": "quota_exceeded",
"message": "今月の文字起こし利用上限に達しています。"
}
}{
"error": {
"code": "validation_error",
"message": "リクエストの検証に失敗しました。",
"fields": [
{
"name": "properties.name",
"code": "required",
"message": "この項目は必須です。"
}
]
}
}{
"error": {
"code": "invalid_state",
"reason": "meeting_ended",
"message": "終了した会議には予約できません"
}
}{
"error": {
"code": "validation_error",
"message": "リクエストの検証に失敗しました。",
"fields": [
{
"name": "properties.name",
"code": "required",
"message": "この項目は必須です。"
}
]
}
}{
"error": {
"code": "validation_error",
"message": "リクエストの検証に失敗しました。",
"fields": [
{
"name": "properties.name",
"code": "required",
"message": "この項目は必須です。"
}
]
}
}録画を予約(録画 ON)
予定に録画 Bot を予約する。画面の「予約録画」トグルを ON にするのと同じ。
- 同じ会議(
meeting_keyが同じ)を他のユーザーが予約済みなら、Bot は 1 体に集約される - 会議が進行中なら、Bot はすぐに入室する
- 終了した会議(
reason: meeting_ended)、キャンセルされた予定(reason: event_cancelled)は 予約できない(409 invalid_state) - 録音の所有者は予定の持ち主(
owner_id)。その人の文字起こし利用枠で判定する - 予約済みの予定に再送しても
200で現在の状態を返す(二重予約にならない) - 開始の 10 分前までの予約を推奨する。直前の予約は入室が遅れることがある
本文の deal_linking を送ると、予約と同時に取引の事前設定を行う
(PATCH .../deal-linking/ を別に呼ぶ必要がない)。
curl --request POST \
--url https://api.strixai.jp/v1/calendar-events/{record_id}/recording/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"deal_linking": {
"deal_id": "Rb7XkQpYz3Lh9vMs2N",
"genre": "初回商談"
}
}
'import requests
url = "https://api.strixai.jp/v1/calendar-events/{record_id}/recording/"
payload = { "deal_linking": {
"deal_id": "Rb7XkQpYz3Lh9vMs2N",
"genre": "初回商談"
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({deal_linking: {deal_id: 'Rb7XkQpYz3Lh9vMs2N', genre: '初回商談'}})
};
fetch('https://api.strixai.jp/v1/calendar-events/{record_id}/recording/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.strixai.jp/v1/calendar-events/{record_id}/recording/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'deal_linking' => [
'deal_id' => 'Rb7XkQpYz3Lh9vMs2N',
'genre' => '初回商談'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.strixai.jp/v1/calendar-events/{record_id}/recording/"
payload := strings.NewReader("{\n \"deal_linking\": {\n \"deal_id\": \"Rb7XkQpYz3Lh9vMs2N\",\n \"genre\": \"初回商談\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.strixai.jp/v1/calendar-events/{record_id}/recording/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"deal_linking\": {\n \"deal_id\": \"Rb7XkQpYz3Lh9vMs2N\",\n \"genre\": \"初回商談\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.strixai.jp/v1/calendar-events/{record_id}/recording/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"deal_linking\": {\n \"deal_id\": \"Rb7XkQpYz3Lh9vMs2N\",\n \"genre\": \"初回商談\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "Ce7XkQpYz3Lh9vMs2N",
"title": "株式会社サンプル 定例",
"start_time": "2026-10-03T00:30:00Z",
"end_time": "2026-10-03T01:30:00Z",
"status": "active",
"meeting_url": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_sample",
"meeting_platform": "microsoft_teams",
"meeting_key": "mk_5c1f0d8e2a7b4c9d8e7f6a5b4c3d2e1f",
"owner_id": "Us7XkQpYz3Lh9vMs2N",
"organizer_email": "yamada@example.co.jp",
"ical_uid": "040000008200E00074C5B7101A82E0080000000000000000000000000000000",
"is_recurring": false,
"recording": {
"state": "scheduled",
"scheduled_by": "manual",
"meeting_record_id": "Mr7XkQpYz3Lh9vMs2N",
"is_representative": true
},
"deal_linking": {
"deal_id": "Rb7XkQpYz3Lh9vMs2N",
"genre": "初回商談",
"assignee_ids": [
"Ub3MqTzW5Ly8Nc1KsP"
],
"participants": "先方 佐藤様"
},
"created_at": "2026-09-28T02:00:00Z",
"updated_at": "2026-09-28T02:05:00Z"
}{
"error": {
"code": "validation_error",
"message": "リクエストの検証に失敗しました。",
"fields": [
{
"name": "properties.name",
"code": "required",
"message": "この項目は必須です。"
}
]
}
}{
"error": {
"code": "validation_error",
"message": "リクエストの検証に失敗しました。",
"fields": [
{
"name": "properties.name",
"code": "required",
"message": "この項目は必須です。"
}
]
}
}{
"error": {
"code": "quota_exceeded",
"message": "今月の文字起こし利用上限に達しています。"
}
}{
"error": {
"code": "validation_error",
"message": "リクエストの検証に失敗しました。",
"fields": [
{
"name": "properties.name",
"code": "required",
"message": "この項目は必須です。"
}
]
}
}{
"error": {
"code": "invalid_state",
"reason": "meeting_ended",
"message": "終了した会議には予約できません"
}
}{
"error": {
"code": "validation_error",
"message": "リクエストの検証に失敗しました。",
"fields": [
{
"name": "properties.name",
"code": "required",
"message": "この項目は必須です。"
}
]
}
}{
"error": {
"code": "validation_error",
"message": "リクエストの検証に失敗しました。",
"fields": [
{
"name": "properties.name",
"code": "required",
"message": "この項目は必須です。"
}
]
}
}承認
ボディ
本文は省略可。deal_linking を送ると、予約と同時に取引の事前設定を行う
取引の事前設定の入力。送ったキーだけを更新する。null(配列は [])を送ると解除する。
genre は properties/ の options[].value と完全一致で指定する(ラベルの曖昧一致はしない)。
deal_id と genre はセットで設定する。送った値を現在の設定に重ねた結果、どちらか一方だけになる場合は
400 になる(取引の自動紐付けは、取引とジャンルがそろったときだけ商談ログを作るため)。
assignee_ids は GET /v1/users/ の record_id で指定する。指定できるのは組織の有効なメンバーだけで、
読み取りで返る assignee_ids には退会したメンバーも含まれる。読んだ値をそのまま送ると、
退会者が含まれる場合は 400 になる。
Show child attributes
Show child attributes
{
"deal_id": "Rb7XkQpYz3Lh9vMs2N",
"genre": "初回商談",
"assignee_ids": ["Ub3MqTzW5Ly8Nc1KsP"]
}
レスポンス
予約済み(新規・既存とも)
連携カレンダーの予定 1 件。予定は持ち主ごとに別レコードになるため、同じ会議に
Stockwork ユーザーが複数参加していると、同じ会議が複数の予定として現れる。
同じ会議かどうかは meeting_key で判別する。
API キーに返るのは会議 URL があり、非公開でない予定だけ。予定が後から非公開に
変更された場合は、一覧から消え、単体取得も 404 になる(差分同期では検知できないため、
保持している予定を取得して 404 なら対象外になったと扱う)。