Assets

List assets

get/v1/assets/

Request

  • Base URL: https://api.picsha.ai
  • URL: https://api.picsha.ai/v1/assets/
  • Auth: HTTP bearer

Query parameters

pagenumber
limitnumber
tagstring
typestring
searchstring
sortstring
albumIdstring
statusstring

Filter by status; 'trashed' lists the recycle bin

ingestKeyIdstring

Only assets ingested by this API key (ApiKey.id); "none" for session-ingested/legacy assets

metadataFieldstring

Metadata key to filter on (e.g. apiKeyName, uploadSource)

metadataValuestring

Required value for metadataField

metadatastring

JSON object of exact matches on metadata keys, e.g. {"asset_status":"Retired"} or {"asset_visibility":["@all","@sales"]}; all keys must match, a list of values matches any of them

anyOfstring

JSON array of {"metadata": {...}} blocks; an asset matches when it satisfies at least one block, combined with the other filters

Response

Default Response

Changes

No recorded changes to this operation across all 1 revision of this API.