Search agentic assets
Natural-language search over a team’s assets. The default metadata mode is free keyword scoring; semantic and hybrid modes run AI embeddings and report their cost in the response costResult. Use the simpler keyword searchAssets first when a literal text match will do.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.
Body
Natural-language search query over the team media library, 1 to 512 characters.
1 - 512"green screen clip of someone pointing upward"
Search strategy: metadata (keyword scoring), semantic (vector embeddings), or hybrid (both); defaults to metadata.
metadata, semantic, hybrid "hybrid"
Maximum number of results to return, 1 to 50; defaults to 10.
1 <= x <= 5010
Whether to also search the shared Octospark seed template library alongside team assets.
Restrict results to these asset types (image, video, audio, gif, document).
image, video, audio, gif, document ["image", "video"]Restrict results to these asset categories, e.g. user_upload, render, green_screen_template, music.
user_upload, render, template, green_screen_template, sound_effect, music, brand_asset, ai_image, ai_video, other ["user_upload"]