Skip to content
Chatto v0.5.0

AssetService

Chatto exposes this service below /api/connect.

Shared message and enum definitions are documented in Shared Types And Enums.

Reads room-scoped asset metadata and freshly signed asset URLs.

Reads one asset. Authentication and room membership are required. Assets also require message.read or a matching thread relationship with message.read-interactions. Returns NOT_FOUND when the asset is missing, deleted, or owned by a different room.

POST /api/connect/chatto.api.v1.AssetService/GetAsset

Request to read one room-scoped asset with freshly signed URLs.

FieldTypeDescription
room_idstringRequired. Room that owns the asset.
asset_idstringRequired. Asset ID.
thumbnailImageTransformOptionsThumbnail URL options. Defaults are applied when absent.

Response containing one room-scoped asset.

FieldTypeDescription
assetAssetAsset metadata and signed URLs.

Reads many assets in one room. Authentication and room membership are required. Assets also require message.read or a matching thread relationship with message.read-interactions. Missing, deleted, wrong-room, and inaccessible asset IDs are omitted. Results preserve first-seen request order, and repeated asset IDs are de-duplicated.

POST /api/connect/chatto.api.v1.AssetService/BatchGetAssets

Request to read many room-scoped assets with freshly signed URLs.

FieldTypeDescription
room_idstringRequired. Room that owns the assets.
asset_idsrepeated stringRequired. Asset IDs. Missing, deleted, and wrong-room asset IDs are omitted.
thumbnailImageTransformOptionsThumbnail URL options. Defaults are applied when absent.

Response containing room-scoped assets.

FieldTypeDescription
assetsrepeated AssetAssets in first-seen request order.