> ## Documentation Index > Fetch the complete documentation index at: https://docs.tightknit.ai/llms.txt > Use this file to discover all available pages before exploring further. # Set a post’s notice > Sets or removes the notice shown above a post on the community site: a note that the thread is out of date, where the current answer lives, or anything readers should know first. The post’s own content is unchanged. Only a post carries a notice; a comment is a 404. A notice that breaks the rules on `notice` is a 400. ## OpenAPI ````yaml /openapi-v1.json post /v1/messages/{message_id}/notice openapi: 3.1.0 info: title: Tightknit Admin API version: 1.0.0 description: Administrative access to a Tightknit community. servers: - url: https://api.tightknit.ai security: - Bearer: [] tags: - name: API keys description: Inspect the key a request authenticated with. - name: Awards description: Badges and certificates a community grants its members. - name: Events description: Read, create, update and delete events on the community calendar. - name: Journeys description: Read multi-step member programs and their milestones. - name: Tags description: The labels that classify events and content resources. - name: Groups description: The segments a community sorts its members into. - name: Content description: >- The collections a community files its content under, and the links and events in them. - name: Feeds description: The Slack channels and site-only spaces a community posts in. - name: Files description: Images and documents a community has uploaded. - name: Messages description: What a community has published. - name: Members description: The people in a community. - name: Slack messages description: >- Messages sent to Slack. Sending is the only operation: they cannot be read, edited or deleted here. - name: Compositions description: >- Message Blaster drafts: messages saved in Studio before, and kept after, they are sent to Slack channels and members. An API key sees only the compositions shared with every Studio user. - name: Follows description: What a member follows. - name: Polls description: The questions a community puts to its members in Slack. - name: Activity logs description: What members did in the community, and when. - name: System description: Service health. paths: /v1/messages/{message_id}/notice: post: tags: - Messages summary: Set a post’s notice description: >- Sets or removes the notice shown above a post on the community site: a note that the thread is out of date, where the current answer lives, or anything readers should know first. The post’s own content is unchanged. Only a post carries a notice; a comment is a 404. A notice that breaks the rules on `notice` is a 400. operationId: setMessageNotice parameters: - schema: type: string pattern: ^msg_[a-zA-Z0-9]{12}$ description: The message's id. required: true description: The message's id. name: message_id in: path requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MessageNoticeSet' responses: '200': description: Success headers: Request-Id: description: Identifier for this request, quote it in support tickets. schema: type: string content: application/json: schema: $ref: '#/components/schemas/Message' default: description: Error headers: Request-Id: description: Identifier for this request, quote it in support tickets. schema: type: string content: application/problem+json: schema: $ref: '#/components/schemas/Problem' security: - Bearer: [] components: schemas: MessageNoticeSet: type: object properties: notice: type: - string - 'null' minLength: 1 maxLength: 8000 description: >- The notice as markdown: `[label](https://…)` adds a link, and `**bold**`, `_italic_` and `~~strike~~` format it. Paragraphs, links and emoji only; lists, headings and quotes are refused. At most 1000 visible characters, counting a link's label, not its URL. `null` removes it. example: >- This thread is out of date. See [the current guide](https://help.example.com/export). required: - notice additionalProperties: false Message: type: object properties: object: type: string enum: - message description: Always `message`. id: type: string description: Unique identifier for the object. example: msg_9f2b8c1d4e5a created_at: type: string format: date-time description: When it was written, Slack’s own time for a Slack message. updated_at: type: string format: date-time description: When the object was last changed. type: type: string enum: - post - comment description: |- What kind of message it is. One of: - `post`: opens a thread. - `comment`: replies to a post. feed_id: anyOf: - type: string - type: 'null' description: >- The id of the feed the message was posted in. Null when it belongs to no feed. example: feed_7m3x9k4t8plz parent_message_id: anyOf: - type: string - type: 'null' description: >- The post this comment replies to. Null for a post, and for a comment whose post was deleted; `type` tells them apart. example: msg_9f2b8c1d4e5a title: anyOf: - type: string - type: 'null' description: >- The post title. Null on a comment, and on a post stored from Slack until its first publish. slug: anyOf: - type: string - type: 'null' description: >- The URL segment of the post’s page. Null on a comment, and on a post stored from Slack until its first publish. description: anyOf: - type: string - type: 'null' description: >- A short summary of the post, used in search results and link previews. Null on a comment, and on a post with no summary: one stored from Slack gets a generated one on publish only when its feed has `ai_titles_enabled` on. body: type: string description: The plaintext rendering of the body. notice: anyOf: - type: string - type: 'null' description: >- The plaintext rendering of the notice an admin shows above the post on the community site. Null on a comment, and on a post with none. Set it with `POST /v1/messages/{message_id}/notice`. example: This thread is out of date. See the current guide. cover_image_file_id: anyOf: - type: string - type: 'null' description: >- The id of the image shown as the post’s cover. Null when it has none. example: file_2b3c4d5e6f7g author_profile_id: anyOf: - type: string - type: 'null' description: Null when the author was forgotten. example: prof_9f2b8c1d4e5a source: type: string enum: - site - slack description: |- Where it was written. One of: - `site`: on the community site. - `slack`: in a synced channel. example: slack is_published: type: boolean description: Whether members see it on the community site. first_published_at: anyOf: - type: string format: date-time - type: 'null' description: >- When it was first published to the community site. Null for one that never was. edited_at: anyOf: - type: string format: date-time - type: 'null' description: When the message was last edited. Null for one never edited. latest_activity_at: anyOf: - type: string format: date-time - type: 'null' description: >- The latest activity on the thread, the post or any of its comments. Null on a comment. integrations: type: object properties: slack: type: - object - 'null' properties: channel_id: type: string description: Slack’s id for the channel the message is in. example: C01ABC123 ts: type: string description: >- Slack’s timestamp for the message, which identifies it within its channel. example: '1788879207.324959' permalink: anyOf: - type: string - type: 'null' description: A link to the message in Slack. Null when it is not known. required: - channel_id - ts - permalink description: >- The Slack message behind it. Null for one that was never in Slack. required: - slack description: Where the message connects to other platforms. author: anyOf: - $ref: '#/components/schemas/Profile' - type: 'null' description: The author’s profile. Present only when `author` is expanded. feed: anyOf: - $ref: '#/components/schemas/Feed' - type: 'null' description: The feed. Present only when `feed` is expanded. cover_image_file: anyOf: - $ref: '#/components/schemas/File' - type: 'null' description: The cover image. Present only when `cover_image_file` is expanded. parent_message: anyOf: - $ref: '#/components/schemas/ParentMessage' - type: 'null' description: >- The post a comment replies to. Present only when `parent_message` is expanded. required: - object - id - created_at - updated_at - type - feed_id - parent_message_id - title - slug - description - body - notice - cover_image_file_id - author_profile_id - source - is_published - first_published_at - edited_at - latest_activity_at - integrations Problem: type: object properties: type: type: string description: A URI naming the problem type. Always `about:blank`. example: about:blank title: type: string description: A short summary of the HTTP status. example: Not found status: type: integer description: The HTTP status code. example: 404 detail: type: string description: What went wrong with this request, when there is more to say. code: type: string description: >- A stable, machine-readable error code to branch on, unlike `title` and `detail`. example: not_found param: type: string description: The request field or parameter the error is about, when one is. request_id: type: string description: >- The id of the request, also sent as the `Request-Id` header. Quote it in support tickets. example: req_9f2b8c1d4e5a6b7c8d9e0f1a2b3c4d5e required: - type - title - status - code Profile: type: object properties: object: type: string enum: - profile description: Always `profile`. id: type: string description: Unique identifier for the object. example: prof_9f2b8c1d4e5a created_at: type: string format: date-time description: When the object was created. updated_at: type: string format: date-time description: When the object was last changed. name: anyOf: - type: string - type: 'null' description: >- The name the community shows for the member. With a linked Slack profile it follows the community’s name preference, or reads `🔒[private profile]` when `opt_out_of_public_profile` is true; without one it is `display_name`, falling back to `full_name`. example: Ada Lovelace full_name: type: string description: The member’s full name. Always set. example: Ada Lovelace display_name: anyOf: - type: string - type: 'null' description: >- The shorter name the member goes by, when they set one. Null otherwise. first_name: anyOf: - type: string - type: 'null' description: The member’s first name, when known. last_name: anyOf: - type: string - type: 'null' description: The member’s last name, when known. avatar_url: anyOf: - type: string - type: 'null' description: >- The URL of the member’s avatar, from their Slack profile when one is linked. Null when they have none, or when a member with a linked Slack profile has `opt_out_of_public_profile` on. email: anyOf: - type: string - type: 'null' description: The member’s email address. Null when it is not known. example: ada@example.com email_domain: anyOf: - type: string - type: 'null' description: The lowercased domain of `email`, maintained by the database. example: example.com locale: anyOf: - type: string - type: 'null' description: The member’s language and region, such as `en-US`, when known. is_team_member: type: boolean description: >- Whether the member is staff of the community rather than one of its people. is_deactivated: type: boolean description: Whether the member has been deactivated in the community. opt_out_of_public_profile: type: boolean description: >- Whether the member asked to be left out of the public member directory. member_since: anyOf: - type: string format: date-time - type: 'null' description: >- When the member joined the community: their first site sign-in or Slack join. Null while they are invited and have not joined yet. invited_at: anyOf: - type: string format: date-time - type: 'null' description: >- When an admin added the member before they joined (Studio, Admin API, MCP or CSV import), whether or not an invitation was sent. Kept after they join; null for members never added this way. signed_up_at: anyOf: - type: string format: date-time - type: 'null' description: >- When the member first signed in to the community site. Unlike `member_since`, a Slack join never sets it. Null for members who have never signed in. source: type: string enum: - slack_sync - import - api - studio_signin - sso_signin - legacy - unknown description: >- How the profile was created. A Slack invitee who had not joined yet takes `api` or `import` when an admin then adds them. One of: - `slack_sync`: from Slack, through the member roster sync or the member joining or acting in the workspace. - `import`: from an admin’s bulk member import. - `api`: from the Admin API, Studio’s add-member form or the MCP server. - `studio_signin`: on an admin’s first Studio sign-in. - `sso_signin`: on a member’s first single sign-on (SSO) sign-in, where the site creates accounts automatically. - `legacy`: created before the origin was recorded. - `unknown`: created before the origin was recorded and before its Slack link, with no way left to tell how. example: slack_sync has_account: type: boolean description: >- Whether the member has a sign-in account. False for a Slack identity nobody has claimed. flair_group_id: anyOf: - type: string - type: 'null' description: The group whose flair the member shows beside their name. example: grup_7m3x9k4t8plz slack_profile_id: anyOf: - type: string - type: 'null' description: >- Slack’s id for the member’s linked Slack profile. Null when the member has no Slack identity. example: U0BRY4S6LNQ integrations: type: object properties: slack: type: object properties: profile: anyOf: - $ref: '#/components/schemas/SlackProfile' - type: 'null' description: The linked Slack profile, or null when the member has none. required: - profile description: The member’s Slack identity. required: - slack description: >- Where the member connects to other platforms. Present only when `slack_profile` is expanded. required: - object - id - created_at - updated_at - name - full_name - display_name - first_name - last_name - avatar_url - email - email_domain - locale - is_team_member - is_deactivated - opt_out_of_public_profile - member_since - invited_at - signed_up_at - source - has_account - flair_group_id - slack_profile_id Feed: type: object properties: object: type: string enum: - feed description: Always `feed`. id: type: string description: Unique identifier for the object. example: feed_4h2o89z6qlpw created_at: type: string format: date-time description: When the object was created. updated_at: type: string format: date-time description: When the object was last changed. label: type: string description: The feed’s name, as the community site shows it. slug: type: string description: The feed’s path segment in community site URLs. example: product-updates emoji_icon: type: - string - 'null' description: >- The emoji shown beside the feed’s name in the site navigation. Null shows the default icon. visibility: type: string enum: - disabled - public - authenticated - feed_members description: >- Who may read the feed on the community site. One of: - `disabled`: nobody, the feed is not on the site. - `public`: anyone, including anonymous visitors unless the site requires sign-in. - `authenticated`: any signed-in member. - `feed_members`: only the feed’s own members. is_archived: type: boolean description: Whether the feed is archived. is_unlisted: type: boolean description: >- Whether the feed is hidden from search engines, sitemaps and feed listings. It stays reachable by direct link. show_in_navigation_menu: type: boolean description: Whether the feed appears in the community site’s navigation menus. allow_site_posting: type: boolean description: >- Whether signed-in members may create posts and comments in the feed from the community site. selected_answers_enabled: type: boolean description: >- Whether a thread’s author or an admin may mark replies in the feed as answers. show_pinned_posts: type: boolean description: >- Whether the feed page shows a carousel of pinned posts above its post list. list_view_display_format: type: string enum: - card - snippet - compact - changelog description: >- How the feed’s post list is shown on the community site by default. One of: - `card`: a cover image, title, author and date per post. - `snippet`: the start of each post’s body and its attachments. - `compact`: titles and activity stats only. - `changelog`: a timeline grouped by date, each entry with its full body. post_detail_display_format: type: string enum: - discussion - blog description: |- How a post’s own page is laid out on the community site. One of: - `discussion`: suited to chats, FAQs and threaded discussions. - `blog`: puts the post’s cover image front and center. ai_titles_enabled: type: boolean description: >- Whether posts synced to the feed get an AI-generated title, URL slug and description. ai_post_title_prompt: type: - string - 'null' description: >- Admin guidance on how AI-generated post titles should read. Null uses the default voice. Applied only on plans with custom AI prompts. ai_post_description_prompt: type: - string - 'null' description: >- Admin guidance on how the AI-generated search description of each post should read. Null uses the default voice. Applied only on plans with custom AI prompts. created_by_id: type: - string - 'null' description: >- The id of the profile that created the feed. Null when no member created it. example: prof_5Yq7tVz2Hm3n created_by: anyOf: - $ref: '#/components/schemas/Profile' - type: 'null' description: >- The profile that created the feed. Present only when `created_by` is expanded. banner_file_id: type: - string - 'null' description: >- The id of the image shown at the top of the feed page. Null when the feed has no banner. example: file_2b3c4d5e6f7g banner_file: anyOf: - $ref: '#/components/schemas/File' - type: 'null' description: >- The feed’s banner image. Present only when `banner_file` is expanded. integrations: type: object properties: slack: type: - object - 'null' properties: channel_id: type: string description: Slack’s id for the channel behind the feed. example: C01ABC123 stores_new_messages: type: boolean description: >- Whether incoming Slack messages are stored. It mirrors the channel being activated for Tightknit, and archiving the feed does not close it. sync_all_incoming_messages: type: boolean description: >- Whether every stored message becomes a post, rather than only the ones promoted by hand. post_sync_reminder_enabled: type: boolean description: >- Whether a synced post gets a reply in its Slack thread linking to the post and noting that further replies sync to the site. channel: anyOf: - $ref: '#/components/schemas/SlackChannel' - type: 'null' description: >- The Slack channel. Present only when `slack_channel` is expanded. required: - channel_id - stores_new_messages - sync_all_incoming_messages - post_sync_reminder_enabled description: >- The Slack channel behind the feed, and the settings that only apply to one. Null for a standalone feed, which has no channel. required: - slack description: Where the feed connects to other platforms. required: - object - id - created_at - updated_at - label - slug - emoji_icon - visibility - is_archived - is_unlisted - show_in_navigation_menu - allow_site_posting - selected_answers_enabled - show_pinned_posts - list_view_display_format - post_detail_display_format - ai_titles_enabled - ai_post_title_prompt - ai_post_description_prompt - created_by_id - banner_file_id - integrations File: type: object properties: object: type: string enum: - file description: Always `file`. id: type: string description: Unique identifier for the object. example: file_2b3c4d5e6f7g name: type: string description: The file’s stored name, including its extension. example: cover.png title: type: - string - 'null' description: >- Alt text or a short description of the file. An upload without one takes the filename. Null when none was recorded. mimetype: type: string description: The file’s media type. example: image/png size: type: integer minimum: 0 description: The file’s size in bytes. url: type: string description: Where to download the file. thumbnail_url: type: - string - 'null' description: A smaller preview of the file. Null when it has none. created_at: type: string format: date-time description: When the file was stored. required: - object - id - name - title - mimetype - size - url - thumbnail_url - created_at description: A file the community stored, uploaded or generated. ParentMessage: type: object properties: object: type: string enum: - message description: Always `message`. id: type: string description: Unique identifier for the object. example: msg_9f2b8c1d4e5a created_at: type: string format: date-time description: When it was written, Slack’s own time for a Slack message. updated_at: type: string format: date-time description: When the object was last changed. type: type: string enum: - post - comment description: |- What kind of message it is. One of: - `post`: opens a thread. - `comment`: replies to a post. feed_id: anyOf: - type: string - type: 'null' description: >- The id of the feed the message was posted in. Null when it belongs to no feed. example: feed_7m3x9k4t8plz parent_message_id: anyOf: - type: string - type: 'null' description: >- The post this comment replies to. Null for a post, and for a comment whose post was deleted; `type` tells them apart. example: msg_9f2b8c1d4e5a title: anyOf: - type: string - type: 'null' description: >- The post title. Null on a comment, and on a post stored from Slack until its first publish. slug: anyOf: - type: string - type: 'null' description: >- The URL segment of the post’s page. Null on a comment, and on a post stored from Slack until its first publish. description: anyOf: - type: string - type: 'null' description: >- A short summary of the post, used in search results and link previews. Null on a comment, and on a post with no summary: one stored from Slack gets a generated one on publish only when its feed has `ai_titles_enabled` on. body: type: string description: The plaintext rendering of the body. notice: anyOf: - type: string - type: 'null' description: >- The plaintext rendering of the notice an admin shows above the post on the community site. Null on a comment, and on a post with none. Set it with `POST /v1/messages/{message_id}/notice`. example: This thread is out of date. See the current guide. cover_image_file_id: anyOf: - type: string - type: 'null' description: >- The id of the image shown as the post’s cover. Null when it has none. example: file_2b3c4d5e6f7g author_profile_id: anyOf: - type: string - type: 'null' description: Null when the author was forgotten. example: prof_9f2b8c1d4e5a source: type: string enum: - site - slack description: |- Where it was written. One of: - `site`: on the community site. - `slack`: in a synced channel. example: slack is_published: type: boolean description: Whether members see it on the community site. first_published_at: anyOf: - type: string format: date-time - type: 'null' description: >- When it was first published to the community site. Null for one that never was. edited_at: anyOf: - type: string format: date-time - type: 'null' description: When the message was last edited. Null for one never edited. latest_activity_at: anyOf: - type: string format: date-time - type: 'null' description: >- The latest activity on the thread, the post or any of its comments. Null on a comment. integrations: type: object properties: slack: type: - object - 'null' properties: channel_id: type: string description: Slack’s id for the channel the message is in. example: C01ABC123 ts: type: string description: >- Slack’s timestamp for the message, which identifies it within its channel. example: '1788879207.324959' permalink: anyOf: - type: string - type: 'null' description: A link to the message in Slack. Null when it is not known. required: - channel_id - ts - permalink description: >- The Slack message behind it. Null for one that was never in Slack. required: - slack description: Where the message connects to other platforms. required: - object - id - created_at - updated_at - type - feed_id - parent_message_id - title - slug - description - body - notice - cover_image_file_id - author_profile_id - source - is_published - first_published_at - edited_at - latest_activity_at - integrations SlackProfile: type: object properties: object: type: string enum: - slack_profile description: Always `slack_profile`. id: type: string description: Slack’s id for the member. example: U0BRY4S6LNQ created_at: type: string format: date-time description: When the object was created. updated_at: type: string format: date-time description: When the object was last changed. workspace_id: type: string description: Slack’s id for the workspace the member belongs to. example: T01ABC123 display_name: anyOf: - type: string - type: 'null' description: >- The display name the member set in Slack. Empty or null when they set none. real_name: anyOf: - type: string - type: 'null' description: The member’s full name in Slack. Null when Slack has none. email: anyOf: - type: string - type: 'null' description: >- The email address on the Slack account. Null when Slack does not share it, as for bots. example: ada@example.com pronouns: anyOf: - type: string - type: 'null' description: >- The pronouns the member set in Slack. Empty or null when they set none. avatar_url: anyOf: - type: string - type: 'null' description: The URL of the member’s Slack avatar. Null when Slack has none. locale: anyOf: - type: string - type: 'null' description: The member’s Slack language and region, such as `en-US`, when known. tz: anyOf: - type: string - type: 'null' description: >- The member’s time zone in Slack, as an IANA name such as `America/New_York`, when known. is_bot: type: boolean description: Whether the account is a bot rather than a person. is_app_user: type: boolean description: >- Whether Slack reports the member as an authorized user of the Tightknit app. is_workflow_bot: type: boolean description: Whether the account is the bot behind a Slack workflow. is_admin: type: boolean description: Whether the member is an admin of the Slack workspace. is_owner: type: boolean description: Whether the member is an owner of the Slack workspace. is_restricted: type: boolean description: >- Whether the member is a Slack guest, limited to the channels they were invited to. is_invited_user: type: boolean description: Whether the member holds nothing but a still-open Slack invitation. is_deleted: type: boolean description: Whether Slack deactivated the account. required: - object - id - created_at - updated_at - workspace_id - display_name - real_name - email - pronouns - avatar_url - locale - tz - is_bot - is_app_user - is_workflow_bot - is_admin - is_owner - is_restricted - is_invited_user - is_deleted SlackChannel: type: object properties: object: type: string enum: - slack_channel description: Always `slack_channel`. id: type: string description: Slack’s id for the channel. example: C01ABC123 name: type: - string - 'null' description: >- The channel’s name in Slack, without the `#`. Null when it is not known. is_private: type: - boolean - 'null' description: Whether the channel is private in Slack. Null when it is not known. is_archived: type: - boolean - 'null' description: Whether the channel is archived in Slack. Null when it is not known. required: - object - id - name - is_private - is_archived securitySchemes: Bearer: type: http scheme: bearer bearerFormat: Tightknit API key description: 'A Tightknit admin API key, sent as `Authorization: Bearer `.' ```` ## Related topics - [MCP Server](https://docs.tightknit.ai/integrations/mcp.md) - [Delete a Post or Comment](https://docs.tightknit.ai/slack/posts-and-comments/delete-post-or-comment.md) - [AI & Agent Settings](https://docs.tightknit.ai/channels-and-feeds/agent-settings.md) - [Create Channels and Feeds](https://docs.tightknit.ai/guides/create-your-core-channels.md) - [Getting Started with Tags](https://docs.tightknit.ai/tags/getting-started.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.