Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.blobhub.io/llms.txt

Use this file to discover all available pages before exploring further.

Append an item to a thread session object.

​
POST /revisions/:id/data (Command: post_session_thread_item)

​
Request Body

ParameterTypeRequiredDescription
enginestringYesMust be workflow_blobhub.
commandstringYesMust be post_session_thread_item.
session_idstringYesThe ID of the session that owns the thread envelope.
aliasstringYesAlias of the thread session object.
contentarray of objectYesSame shape as message.content — entries of {type: "text", text} or {type: "json", json}.
parent_idstringNoOptional parent item id. Stored only.
metadataobjectNoOptional arbitrary JSON.

​
Response

Returns the persisted item with server-stamped id, created_at, user_id, and the original/derived fields.
ParameterTypeDescription
itemobjectThe persisted thread item, including server-stamped id, created_at, user_id, and revision_id.

​
Errors

  • invalid_thread_envelope — the alias does not exist or its value.type is not "thread".
  • thread_item_too_large — the serialized item exceeds the server-side size cap.

​
Example

{
  "engine": "workflow_blobhub",
  "command": "post_session_thread_item",
  "session_id": "sess_001",
  "alias": "onboarding_thread",
  "content": [
    { "type": "text", "text": "Hello, world." }
  ]
}