| Field | Setter Type | Getter Type | Required | Description | Example |
|---|---|---|---|---|---|
url |
String | String | ✔️ | Playable media URL | |
path |
String | String | ✔️ | Media path on this API | |
contentType |
String | String | ✔️ | MIME type | video/mp4 |
filename |
@Nullable String | JsonNullable<String> | ➖ | Suggested filename Supports tri-state: omit setter to leave unset, pass null to send explicit JSON null. |
|
byteLength |
long | long | ✔️ | File size in bytes | |
cached |
boolean | boolean | ✔️ | Whether the media was already available |