Inbox

Update a thread

Marks it done or open, read or unread, or hands it to a teammate who reaches its profile (assigneeId). Nothing is sent to the network.

patch/inbox/threads/{id}

Request

  • Base URL
    https://api.rizamo.com/v1
  • Auth
    HTTP bearer

Path parameters

idstring required

The thread's id (thr_).

Request body

status'open' | 'done'

done closes it; a new message opens it again.

unreadboolean

True marks it unread, false read.

assigneeIdstring nullable

Hand it to a teammate who reaches its profile, by user id (user_, from List members): an agent passing it to a person. Null unassigns.

Response

OK

idstring required
profileIdstring required
accountIdstring required
network'instagram' | 'facebook' | 'threads' | 'linkedin' | 'tiktok' | 'youtube' | 'x' | 'pinterest' | 'google' required
kind'comment' | 'dm' | 'mention' | 'review' required

comment: a first comment on a post, with the replies under it. dm: private messages with one person. mention and review: not collected yet.

postIdstring nullable required

Comments: the Rizamo post (post_) the comment is on, when it went out through Rizamo. Null on posts made elsewhere, and for messages.

networkPostIdstring nullable required

Comments: the post they are on (npost_), as Get a post on a network returns it, once Rizamo has listed it.

previewstring required

The newest message's text, empty when that message has none.

lastMessageAtstring date-time required
unreadboolean required
status'open' | 'done' required
sentiment'positive' | 'neutral' | 'negative' required

Not computed yet: always neutral until Rizamo reads sentiment, so do not rely on it.

replyWindowEndsAtstring date-time nullable required

Messages: replies are possible until then, 24 hours after the person's last message (Meta's messaging window). Null for comments, which have none.

Changes

No recorded changes to this operation across all 1 revision of this API.