Add metadata to videos

In FastPix, metadata is custom information you can attach to any on-demand video. Think of it as a set of labels or tags that help you organize, search, or automate actions, but without altering the playback itself.

FastPix does not process metadata internally. It's there to support your workflows, allowing you to define how your content should be categorized, linked, or processed.

What is metadata?

Metadata is a flat JSON object composed of string-based key-value pairs. You define the schema, it can include campaign names, categories, user IDs, or flags for internal workflows. FastPix doesn’t process metadata it stores and returns it with your asset for you to use however you need.

Example:

"metadata": { 
  "category": "fitness", 
  "uploader_id": "user_9281" 
} 

Why metadata matters

Adding metadata helps you:

• Organize videos by language, category, or campaign
• Link content to users, events, or content series
• Drive automation (e.g., trigger AI moderation)
• Build internal tools and dashboards
• Power search and filtering in your UI
• Track publication, ownership, or licensing state

Without metadata, your video is just a file with a URL. With metadata, it's a structured object you can work with.

Schema rules

To keep metadata simple:

• Must be a flat object
• Max: 10 key-value pairs
• Keys: Strings only (lowercase recommended)
• Values: Strings or numbers
• No nested objects or arrays

How to add metadata in on-demand?

Add via API (on upload)

Add metadata in your upload request:

{ 
  "inputs": [ 
    { 
      "type": "video", 
      "url": "https://static.fastpix.io/sample.mp4" 
    } 
  ], 
  "metadata": { 
    "project": "app_launch", 
    "category": "yoga" 
  }, 
  "accessPolicy": "public", 
  "maxResolution": "1080p" 
} 

Add via dashboard

1. Go to Upload Media
2. Choose Push or Pull
3. Scroll to Metadata
4. Add your key-value pairs
5. Click Run

Update your metadata

Use this API to update a video’s metadata after upload:

https://v1.fastpix.io/on-demand/{mediaId}

Example:

{ 
  "metadata": { 
    "language": "es", 
    "reviewed": "true" 
  } 
} 

Full overwrite only you must include all fields you want to retain. Partial updates aren’t supported.

Example use cases