Postable

Base interface for entities that can receive messages. Both Thread and Channel extend this interface.

Properties

Adapter

required

The adapter this entity belongs to

ChannelVisibility

required

The visibility scope of this channel

string

required

Unique ID

boolean

required

Whether this is a direct message conversation

AsyncIterable<Message<TRawMessage>>

required

Type: MessageIterate messages newest first (backward from most recent). Auto-paginates lazily — only fetches pages as consumed.

Promise<TState | null>

required

Get the current state. Returns null if no state has been set.

Methods

mentionUser()

mentionUser(userId: string): string

Get a platform-specific mention string for a user.

Parameters

string

required

Returns

string

post()

post(message: T): Promise<T>

Post a message.

Parameters

required

Returns

Promise<T>

post(message: string | PostableRaw | PostableMarkdown | PostableAst | PostableCard | CardElement | TextElement | ImageElement | DividerElement | ActionsElement | SectionElement | FieldsElement | LinkElement | TableElement | ChartElement | ModalElement | CardJSXElement<CardJSXProps> | ButtonElement | LinkButtonElement | FieldElement | TextInputElement | DateInputElement | NumberInputElement | SelectElement | ExternalSelectElement | SelectOptionElement | RadioSelectElement | AsyncIterable<string | StreamChunk | StreamEvent, any, any> | PostableObject<unknown>): Promise<SentMessage<TRawMessage>>

Parameters

required

Type:

PostableRawPostableMarkdownPostableAstPostableCardCardElementTextElementImageElementDividerElementActionsElementSectionElementFieldsElementLinkElementTableElementChartElementModalElementCardJSXElementCardJSXPropsButtonElementLinkButtonElementFieldElementTextInputElementDateInputElementNumberInputElementSelectElementExternalSelectElementSelectOptionElementRadioSelectElementStreamChunkStreamEventPostableObject

Returns

SentMessage

postEphemeral()

postEphemeral(user: string | Author, message: string | PostableRaw | PostableMarkdown | PostableAst | PostableCard | CardElement | TextElement | ImageElement | DividerElement | ActionsElement | SectionElement | FieldsElement | LinkElement | TableElement | ChartElement | ModalElement | CardJSXElement<CardJSXProps> | ButtonElement | LinkButtonElement | FieldElement | TextInputElement | DateInputElement | NumberInputElement | SelectElement | ExternalSelectElement | SelectOptionElement | RadioSelectElement, options: PostEphemeralOptions): Promise<EphemeralMessage<TRawMessage> | null>

Post an ephemeral message visible only to a specific user.

Parameters

string | Author

required

Type: Author

required

Type:

PostableRawPostableMarkdownPostableAstPostableCardCardElementTextElementImageElementDividerElementActionsElementSectionElementFieldsElementLinkElementTableElementChartElementModalElementCardJSXElementCardJSXPropsButtonElementLinkButtonElementFieldElementTextInputElementDateInputElementNumberInputElementSelectElementExternalSelectElementSelectOptionElementRadioSelectElement

PostEphemeralOptions

required

Returns

EphemeralMessage

schedule()

schedule(message: string | PostableRaw | PostableMarkdown | PostableAst | PostableCard | CardElement | TextElement | ImageElement | DividerElement | ActionsElement | SectionElement | FieldsElement | LinkElement | TableElement | ChartElement | ModalElement | CardJSXElement<CardJSXProps> | ButtonElement | LinkButtonElement | FieldElement | TextInputElement | DateInputElement | NumberInputElement | SelectElement | ExternalSelectElement | SelectOptionElement | RadioSelectElement, options: { postAt: Date }): Promise<ScheduledMessage<TRawMessage>>

Schedule a message for future delivery. Currently only supported by the Slack adapter. Other adapters will throw NotImplementedError.

const scheduled = await thread.schedule("Reminder: standup!", {
  postAt: new Date("2026-03-09T09:00:00Z"),
});

// Cancel before it's sent
await scheduled.cancel();

Parameters

required

Type:

PostableRawPostableMarkdownPostableAstPostableCardCardElementTextElementImageElementDividerElementActionsElementSectionElementFieldsElementLinkElementTableElementChartElementModalElementCardJSXElementCardJSXPropsButtonElementLinkButtonElementFieldElementTextInputElementDateInputElementNumberInputElementSelectElementExternalSelectElementSelectOptionElementRadioSelectElement

The message content (streaming not supported)

{ postAt: Date }

required

Scheduling options including the target delivery time

Returns

ScheduledMessage A ScheduledMessage with cancel() capability

setState()

setState(state: Partial<TState>, options?: { replace: boolean }): Promise<void>

Set the state. Merges with existing state by default.

Parameters

Partial<TState>

required

{ replace: boolean }

Returns

Promise<void>

startTyping()

startTyping(status?: string): Promise<void>

Show typing indicator

Parameters

string

Returns

Promise<void>

Advanced Kits

Opensource Kits

Utilities

Type reference

Properties

Methods

mentionUser()

Parameters

Returns

post()

Parameters

Returns

Parameters

Returns

postEphemeral()

Parameters

Returns

schedule()

Parameters

Returns

setState()

Parameters

Returns

startTyping()

Parameters

Returns

​Properties

​Methods

​mentionUser()

​Parameters

​Returns

​post()

​Parameters

​Returns

​Parameters

​Returns

​postEphemeral()

​Parameters

​Returns

​schedule()

​Parameters

​Returns

​setState()

​Parameters

​Returns

​startTyping()

​Parameters

​Returns

Properties

Methods

mentionUser()

Parameters

Returns

post()

Parameters

Returns

Parameters

Returns

postEphemeral()

Parameters

Returns

schedule()

Parameters

Returns

setState()

Parameters

Returns

startTyping()

Parameters

Returns