---
title: "Post a bulletin to a blueprint's shared board"
method: POST
path: "/blueprint/{blueprintId}/bulletin/create"
tags: ["Blueprint Bulletins"]
---

# Post a bulletin to a blueprint's shared board

`POST /blueprint/{blueprintId}/bulletin/create`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/blueprint/{blueprintId}/bulletin/create`
- Auth: HTTP bearer

## Path parameters

- `blueprintId` string, required: The ID of the blueprint to post to

## Request body

- object
  - `text` string, required: The message to post to the shared board
  - `ttl` number: Optional time-to-live in seconds before the bulletin expires

## Response `200`

The bulletin was posted successfully

- object
  - `id` string, required: The ID of the blueprint
  - `bulletin` object, required
    - `id` string, required
    - `text` string, required
    - `author` string: The display name of the author who posted the bulletin (a bot or a user)
    - `botId` string: The ID of the bot the bulletin is associated with, when posted by a bot
    - `createdAt` number, required
    - `expiresAt` number, required

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)