掲示を書き込む

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

掲示を書き込む（2026年5月10日の定期メンテナンス後より適用されます）

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

掲示を書き込みます。

URL

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

https://sample.cybozu.com/g/api/v1/bulletin/topics

HTTPメソッド

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

POST

利用できるバージョン

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

クラウド版Garoon

リクエスト

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

パラメーター

パラメーター名	型	必須	説明
categoryId	数値または文字列	必須	掲示を書き込むカテゴリーのID `categoryId`と`subject`の両方が未指定の場合、`categoryId`が必須であることを示すエラーが発生します。
subject	文字列	省略可	掲示のタイトル
manuallySender	文字列	省略可	手動で入力する差出人名「差出人名を手動で入力する」設定がOFFの場合にこのパラメーターを指定すると、エラーが発生します。 `manuallySender`と`creatorGroupId`の両方を指定するとエラーが発生します。
creatorGroupId	数値または文字列	省略可	作成者が所属する組織のID
acknowledgement	真偽値	省略可	閲覧状況の確認を要求するかどうか `true`：閲覧状況の確認を要求する `false`：閲覧状況の確認を要求しない省略すると、「アプリケーション設定 > 掲示板 > 一般設定」の「閲覧状況」の設定に従います。閲覧状況の確認を`true`に設定するには、指定したカテゴリーに通知先が設定されている必要があります。
allowComments	真偽値	省略可	コメントの書き込みを許可するかどうか `true`：コメントの書き込みを許可する `false`：コメントの書き込みを許可しない省略すると、「アプリケーション設定 > 掲示板 > 一般設定」の「コメント」の設定に従います。
body	文字列	省略可	掲示の本文
isHtmlBody	真偽値	省略可	本文を書式編集（HTML形式）で保存するかどうか `true`：HTML形式 `false`：プレーンテキスト省略すると`false`が設定されます。 `true`を指定し、`body`が未指定または空文字列、または空白のみの文字列の場合、レスポンスの`isHtmlBody`は`true`になり、`body`は`<div></div>`で囲まれます。「書式編集を許可する」設定がOFFの場合にこのパラメーターを指定すると、エラーが発生します。
mentions	配列	省略可	掲示内でメンションするユーザー、組織（グループ）、または静的ロールのリスト掲示のカテゴリーを閲覧できないユーザーを含む`mentions`では掲示を書き込めません。 `mentions`が空の配列またはnull値の場合、ユーザー、組織（グループ）、または静的ロールをメンションせずに掲示が書き込まれます。
mentions[].id	数値または文字列	必須（mentions指定時）	メンションするユーザー/組織（グループ）/静的ロールのID
mentions[].type	文字列	必須（mentions指定時）	メンションのタイプ `USER`、`GROUP`、`STATIC_ROLE`のいずれか
operatorType	文字列	省略可	掲示の変更/削除が可能なユーザーのタイプ `ONLY_SENDER`：差出人のみ `SELECT_USERS`：指定したユーザー省略すると`ONLY_SENDER`が設定されます。 `ONLY_SENDER`を指定した場合、`operators`を指定しても無視されます。 `SELECT_USERS`を指定して`operators`を指定しない場合、`ONLY_SENDER`として掲示が書き込まれます。
operators	配列	省略可	掲示の変更/削除が可能なユーザーのリスト
operators[].id	数値または文字列	省略可	操作権限をもつユーザーのGaroonユーザーID `operators`を指定する場合、`operators[].id`または`operators[].code`のいずれかが必須です。
operators[].code	文字列	省略可	操作権限をもつユーザーのログイン名 `operators`を指定する場合、`operators[].id`または`operators[].code`のいずれかが必須です。 `operators[].id`と`operators[].code`の両方を指定した場合、`operators[].id`の値が使用されます。
attachments	配列	省略可	掲示の添付ファイルのリスト
attachments[].name	文字列	必須（attachments指定時）	ファイル名
attachments[].content	文字列	必須（attachments指定時）	ファイルの内容（Base64エンコードが必要）
publicPeriod	オブジェクト	省略可	掲示期間の情報省略すると、掲示期間なしで掲示が書き込まれます。
publicPeriod.isUnlimited	真偽値	省略可	掲示期間を無制限にするかどうか `true`：掲示期間を無制限にする `false`：掲示期間を指定する（ただし、`start`と`end`の両方が未指定の場合は無制限になります）
publicPeriod.start	文字列	省略可	掲示開始日時（ISO 8601形式） isUnlimitedがfalseで未指定の場合、API実行ユーザーのタイムゾーンで作成日の00:00が自動設定されます。
publicPeriod.end	文字列	省略可	掲示終了日時（ISO 8601形式）
isDraft	真偽値	省略可	下書きとして保存するかどうか `true`：下書きとして保存 `false`：掲示として保存省略すると`false`が設定されます。

リクエストの例

URL

https://sample.cybozu.com/g/api/v1/bulletin/topics

ヘッダー

1
2
3
4


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

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

ボディ

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36


{
  "categoryId": 2,
  "subject": "Development plan Q2-2026",
  "publicPeriod": {
    "isUnlimited": false,
    "start": "2026-03-10T08:00:00Z",
    "end": "2026-03-20T08:00:00Z"
  },
  "manuallySender": "Yamamoto-DevTeam",
  "body": "<div><strong>Plan</strong></div>",
  "isHtmlBody": true,
  "allowComments": true,
  "operatorType": "SELECT_USERS",
  "operators": [
    {
      "id": 2
    },
    {
      "code": "watanabe"
    }
  ],
  "acknowledgement": false,
  "attachments": [
    {
      "name": "plan.txt",
      "content": "TW9iaWxlIEZpdG5lc3MgQXBwIERldmVsb3BtZW50IFBsYW4="
    }
  ],
  "mentions": [
    {
      "id": 4,
      "type": "USER"
    }
  ],
  "isDraft": false
}

レスポンス

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

プロパティ

プロパティ名	型	説明
id	文字列	掲示のID
subject	文字列	掲示のタイトル
creator	オブジェクト	掲示の作成者情報
creator.id	文字列	作成者のGaroonユーザーID
creator.name	文字列	作成者の表示名
creator.code	文字列	作成者のログイン名
updater	オブジェクト	掲示の更新者情報
updater.id	文字列	更新者のGaroonユーザーID
updater.name	文字列	更新者の表示名
updater.code	文字列	更新者のログイン名
manuallySender	文字列	直接入力された差出人名
createdAt	文字列	作成日時
updatedAt	文字列	更新日時
acknowledgement	真偽値	閲覧状況を確認するかどうか `true`：閲覧状況を確認する `false`：閲覧状況を確認しない
allowComments	真偽値	コメントの書き込みを許可するかどうか `true`：コメントの書き込みを許可する `false`：コメントの書き込みを許可しない
body	文字列	掲示の本文
isHtmlBody	真偽値	掲示の本文がHTML形式かどうか `true`： HTML形式 `false`：プレーンテキスト
operatorType	文字列	掲示の変更/削除の許可 `ONLY_SENDER`：差出人のみ `SELECT_USERS`：許可したユーザー
operators	配列	掲示の変更/削除が可能なユーザーの一覧
operators[].id	文字列	掲示の変更/削除を許可されているGaroonユーザーID
operators[].name	文字列	掲示の変更/削除を許可されているユーザーの表示名
operators[].code	文字列	掲示の変更/削除を許可されているユーザーのログイン名
attachments	配列	添付ファイルの一覧
attachments[].id	文字列	添付ファイルのID
attachments[].name	文字列	添付ファイルの名前
attachments[].contentType	文字列	添付ファイルのコンテンツタイプ
attachments[].size	文字列	添付ファイルのサイズ
publicPeriod	オブジェクト	掲示期間の情報
publicPeriod.isUnlimited	真偽値	掲示期間が指定されているかどうか `true`：掲示期間が指定されていない `false`：掲示期間が指定されている
publicPeriod.start	文字列	掲示開始日時
publicPeriod.end	文字列	掲示終了日時
isDraft	真偽値	下書きかどうか `true`：下書き `false`：下書きではない
isPublished	真偽値	掲示開始済みかどうか `true`：掲示開始済み `false`：掲示開始済みではない
isExpired	真偽値	掲示期間切れかどうか `true`：掲示期間切れ `false`：掲示期間切れではない
category	オブジェクト	掲示が属するカテゴリー情報
category.id	文字列	カテゴリーID
category.name	文字列	カテゴリー名

レスポンスの例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54


{
  "id": "1",
  "subject": "Development plan Q2-2026",
  "category": {
    "id": "2",
    "name": "Garoon"
  },
  "publicPeriod": {
    "isUnlimited": false,
    "start": "2026-03-10T08:00:00Z",
    "end": "2026-03-20T08:00:00Z"
  },
  "createdAt": "2026-03-09T03:24:39Z",
  "creator": {
    "id": "1",
    "code": "tanaka",
    "name": "Tanaka"
  },
  "updatedAt": "2026-03-09T03:24:39Z",
  "updater": {
    "id": "1",
    "code": "tanaka",
    "name": "Tanaka"
  },
  "manuallySender": "Yamamoto-DevTeam",
  "body": "<div><strong>Plan</strong></div>",
  "isHtmlBody": true,
  "allowComments": true,
  "operatorType": "SELECT_USERS",
  "operators": [
    {
      "id": "2",
      "code": "suzuki",
      "name": "Suzuki"
    },
    {
      "id": "3",
      "code": "watanabe",
      "name": "Watanabe"
    }
  ],
  "acknowledgement": false,
  "attachments": [
    {
      "id": "1",
      "contentType": "text/plain",
      "name": "plan.txt",
      "size": "35"
    }
  ],
  "isDraft": false,
  "isPublished": false,
  "isExpired": false
}

サンプルコード

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

curlを使ったリクエスト

ご利用の環境によって、curlのフォーマットは異なる場合があります。
詳細は、次のページを参照してください。
curlコマンドでkintone REST APIを実行してみよう/3.API実行

1
2
3
4
5
6
7
8
9


curl -X POST 'https://sample.cybozu.com/g/api/v1/bulletin/topics' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -H 'Content-Type: application/json' \
  -d '{
    "categoryId": 2,
    "subject": "Development plan Q2-2026",
    "body": "Plan details",
    "isDraft": false
  }'

Garoon REST APIリクエストを送信するAPI を使ったリクエスト

1
2
3
4
5
6


await garoon.api('/api/v1/bulletin/topics', 'POST', {
  categoryId: 2,
  subject: 'Development plan Q2-2026',
  body: 'Plan details',
  isDraft: false
});

Garoon API

Garoon APIドキュメント

掲示を書き込む

目次

掲示を書き込む（2026年5月10日の定期メンテナンス後より適用されます）

URL

HTTPメソッド

利用できるバージョン

リクエスト

パラメーター

リクエストの例

URL

ヘッダー

ボディ

レスポンス

プロパティ

レスポンスの例

サンプルコード

curlを使ったリクエスト

Garoon REST APIリクエストを送信するAPI を使ったリクエスト