Skip to main content
POST
Insert a block
Inserts a block of one of your app’s types in a message authored by your app. Reintersect validates the props against the block’s props schema, sends your app a block.insert delivery for the initial state and tree, posts the message, and sends block.created. The block has no creator, so audience="creator" parts fall back to admins. Authenticate with an install token that has the blocks:write scope. The target must be within the install’s reach.

Body

Send exactly one of conversationId, replyTo and circleId. They place the message the same way as for replies.

Response

200 with the block:

Errors

Example

With the SDK, call reintersect.blocks.insert(TaskBlock, { conversationId, props }), or pass replyTo or circleId instead of conversationId.