Team Inbox

Internal threads, channels and direct messages.

GET/team-inbox/membersList org members (team inbox)
GET/team-inbox/threadsList team-inbox threads
GET/team-inbox/threads/{id}Get a team-inbox thread
PATCH/team-inbox/threads/{id}Update a thread (name/topic/description/archived/visibility/postPolicy)
GET/team-inbox/threads/{id}/messagesList messages in a team thread
POST/team-inbox/threads/{id}/messagesSend a team-inbox message
POST/team-inbox/dmStart a direct message
GET/team-inbox/channelsBrowse channels (public + mine)
POST/team-inbox/channelsCreate a channel (pass visibility public|private) or legacy group
POST/team-inbox/channels/{id}/joinJoin a public channel
GET/team-inbox/messages/{id}Get one team-inbox message (permalink)
PATCH/team-inbox/messages/{id}Edit my team-inbox message
DELETE/team-inbox/messages/{id}Delete a team-inbox message (author or admin)
POST/team-inbox/threads/{id}/mark-unreadMark a team thread unread from a message
GET/team-inbox/messages/{id}/repliesList a message's thread replies
GET/team-inbox/threads-viewMy followed reply-threads (Threads view)
GET/team-inbox/draftsList my team-inbox composer drafts
PUT/team-inbox/draftsSave (upsert) a composer draft; empty text deletes it
DELETE/team-inbox/drafts/{id}Delete one of my drafts
GET/team-inbox/scheduledList my scheduled team-inbox sends
POST/team-inbox/scheduledSchedule a team-inbox message for later
PATCH/team-inbox/scheduled/{id}Edit a pending scheduled send (time/text)
DELETE/team-inbox/scheduled/{id}Cancel a pending scheduled send
POST/team-inbox/scheduled/{id}/send-nowSend a scheduled message immediately
GET/team-inbox/sentMy recently sent team-inbox messages
GET/team-inbox/activityMy activity feed (mentions/replies/reactions)
POST/team-inbox/activity/readMark activity read (all, or pass ids)
GET/team-inbox/savedMy saved-for-later messages
POST/team-inbox/savedSave a message for later
PATCH/team-inbox/saved/{id}Move a saved item between states and/or set a reminder
DELETE/team-inbox/saved/{id}Remove a saved item
GET/team-inbox/unreadsUnread conversations with their unread messages
POST/team-inbox/threads/read-allMark every conversation read (returns previous watermarks for undo)
GET/team-inbox/sidebarMy sidebar layout prefs (sections/starred/collapsed)
PUT/team-inbox/sidebarSave sidebar layout prefs (partial)
PUT/team-inbox/threads/{id}/notifySet my notification level and/or chime toggle for a conversation
GET/team-inbox/threads/{id}/pinsPinned messages in a conversation
POST/team-inbox/threads/{id}/pinsPin a message
DELETE/team-inbox/threads/{id}/pins/{messageId}Unpin a message
POST/team-inbox/threads/{id}/bookmarksAdd a bookmark to a conversation
PATCH/team-inbox/threads/{id}/bookmarks/{bookmarkId}Edit a bookmark
DELETE/team-inbox/threads/{id}/bookmarks/{bookmarkId}Remove a bookmark
GET/team-inbox/searchSearch team-inbox messages/files/channels/people
POST/team-inbox/messages/{id}/reactionsToggle my emoji reaction on a message
POST/team-inbox/threads/{id}/readMark a conversation read
POST/team-inbox/threads/{id}/membersAdd members to a group/channel
DELETE/team-inbox/threads/{id}/members/{userId}Remove a member (or leave yourself)
GET/team-inbox/presenceUser ids currently online in the org
GET/team-inbox/unread-countMy unread/mention/thread/activity counters
POST/team-inbox/messages/{id}/followFollow/unfollow a message thread
POST/team-inbox/messages/{id}/read-repliesMark a thread's replies read
PUT/team-inbox/statusSet my custom status (empty clears)
GET/team-inbox/preferencesMy team-inbox notification preferences + status
PUT/team-inbox/preferencesSave notification preferences (quiet hours/sounds/mark-read/DND pause)

List org members (team inbox)

GET/team-inbox/members

Scope team_inbox:viewRead-only

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/members" \  -H "Authorization: Bearer $KLERC_TOKEN"

List team-inbox threads

GET/team-inbox/threads

Scope team_inbox:viewRead-only

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/threads" \  -H "Authorization: Bearer $KLERC_TOKEN"

Get a team-inbox thread

GET/team-inbox/threads/{id}

Scope team_inbox:viewRead-only

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/threads/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN"

Update a thread (name/topic/description/archived/visibility/postPolicy)

PATCH/team-inbox/threads/{id}

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`name`	string
`topic`	string
`description`	string
`archived`	boolean
`visibility`	"public" \| "private"
`postPolicy`	"everyone" \| "admins"

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X PATCH "https://api.klerc.co/api/v1/team-inbox/threads/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"name":"…","topic":"…","description":"…","archived":false,"visibility":"public","postPolicy":"everyone"}'

List messages in a team thread

GET/team-inbox/threads/{id}/messages

Scope team_inbox:viewRead-only

Path parameters

Name	Type
`id`required	string

Query parameters

Name	Type
`limit`	number
`cursor`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/threads/{id}/messages?limit=25" \  -H "Authorization: Bearer $KLERC_TOKEN"

Send a team-inbox message

POST/team-inbox/threads/{id}/messages

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`text`	string
`clientId`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/threads/{id}/messages" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"text":"…","clientId":"…"}'

Start a direct message

POST/team-inbox/dm

Scope team_inbox:sendWrites data

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/dm" \  -H "Authorization: Bearer $KLERC_TOKEN"

Browse channels (public + mine)

GET/team-inbox/channels

Scope team_inbox:viewRead-only

Query parameters

Name	Type
`query`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/channels" \  -H "Authorization: Bearer $KLERC_TOKEN"

Create a channel (pass visibility public|private) or legacy group

POST/team-inbox/channels

Scope team_inbox:sendWrites data

Request body

Field	Type
`name`	string
`visibility`	"public" \| "private"

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/channels" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"name":"…","visibility":"public"}'

Join a public channel

POST/team-inbox/channels/{id}/join

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/channels/{id}/join" \  -H "Authorization: Bearer $KLERC_TOKEN"

Get one team-inbox message (permalink)

GET/team-inbox/messages/{id}

Scope team_inbox:viewRead-only

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/messages/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN"

Edit my team-inbox message

PATCH/team-inbox/messages/{id}

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`text`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X PATCH "https://api.klerc.co/api/v1/team-inbox/messages/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"text":"…"}'

Delete a team-inbox message (author or admin)

DELETE/team-inbox/messages/{id}

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X DELETE "https://api.klerc.co/api/v1/team-inbox/messages/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN"

Mark a team thread unread from a message

POST/team-inbox/threads/{id}/mark-unread

Scope team_inbox:viewWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`messageId`	string
`at`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/threads/{id}/mark-unread" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"messageId":"…","at":"…"}'

List a message's thread replies

GET/team-inbox/messages/{id}/replies

Scope team_inbox:viewRead-only

Path parameters

Name	Type
`id`required	string

Query parameters

Name	Type
`cursor`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/messages/{id}/replies" \  -H "Authorization: Bearer $KLERC_TOKEN"

My followed reply-threads (Threads view)

GET/team-inbox/threads-view

Scope team_inbox:viewRead-only

Query parameters

Name	Type
`cursor`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/threads-view" \  -H "Authorization: Bearer $KLERC_TOKEN"

List my team-inbox composer drafts

GET/team-inbox/drafts

Scope team_inbox:viewRead-only

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/drafts" \  -H "Authorization: Bearer $KLERC_TOKEN"

Save (upsert) a composer draft; empty text deletes it

PUT/team-inbox/drafts

Scope team_inbox:sendWrites data

Request body

Field	Type
`chatId`required	string
`parentMessageId`	string
`text`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X PUT "https://api.klerc.co/api/v1/team-inbox/drafts" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"chatId":"…","parentMessageId":"…","text":"…"}'

Delete one of my drafts

DELETE/team-inbox/drafts/{id}

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X DELETE "https://api.klerc.co/api/v1/team-inbox/drafts/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN"

List my scheduled team-inbox sends

GET/team-inbox/scheduled

Scope team_inbox:viewRead-only

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/scheduled" \  -H "Authorization: Bearer $KLERC_TOKEN"

Schedule a team-inbox message for later

POST/team-inbox/scheduled

Scope team_inbox:sendWrites data

Request body

Field	Type
`chatId`required	string
`scheduledAt`required	string
`text`	string
`parentMessageId`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/scheduled" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"chatId":"…","scheduledAt":"…","text":"…","parentMessageId":"…"}'

Edit a pending scheduled send (time/text)

PATCH/team-inbox/scheduled/{id}

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`scheduledAt`	string
`text`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X PATCH "https://api.klerc.co/api/v1/team-inbox/scheduled/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"scheduledAt":"…","text":"…"}'

Cancel a pending scheduled send

DELETE/team-inbox/scheduled/{id}

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X DELETE "https://api.klerc.co/api/v1/team-inbox/scheduled/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN"

Send a scheduled message immediately

POST/team-inbox/scheduled/{id}/send-now

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/scheduled/{id}/send-now" \  -H "Authorization: Bearer $KLERC_TOKEN"

My recently sent team-inbox messages

GET/team-inbox/sent

Scope team_inbox:viewRead-only

Query parameters

Name	Type
`limit`	number

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/sent?limit=25" \  -H "Authorization: Bearer $KLERC_TOKEN"

My activity feed (mentions/replies/reactions)

GET/team-inbox/activity

Scope team_inbox:viewRead-only

Query parameters

Name	Type
`unreadOnly`	number
`cursor`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/activity" \  -H "Authorization: Bearer $KLERC_TOKEN"

Mark activity read (all, or pass ids)

POST/team-inbox/activity/read

Scope team_inbox:viewWrites data

Request body

Field	Type
`ids`	array of string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/activity/read" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"ids":["…"]}'

My saved-for-later messages

GET/team-inbox/saved

Scope team_inbox:viewRead-only

Query parameters

Name	Type
`state`	"in_progress" \| "completed" \| "archived"

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/saved" \  -H "Authorization: Bearer $KLERC_TOKEN"

Save a message for later

POST/team-inbox/saved

Scope team_inbox:viewWrites data

Request body

Field	Type
`messageId`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/saved" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"messageId":"…"}'

Move a saved item between states and/or set a reminder

PATCH/team-inbox/saved/{id}

Scope team_inbox:viewWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`state`	"in_progress" \| "completed" \| "archived"
`remindAt`	string \| null

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X PATCH "https://api.klerc.co/api/v1/team-inbox/saved/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"state":"in_progress","remindAt":"…"}'

Remove a saved item

DELETE/team-inbox/saved/{id}

Scope team_inbox:viewWrites data

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X DELETE "https://api.klerc.co/api/v1/team-inbox/saved/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN"

Unread conversations with their unread messages

GET/team-inbox/unreads

Scope team_inbox:viewRead-only

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/unreads" \  -H "Authorization: Bearer $KLERC_TOKEN"

Mark every conversation read (returns previous watermarks for undo)

POST/team-inbox/threads/read-all

Scope team_inbox:viewWrites data

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/threads/read-all" \  -H "Authorization: Bearer $KLERC_TOKEN"

My sidebar layout prefs (sections/starred/collapsed)

GET/team-inbox/sidebar

Scope team_inbox:viewRead-only

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/sidebar" \  -H "Authorization: Bearer $KLERC_TOKEN"

Save sidebar layout prefs (partial)

PUT/team-inbox/sidebar

Scope team_inbox:viewWrites data

Request body

Field	Type
`sections`	array of object
`starredChatIds`	array of string
`collapsedKeys`	array of string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X PUT "https://api.klerc.co/api/v1/team-inbox/sidebar" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"sections":[{}],"starredChatIds":["…"],"collapsedKeys":["…"]}'

Set my notification level and/or chime toggle for a conversation

PUT/team-inbox/threads/{id}/notify

Scope team_inbox:viewWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`notify`	"all" \| "mentions" \| "none"
`sound`	boolean

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X PUT "https://api.klerc.co/api/v1/team-inbox/threads/{id}/notify" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"notify":"all","sound":false}'

Pinned messages in a conversation

GET/team-inbox/threads/{id}/pins

Scope team_inbox:viewRead-only

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/threads/{id}/pins" \  -H "Authorization: Bearer $KLERC_TOKEN"

Pin a message

POST/team-inbox/threads/{id}/pins

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`messageId`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/threads/{id}/pins" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"messageId":"…"}'

Unpin a message

DELETE/team-inbox/threads/{id}/pins/{messageId}

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string
`messageId`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X DELETE "https://api.klerc.co/api/v1/team-inbox/threads/{id}/pins/{messageId}" \  -H "Authorization: Bearer $KLERC_TOKEN"

Add a bookmark to a conversation

POST/team-inbox/threads/{id}/bookmarks

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`title`required	string
`url`required	string
`emoji`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/threads/{id}/bookmarks" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"title":"…","url":"…","emoji":"…"}'

Edit a bookmark

PATCH/team-inbox/threads/{id}/bookmarks/{bookmarkId}

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string
`bookmarkId`required	string

Request body

Field	Type
`title`	string
`url`	string
`emoji`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X PATCH "https://api.klerc.co/api/v1/team-inbox/threads/{id}/bookmarks/{bookmarkId}" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"title":"…","url":"…","emoji":"…"}'

Remove a bookmark

DELETE/team-inbox/threads/{id}/bookmarks/{bookmarkId}

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string
`bookmarkId`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X DELETE "https://api.klerc.co/api/v1/team-inbox/threads/{id}/bookmarks/{bookmarkId}" \  -H "Authorization: Bearer $KLERC_TOKEN"

Search team-inbox messages/files/channels/people

GET/team-inbox/search

Scope team_inbox:viewRead-only

Query parameters

Name	Type
`q`	string
`tab`	"messages" \| "files" \| "channels" \| "people"
`from`	string
`in`	string
`before`	string
`after`	string
`fileType`	string
`page`	number

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/search" \  -H "Authorization: Bearer $KLERC_TOKEN"

Toggle my emoji reaction on a message

POST/team-inbox/messages/{id}/reactions

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`emoji`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/messages/{id}/reactions" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"emoji":"…"}'

Mark a conversation read

POST/team-inbox/threads/{id}/read

Scope team_inbox:viewWrites data

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/threads/{id}/read" \  -H "Authorization: Bearer $KLERC_TOKEN"

Add members to a group/channel

POST/team-inbox/threads/{id}/members

Scope team_inbox:manageWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`memberIds`required	array of string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/threads/{id}/members" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"memberIds":["…"]}'

Remove a member (or leave yourself)

DELETE/team-inbox/threads/{id}/members/{userId}

Scope team_inbox:sendWrites data

Path parameters

Name	Type
`id`required	string
`userId`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X DELETE "https://api.klerc.co/api/v1/team-inbox/threads/{id}/members/{userId}" \  -H "Authorization: Bearer $KLERC_TOKEN"

User ids currently online in the org

GET/team-inbox/presence

Scope team_inbox:viewRead-only

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/presence" \  -H "Authorization: Bearer $KLERC_TOKEN"

My unread/mention/thread/activity counters

GET/team-inbox/unread-count

Scope team_inbox:viewRead-only

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/unread-count" \  -H "Authorization: Bearer $KLERC_TOKEN"

Follow/unfollow a message thread

POST/team-inbox/messages/{id}/follow

Scope team_inbox:viewWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`following`required	boolean

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/messages/{id}/follow" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"following":false}'

Mark a thread's replies read

POST/team-inbox/messages/{id}/read-replies

Scope team_inbox:viewWrites data

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/team-inbox/messages/{id}/read-replies" \  -H "Authorization: Bearer $KLERC_TOKEN"

Set my custom status (empty clears)

PUT/team-inbox/status

Scope team_inbox:viewWrites data

Request body

Field	Type
`emoji`	string
`text`	string
`clearAt`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X PUT "https://api.klerc.co/api/v1/team-inbox/status" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"emoji":"…","text":"…","clearAt":"…"}'

My team-inbox notification preferences + status

GET/team-inbox/preferences

Scope team_inbox:viewRead-only

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/team-inbox/preferences" \  -H "Authorization: Bearer $KLERC_TOKEN"

Save notification preferences (quiet hours/sounds/mark-read/DND pause)

PUT/team-inbox/preferences

Scope team_inbox:viewWrites data

Request body

Field	Type
`quietStart`	string \| null
`quietEnd`	string \| null
`tz`	string \| null
`sounds`	boolean
`markReadBehavior`	"auto" \| "manual"
`dndUntil`	string \| null

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X PUT "https://api.klerc.co/api/v1/team-inbox/preferences" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"quietStart":"…","quietEnd":"…","tz":"…","sounds":false,"markReadBehavior":"auto","dndUntil":"…"}'