Skip to main content
Retrieve a pinned message

Authorizations

Authorization
string
header
required

A Tightknit admin API key, sent as Authorization: Bearer <key>.

Path Parameters

pinned_message_id
string
required

The pinned message's id.

Pattern: ^pinm_[a-zA-Z0-9]{12}$

Query Parameters

expand

Repeatable. Returns the named relation inline. One of: message, pinned_by, pinned_by_slack_user.

Available options:
message,
pinned_by,
pinned_by_slack_user

Response

Success

object
enum<string>
required

Always pinned_message.

Available options:
pinned_message
id
string
required

Unique identifier for the object.

Example:

"pinm_3n7q1v8k2xwd"

created_at
string<date-time>
required

When the message was pinned, Slack’s own time for a Slack pin.

updated_at
string<date-time>
required

When the object was last changed.

feed_id
string
required

The id of the feed the message is pinned in.

Example:

"feed_7m3x9k4t8plz"

message_id
string
required

The id of the pinned message.

Example:

"msg_9f2b8c1d4e5a"

source
enum<string>
required

Where the pin came from. One of:

  • slack: mirrors the channel’s own pins.
  • studio: pinned by Tightknit staff for the community, and survives a Slack unpin.
Available options:
slack,
studio
Example:

"slack"

pinned_by_id
string | null
required

Who pinned it, for a studio pin. Null for a Slack pin, or when no one is recorded.

Example:

"prof_9f2b8c1d4e5a"

integrations
object
required

Where the pin connects to other platforms.

message
object | null

The pinned message. Present only when message is expanded.

pinned_by
object | null

The member who pinned it. Present only when pinned_by is expanded.