Skip to main content
POST
Search the team's media asset library (generated and uploaded images/videos). Filter by file type, favorites, or a name substring. Returns asset metadata with URLs.

Authorizations

Authorization
string
header
required

AdStellar API key (ast_live_...)

Body

application/json
fileType
enum<string>

Filter to images or videos. Omit for both.

Available options:
image,
video
favoritesOnly
boolean

Only return favorited assets.

Substring match on the file name.

Maximum string length: 200
limit
integer

Max assets to return (default 25).

Required range: 1 <= x <= 100
workspaceId
string<uuid>

Limit to one workspace this credential can access. Omit to span all of them.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Tool result