Search Visual Assets
POST /api/creative/visual-studio/assets/search
Search assets semantically by description and tags, scoped to owner projects.
Request Body required
Section titled “Request Body required ”Request model for semantic asset search.
object
Search query
Max results
Responses
Section titled “ Responses ”Successful Response
Response model for asset semantic search.
object
Matching assets
Visual asset model for API responses.
Represents a complete visual asset with all metadata, tags, and project association information.
Attributes: id: Unique asset identifier project_id: Parent project identifier type: Asset type (image, video, audio, etc.) name: Human-readable asset name url: Asset URL or file path metadata: Detailed asset metadata created_at: Unix timestamp of creation updated_at: Unix timestamp of last update tags: List of categorization tags
object
Asset ID
Project ID
Asset type
Asset name
Asset URL
Visual asset metadata model.
Contains detailed metadata about visual assets including file size, format, dimensions, duration, and custom fields.
Attributes: file_size: File size in bytes (optional) format: File format (PNG, JPG, MP4, etc.) dimensions: Asset dimensions (e.g., 1920x1080) duration: Duration in seconds for video/audio custom: Custom metadata key-value pairs
object
Creation timestamp
Last update timestamp
Asset tags
Asset description
Image annotations
A spatial annotation on a visual asset.
object
Annotation ID
Annotation text
Normalized X position (0-1)
Normalized Y position (0-1)
Creation timestamp
Total results count
Original search query
Validation Error