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

目次

caution
警告

このページで説明しているAPIは、開発を検討中のAPIです。

アップデートオプション内の「開発中の新機能」から動作をお試しいただけます。 設定方法は、 新機能の有効/無効の切り替え手順 (External link) を参照してください。

APIに関するフィードバックを、ユースケースとともに、 kintone の改善に協力する (External link) フォームへぜひご登録ください。

フィードバックの例
  • APIラボで提供されているAPIを早く本番環境で利用したい
  • こういう用途で使うために、このような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 文字まで指定できます。
information

スレッド本文の対応は検討中です。

リクエストの例
ヘッダー
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"
}