Mirra
SDK Reference

Feed Items

SDK reference for feed items operations

Overview

Create feed items with flexible content blocks for user notifications and action results

  • Category: internal
  • Auth Required: No
  • Supported Modes: standard, delegated, service

Operations

createFeedItem

Create a feed item with flexible content blocks. Use this to show action results, notifications, or updates to users.

Arguments:

  • title (string, required): Main title of the feed item (shown prominently)
  • subtitle (string, optional): Optional subtitle (shown below title in muted color)
  • blocks (array, required): Array of content blocks to display (text, key_value, list, timestamp, user_mention, divider, image, progress)
  • itemType (string, required): Type: informative (FYI), actionable (needs response), or error
  • actions (array, optional): Optional action buttons for the feed item
  • avatar (object, optional): Optional avatar to show (user profile, icon, or custom image)
  • metadata (object, optional): Additional metadata (searchable, not displayed)

Returns:

AdapterOperationResult - Returns FLAT structure with: feedItemId, title, itemType, subType, status, graphId, createdAt, hasActions, blockCount. No nested objects.

Response Fields:

FieldTypeDescription
feedItemIdstringUnique ID of the created feed item
titlestringTitle of the feed item
itemType``'informative''actionable'
subTypestringSubtype of the feed item
statusstringStatus of the feed item (pending, completed)
graphIdstringGraph ID where feed item was created
createdAtstringCreation timestamp (ISO 8601)
hasActionsbooleanWhether feed item has action buttons
blockCountnumberNumber of content blocks

Example:

const result = await mirra.feedItems.createFeedItem({
  title: "example",
  blocks: [],
  itemType: "example"
});

On this page