kintone APIドキュメント

スペースのスレッドを作成する

目次

スペースのスレッドを作成する

固定リンクがコピーされました

スペースのスレッドを作成します。

  • スレッドを作成できるのは、スペースの設定で「スペースのポータルと複数のスレッドを使用する」が有効になっているスペースだけです。
  • スレッド作成の通知は、「すべて」の通知として、スペースの参加メンバーに通知されます。
  • スペース機能を利用していない場合には、エラーが発生します。
  • ゲストスペース機能が無効の場合に、ゲストスペースのスレッドを作成しようとするとエラーが発生します。

URL

固定リンクがコピーされました

通常のスペース
https://sample.cybozu.com/k/v1/space/thread.json
ゲストスペース
https://sample.cybozu.com/k/guest/ゲストスペースID/v1/space/thread.json

HTTP メソッド

固定リンクがコピーされました

POST

必要なアクセス権

固定リンクがコピーされました

  • スペースの閲覧権限
    非公開スペース／ゲストスペースの場合、スペース参加者のみ実行可能です。

リクエスト

固定リンクがコピーされました

パラメーター
パラメーター名 型 必須 説明
space 数値または文字列 必須 スペースID
name 文字列 必須 スレッド名
1文字から128文字まで指定できます。
リクエストの例
ヘッダー
1
2
3
4

{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU=",
  "Content-Type": "application/json"
}

リクエストヘッダーの詳細は次のページを参照してください。
kintone REST APIの共通仕様

ボディ
1
2
3
4

{
  "space": 1,
  "name": "サンプルスレッド"
}

レスポンス

固定リンクがコピーされました

プロパティ
プロパティ名 型 説明
id 文字列 作成されたスレッドのID
レスポンスの例
1
2
3

{
  "id": "2"
}

サンプルコード

固定リンクがコピーされました

curlを使ったリクエスト
1
2
3
4
5
6
7

curl -X POST 'https://sample.cybozu.com/k/v1/space/thread.json' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -H 'Content-Type: application/json' \
  -d '{
    "space": 1,
    "name": "サンプルスレッド"
  }'
kintone.api()を使ったリクエスト

kintone.api()の詳細は、次のページを参照してください。
kintone REST APIリクエストを送信するAPI

1
2
3
4
5

const body = {
  space: 1,
  name: 'サンプルスレッド'
};
await kintone.api(kintone.api.url('/k/v1/space/thread.json', true), 'POST', body);