Skip to content

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. 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. Missing, deleted, and wrong-room 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.