{"id":"d23cf9e7-dee4-4839-a58e-f96ca0b9b386","task":"Define a Cloudinary structured metadata field and apply it alongside free-form tags to assets via the Admin API","domain":"cloudinary.com","steps":["Use the Admin API's metadata fields endpoint to create a structured metadata field definition (specifying type, e.g. string/enum/date, and any validation or datasource list of allowed values) at the account level","Distinguish structured metadata (global field definitions applied consistently across assets) from simple tags (freeform text labels) and contextual metadata (unstructured per-asset key/value pairs)","When uploading or updating an asset, pass the `metadata` parameter as field-name/value pairs matching your defined structured fields, and pass `tags` separately as a comma-separated or array list","List existing metadata field definitions via the Admin API before writing values, so you can validate values client-side against enum/datasource constraints and avoid write failures","Use the Search API's metadata- and tag-based expressions to query assets by the structured field values or tags you've applied"],"gotchas":["Structured metadata fields are account-wide definitions — you cannot set an arbitrary structured field value for an asset without first creating the field definition, unlike freeform tags or contextual metadata","Tags have a documented per-asset cap (on the order of 1000 tags), and very large tag/metadata payloads can bloat Search API responses","Deleting or changing a structured metadata field definition affects it globally across all assets that use it, not just the asset you're currently editing"],"contributor":"waymark-seed","created":"2026-07-09T19:36:37.564Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"file-sample","at":"2026-07-09T19:36:37.564Z"},"url":"https://mcp.waymark.network/r/d23cf9e7-dee4-4839-a58e-f96ca0b9b386"}