diff --git a/openapi.yaml b/openapi.yaml
index d2288354e..e3f9609c5 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -11,6 +11,10 @@ components:
                     description: Display name of the asset. Mirrors name for backwards compatibility.
                     nullable: true
                     type: string
+                file_path:
+                    description: Relative path in global-namespace-root form (e.g. "models/checkpoints/flux.safetensors")
+                    nullable: true
+                    type: string
                 hash:
                     description: Blake3 hash of the asset content.
                     pattern: ^blake3:[a-f0-9]{64}$
@@ -148,6 +152,10 @@ components:
                     description: Display name of the asset. Mirrors name for backwards compatibility.
                     nullable: true
                     type: string
+                file_path:
+                    description: Relative path in global-namespace-root form (e.g. "models/checkpoints/flux.safetensors")
+                    nullable: true
+                    type: string
                 hash:
                     description: Blake3 hash of the asset content.
                     pattern: ^blake3:[a-f0-9]{64}$
@@ -1706,6 +1714,11 @@ paths:
                   name: name_contains
                   schema:
                     type: string
+                - description: JSON object for filtering by metadata fields
+                  in: query
+                  name: metadata_filter
+                  schema:
+                    type: string
                 - description: Maximum number of assets to return (1-500)
                   in: query
                   name: limit
@@ -2539,6 +2552,11 @@ paths:
                   name: name_contains
                   schema:
                     type: string
+                - description: JSON object for filtering by metadata fields
+                  in: query
+                  name: metadata_filter
+                  schema:
+                    type: string
                 - description: Maximum number of tags to return (1-1000, default 100)
                   in: query
                   name: limit