Unpublish a message
curl --request POST \
--url https://api.tightknit.ai/v1/messages/{message_id}/unpublish \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.tightknit.ai/v1/messages/{message_id}/unpublish"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.tightknit.ai/v1/messages/{message_id}/unpublish', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tightknit.ai/v1/messages/{message_id}/unpublish",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.tightknit.ai/v1/messages/{message_id}/unpublish"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.tightknit.ai/v1/messages/{message_id}/unpublish")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tightknit.ai/v1/messages/{message_id}/unpublish")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "message",
"id": "msg_9f2b8c1d4e5a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"type": "post",
"feed_id": "feed_7m3x9k4t8plz",
"parent_message_id": "msg_9f2b8c1d4e5a",
"title": "<string>",
"slug": "<string>",
"description": "<string>",
"body": "<string>",
"notice": "This thread is out of date. See the current guide.",
"cover_image_file_id": "file_2b3c4d5e6f7g",
"author_profile_id": "prof_9f2b8c1d4e5a",
"source": "slack",
"is_published": true,
"first_published_at": "2023-11-07T05:31:56Z",
"edited_at": "2023-11-07T05:31:56Z",
"latest_activity_at": "2023-11-07T05:31:56Z",
"integrations": {
"slack": {
"channel_id": "C01ABC123",
"ts": "1788879207.324959",
"permalink": "<string>"
}
},
"author": {
"object": "profile",
"id": "prof_9f2b8c1d4e5a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"name": "Ada Lovelace",
"full_name": "Ada Lovelace",
"display_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"avatar_url": "<string>",
"email": "[email protected]",
"email_domain": "example.com",
"locale": "<string>",
"is_team_member": true,
"is_deactivated": true,
"opt_out_of_public_profile": true,
"member_since": "2023-11-07T05:31:56Z",
"invited_at": "2023-11-07T05:31:56Z",
"signed_up_at": "2023-11-07T05:31:56Z",
"source": "slack_sync",
"has_account": true,
"flair_group_id": "grup_7m3x9k4t8plz",
"slack_profile_id": "U0BRY4S6LNQ",
"integrations": {
"slack": {
"profile": {
"object": "slack_profile",
"id": "U0BRY4S6LNQ",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"workspace_id": "T01ABC123",
"display_name": "<string>",
"real_name": "<string>",
"email": "[email protected]",
"pronouns": "<string>",
"avatar_url": "<string>",
"locale": "<string>",
"tz": "<string>",
"is_bot": true,
"is_app_user": true,
"is_workflow_bot": true,
"is_admin": true,
"is_owner": true,
"is_restricted": true,
"is_invited_user": true,
"is_deleted": true
}
}
}
},
"feed": {
"object": "feed",
"id": "feed_4h2o89z6qlpw",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"label": "<string>",
"slug": "product-updates",
"emoji_icon": "<string>",
"visibility": "disabled",
"is_archived": true,
"is_unlisted": true,
"show_in_navigation_menu": true,
"allow_site_posting": true,
"selected_answers_enabled": true,
"show_pinned_posts": true,
"list_view_display_format": "card",
"post_detail_display_format": "discussion",
"ai_titles_enabled": true,
"ai_post_title_prompt": "<string>",
"ai_post_description_prompt": "<string>",
"created_by_id": "prof_5Yq7tVz2Hm3n",
"banner_file_id": "file_2b3c4d5e6f7g",
"integrations": {
"slack": {
"channel_id": "C01ABC123",
"stores_new_messages": true,
"sync_all_incoming_messages": true,
"post_sync_reminder_enabled": true,
"channel": {
"object": "slack_channel",
"id": "C01ABC123",
"name": "<string>",
"is_private": true,
"is_archived": true
}
}
},
"created_by": {
"object": "profile",
"id": "prof_9f2b8c1d4e5a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"name": "Ada Lovelace",
"full_name": "Ada Lovelace",
"display_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"avatar_url": "<string>",
"email": "[email protected]",
"email_domain": "example.com",
"locale": "<string>",
"is_team_member": true,
"is_deactivated": true,
"opt_out_of_public_profile": true,
"member_since": "2023-11-07T05:31:56Z",
"invited_at": "2023-11-07T05:31:56Z",
"signed_up_at": "2023-11-07T05:31:56Z",
"source": "slack_sync",
"has_account": true,
"flair_group_id": "grup_7m3x9k4t8plz",
"slack_profile_id": "U0BRY4S6LNQ",
"integrations": {
"slack": {
"profile": {
"object": "slack_profile",
"id": "U0BRY4S6LNQ",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"workspace_id": "T01ABC123",
"display_name": "<string>",
"real_name": "<string>",
"email": "[email protected]",
"pronouns": "<string>",
"avatar_url": "<string>",
"locale": "<string>",
"tz": "<string>",
"is_bot": true,
"is_app_user": true,
"is_workflow_bot": true,
"is_admin": true,
"is_owner": true,
"is_restricted": true,
"is_invited_user": true,
"is_deleted": true
}
}
}
},
"banner_file": {
"object": "file",
"id": "file_2b3c4d5e6f7g",
"name": "cover.png",
"title": "<string>",
"mimetype": "image/png",
"size": 1,
"url": "<string>",
"thumbnail_url": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}
},
"cover_image_file": {
"object": "file",
"id": "file_2b3c4d5e6f7g",
"name": "cover.png",
"title": "<string>",
"mimetype": "image/png",
"size": 1,
"url": "<string>",
"thumbnail_url": "<string>",
"created_at": "2023-11-07T05:31:56Z"
},
"parent_message": {
"object": "message",
"id": "msg_9f2b8c1d4e5a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"type": "post",
"feed_id": "feed_7m3x9k4t8plz",
"parent_message_id": "msg_9f2b8c1d4e5a",
"title": "<string>",
"slug": "<string>",
"description": "<string>",
"body": "<string>",
"notice": "This thread is out of date. See the current guide.",
"cover_image_file_id": "file_2b3c4d5e6f7g",
"author_profile_id": "prof_9f2b8c1d4e5a",
"source": "slack",
"is_published": true,
"first_published_at": "2023-11-07T05:31:56Z",
"edited_at": "2023-11-07T05:31:56Z",
"latest_activity_at": "2023-11-07T05:31:56Z",
"integrations": {
"slack": {
"channel_id": "C01ABC123",
"ts": "1788879207.324959",
"permalink": "<string>"
}
}
}
}{
"type": "about:blank",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "<string>",
"param": "<string>",
"request_id": "req_9f2b8c1d4e5a6b7c8d9e0f1a2b3c4d5e"
}Messages
Unpublish a message
Takes a post or reply off the community site, keeping its title, slug and body for a later publish. Unpublishing a post also unpublishes its replies. Unpublishing a message that is not on the site changes nothing.
Unpublish a message
curl --request POST \
--url https://api.tightknit.ai/v1/messages/{message_id}/unpublish \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.tightknit.ai/v1/messages/{message_id}/unpublish"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.tightknit.ai/v1/messages/{message_id}/unpublish', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tightknit.ai/v1/messages/{message_id}/unpublish",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.tightknit.ai/v1/messages/{message_id}/unpublish"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.tightknit.ai/v1/messages/{message_id}/unpublish")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tightknit.ai/v1/messages/{message_id}/unpublish")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "message",
"id": "msg_9f2b8c1d4e5a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"type": "post",
"feed_id": "feed_7m3x9k4t8plz",
"parent_message_id": "msg_9f2b8c1d4e5a",
"title": "<string>",
"slug": "<string>",
"description": "<string>",
"body": "<string>",
"notice": "This thread is out of date. See the current guide.",
"cover_image_file_id": "file_2b3c4d5e6f7g",
"author_profile_id": "prof_9f2b8c1d4e5a",
"source": "slack",
"is_published": true,
"first_published_at": "2023-11-07T05:31:56Z",
"edited_at": "2023-11-07T05:31:56Z",
"latest_activity_at": "2023-11-07T05:31:56Z",
"integrations": {
"slack": {
"channel_id": "C01ABC123",
"ts": "1788879207.324959",
"permalink": "<string>"
}
},
"author": {
"object": "profile",
"id": "prof_9f2b8c1d4e5a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"name": "Ada Lovelace",
"full_name": "Ada Lovelace",
"display_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"avatar_url": "<string>",
"email": "[email protected]",
"email_domain": "example.com",
"locale": "<string>",
"is_team_member": true,
"is_deactivated": true,
"opt_out_of_public_profile": true,
"member_since": "2023-11-07T05:31:56Z",
"invited_at": "2023-11-07T05:31:56Z",
"signed_up_at": "2023-11-07T05:31:56Z",
"source": "slack_sync",
"has_account": true,
"flair_group_id": "grup_7m3x9k4t8plz",
"slack_profile_id": "U0BRY4S6LNQ",
"integrations": {
"slack": {
"profile": {
"object": "slack_profile",
"id": "U0BRY4S6LNQ",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"workspace_id": "T01ABC123",
"display_name": "<string>",
"real_name": "<string>",
"email": "[email protected]",
"pronouns": "<string>",
"avatar_url": "<string>",
"locale": "<string>",
"tz": "<string>",
"is_bot": true,
"is_app_user": true,
"is_workflow_bot": true,
"is_admin": true,
"is_owner": true,
"is_restricted": true,
"is_invited_user": true,
"is_deleted": true
}
}
}
},
"feed": {
"object": "feed",
"id": "feed_4h2o89z6qlpw",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"label": "<string>",
"slug": "product-updates",
"emoji_icon": "<string>",
"visibility": "disabled",
"is_archived": true,
"is_unlisted": true,
"show_in_navigation_menu": true,
"allow_site_posting": true,
"selected_answers_enabled": true,
"show_pinned_posts": true,
"list_view_display_format": "card",
"post_detail_display_format": "discussion",
"ai_titles_enabled": true,
"ai_post_title_prompt": "<string>",
"ai_post_description_prompt": "<string>",
"created_by_id": "prof_5Yq7tVz2Hm3n",
"banner_file_id": "file_2b3c4d5e6f7g",
"integrations": {
"slack": {
"channel_id": "C01ABC123",
"stores_new_messages": true,
"sync_all_incoming_messages": true,
"post_sync_reminder_enabled": true,
"channel": {
"object": "slack_channel",
"id": "C01ABC123",
"name": "<string>",
"is_private": true,
"is_archived": true
}
}
},
"created_by": {
"object": "profile",
"id": "prof_9f2b8c1d4e5a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"name": "Ada Lovelace",
"full_name": "Ada Lovelace",
"display_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"avatar_url": "<string>",
"email": "[email protected]",
"email_domain": "example.com",
"locale": "<string>",
"is_team_member": true,
"is_deactivated": true,
"opt_out_of_public_profile": true,
"member_since": "2023-11-07T05:31:56Z",
"invited_at": "2023-11-07T05:31:56Z",
"signed_up_at": "2023-11-07T05:31:56Z",
"source": "slack_sync",
"has_account": true,
"flair_group_id": "grup_7m3x9k4t8plz",
"slack_profile_id": "U0BRY4S6LNQ",
"integrations": {
"slack": {
"profile": {
"object": "slack_profile",
"id": "U0BRY4S6LNQ",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"workspace_id": "T01ABC123",
"display_name": "<string>",
"real_name": "<string>",
"email": "[email protected]",
"pronouns": "<string>",
"avatar_url": "<string>",
"locale": "<string>",
"tz": "<string>",
"is_bot": true,
"is_app_user": true,
"is_workflow_bot": true,
"is_admin": true,
"is_owner": true,
"is_restricted": true,
"is_invited_user": true,
"is_deleted": true
}
}
}
},
"banner_file": {
"object": "file",
"id": "file_2b3c4d5e6f7g",
"name": "cover.png",
"title": "<string>",
"mimetype": "image/png",
"size": 1,
"url": "<string>",
"thumbnail_url": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}
},
"cover_image_file": {
"object": "file",
"id": "file_2b3c4d5e6f7g",
"name": "cover.png",
"title": "<string>",
"mimetype": "image/png",
"size": 1,
"url": "<string>",
"thumbnail_url": "<string>",
"created_at": "2023-11-07T05:31:56Z"
},
"parent_message": {
"object": "message",
"id": "msg_9f2b8c1d4e5a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"type": "post",
"feed_id": "feed_7m3x9k4t8plz",
"parent_message_id": "msg_9f2b8c1d4e5a",
"title": "<string>",
"slug": "<string>",
"description": "<string>",
"body": "<string>",
"notice": "This thread is out of date. See the current guide.",
"cover_image_file_id": "file_2b3c4d5e6f7g",
"author_profile_id": "prof_9f2b8c1d4e5a",
"source": "slack",
"is_published": true,
"first_published_at": "2023-11-07T05:31:56Z",
"edited_at": "2023-11-07T05:31:56Z",
"latest_activity_at": "2023-11-07T05:31:56Z",
"integrations": {
"slack": {
"channel_id": "C01ABC123",
"ts": "1788879207.324959",
"permalink": "<string>"
}
}
}
}{
"type": "about:blank",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "<string>",
"param": "<string>",
"request_id": "req_9f2b8c1d4e5a6b7c8d9e0f1a2b3c4d5e"
}Authorizations
A Tightknit admin API key, sent as Authorization: Bearer <key>.
Path Parameters
The message's id.
Pattern:
^msg_[a-zA-Z0-9]{12}$Response
Success
Always message.
Available options:
message Unique identifier for the object.
Example:
"msg_9f2b8c1d4e5a"
When it was written, Slack’s own time for a Slack message.
When the object was last changed.
What kind of message it is. One of:
post: opens a thread.comment: replies to a post.
Available options:
post, comment The id of the feed the message was posted in. Null when it belongs to no feed.
Example:
"feed_7m3x9k4t8plz"
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"
The post title. Null on a comment, and on a post stored from Slack until its first publish.
The URL segment of the post’s page. Null on a comment, and on a post stored from Slack until its first publish.
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.
The plaintext rendering of the body.
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."
The id of the image shown as the post’s cover. Null when it has none.
Example:
"file_2b3c4d5e6f7g"
Null when the author was forgotten.
Example:
"prof_9f2b8c1d4e5a"
Where it was written. One of:
site: on the community site.slack: in a synced channel.
Available options:
site, slack Example:
"slack"
Whether members see it on the community site.
When it was first published to the community site. Null for one that never was.
When the message was last edited. Null for one never edited.
The latest activity on the thread, the post or any of its comments. Null on a comment.
Where the message connects to other platforms.
Show child attributes
Show child attributes
The author’s profile. Present only when author is expanded.
Show child attributes
Show child attributes
The feed. Present only when feed is expanded.
Show child attributes
Show child attributes
The cover image. Present only when cover_image_file is expanded.
Show child attributes
Show child attributes
The post a comment replies to. Present only when parent_message is expanded.
Show child attributes
Show child attributes
Was this page helpful?