Set when a sent message expires
curl --request PUT \
--url https://api.lithoblocks.com/v1/messages/{id}/expiration \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"after_seconds": 15811230,
"at": "2023-11-07T05:31:56Z",
"mode": "replace",
"retain_content": false
}
'import requests
url = "https://api.lithoblocks.com/v1/messages/{id}/expiration"
payload = {
"after_seconds": 15811230,
"at": "2023-11-07T05:31:56Z",
"mode": "replace",
"retain_content": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
after_seconds: 15811230,
at: '2023-11-07T05:31:56Z',
mode: 'replace',
retain_content: false
})
};
fetch('https://api.lithoblocks.com/v1/messages/{id}/expiration', 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.lithoblocks.com/v1/messages/{id}/expiration",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'after_seconds' => 15811230,
'at' => '2023-11-07T05:31:56Z',
'mode' => 'replace',
'retain_content' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lithoblocks.com/v1/messages/{id}/expiration"
payload := strings.NewReader("{\n \"after_seconds\": 15811230,\n \"at\": \"2023-11-07T05:31:56Z\",\n \"mode\": \"replace\",\n \"retain_content\": false\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.lithoblocks.com/v1/messages/{id}/expiration")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"after_seconds\": 15811230,\n \"at\": \"2023-11-07T05:31:56Z\",\n \"mode\": \"replace\",\n \"retain_content\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lithoblocks.com/v1/messages/{id}/expiration")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"after_seconds\": 15811230,\n \"at\": \"2023-11-07T05:31:56Z\",\n \"mode\": \"replace\",\n \"retain_content\": false\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"template_name": "<string>",
"template_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workspace_id": "<string>",
"channel_id": "<string>",
"channel_name": "<string>",
"message_ts": "<string>",
"recipient_email": "<string>",
"recipient_slack_id": "<string>",
"sent_at": "<string>",
"sent_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sender_api_key_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sender_client_id": "<string>",
"source": "api",
"reference": "<string>",
"lifecycle": "live",
"revision": 123,
"edited_at": "<string>",
"deleted_at": "<string>",
"expired_at": "<string>",
"change_state": "idle",
"pending_action": "edit",
"fallback_text": "<string>",
"text_editable": true,
"expiration": {
"expires_at": "<string>",
"mode": "replace",
"state": "scheduled",
"retain_content": true,
"attempts": 123,
"last_error": "<string>",
"completed_at": "<string>"
}
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"success": false,
"error": {
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>"
}
],
"name": "<string>"
},
"message": "<string>",
"code": "validation_failed",
"request_id": "<string>"
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}Messages
Set when a sent message expires
Schedule the message to expire, replacing any expiry it already has. When the time comes it is replaced with a notice that it expired (or deleted), its buttons stop working, and by default LithoBlocks clears its own copies of what it said. Free. Members can expire only the messages they sent; owners and admins any.
Set when a sent message expires
curl --request PUT \
--url https://api.lithoblocks.com/v1/messages/{id}/expiration \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"after_seconds": 15811230,
"at": "2023-11-07T05:31:56Z",
"mode": "replace",
"retain_content": false
}
'import requests
url = "https://api.lithoblocks.com/v1/messages/{id}/expiration"
payload = {
"after_seconds": 15811230,
"at": "2023-11-07T05:31:56Z",
"mode": "replace",
"retain_content": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
after_seconds: 15811230,
at: '2023-11-07T05:31:56Z',
mode: 'replace',
retain_content: false
})
};
fetch('https://api.lithoblocks.com/v1/messages/{id}/expiration', 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.lithoblocks.com/v1/messages/{id}/expiration",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'after_seconds' => 15811230,
'at' => '2023-11-07T05:31:56Z',
'mode' => 'replace',
'retain_content' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lithoblocks.com/v1/messages/{id}/expiration"
payload := strings.NewReader("{\n \"after_seconds\": 15811230,\n \"at\": \"2023-11-07T05:31:56Z\",\n \"mode\": \"replace\",\n \"retain_content\": false\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.lithoblocks.com/v1/messages/{id}/expiration")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"after_seconds\": 15811230,\n \"at\": \"2023-11-07T05:31:56Z\",\n \"mode\": \"replace\",\n \"retain_content\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lithoblocks.com/v1/messages/{id}/expiration")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"after_seconds\": 15811230,\n \"at\": \"2023-11-07T05:31:56Z\",\n \"mode\": \"replace\",\n \"retain_content\": false\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"template_name": "<string>",
"template_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workspace_id": "<string>",
"channel_id": "<string>",
"channel_name": "<string>",
"message_ts": "<string>",
"recipient_email": "<string>",
"recipient_slack_id": "<string>",
"sent_at": "<string>",
"sent_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sender_api_key_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sender_client_id": "<string>",
"source": "api",
"reference": "<string>",
"lifecycle": "live",
"revision": 123,
"edited_at": "<string>",
"deleted_at": "<string>",
"expired_at": "<string>",
"change_state": "idle",
"pending_action": "edit",
"fallback_text": "<string>",
"text_editable": true,
"expiration": {
"expires_at": "<string>",
"mode": "replace",
"state": "scheduled",
"retain_content": true,
"attempts": 123,
"last_error": "<string>",
"completed_at": "<string>"
}
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"success": false,
"error": {
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>"
}
],
"name": "<string>"
},
"message": "<string>",
"code": "validation_failed",
"request_id": "<string>"
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}{
"error": "<string>",
"code": "unauthenticated",
"request_id": "<string>",
"message": "<string>",
"details": "<string>",
"error_details": "<string>",
"success": false,
"valid": false,
"required_scopes": [
"<string>"
],
"user_scopes": [
"<string>"
]
}Authorizations
LithoBlocks API key obtained from your organization dashboard. The LithoBlocks MCP server also presents a Supabase-issued user session token here on the user's behalf; such a token acts as that user with the scopes their organization role allows.
Headers
Any unique string (a UUID is fine). Repeating a request with the same key and body within 24 hours replays the original response with Idempotency-Replayed: true instead of running again; the same key with a different body is a 409. Incomplete and 5xx outcomes are retained for reconciliation beyond 24 hours. Applies only on the documented endpoints. Never automatically change keys to bypass an uncertain outcome.
Required string length:
1 - 255Example:
"3f7d2c1a-9b4e-4f0a-8c6d-2e1b5a7c9d10"
Path Parameters
Body
application/json
When and how it expires
Expire the message: replace it with a notice, or delete it. Precise to about a minute; a button clicked after the deadline does nothing even before the message is replaced.
Seconds after the message is delivered. At least 60: expiry runs about once a minute.
Required range:
60 <= x <= 31622400An absolute time, at least 60 seconds from now.
replace (default): the message is replaced with a notice that it expired, and its buttons stop working. delete: it is deleted from Slack.
Available options:
replace, delete By default LithoBlocks clears its own copies of what the message said when it expires. true keeps them.
Response
The message with its expiry
LithoBlocks' id for the message; send responses return it as message_id.
Null once the template has been deleted.
The template's name when the message was sent.
The Slack workspace (team) id.
The resolved channel; a D… id for a direct message.
The channel's name when the message was sent, without the #. Null for direct messages, private channels and messages sent before 2026-10-22.
Slack's timestamp for the message.
The user the send is attributed to; for an API key, the key's owner.
The OAuth client a session token was issued to, e.g. an MCP client.
How it was sent. Null for messages sent before 2026-10-22.
Available options:
api, api_bulk, web, scheduled, digest, slash The caller's own handle for the message, if it gave one.
What has happened to the message in Slack since it was sent.
Available options:
live, deleted, expired Increments with every change; a change names the revision it was made against.
needs_reconciliation: Slack's answer to a change was lost, and a person must say whether it went through before anything else can change.
Available options:
idle, in_progress, needs_reconciliation Available options:
edit, rerender, interaction_update, delete, expire The notification text sent with the blocks.
Whether the stored blocks are exactly what Slack holds, so the text can be corrected in place.
The message's expiry, if one was ever set.
Show child attributes
Show child attributes