Skip to main content
GET
/
genai
/
v1beta
/
files
/
{file_id}
Retrieve file (Gemini format)
curl --request GET \
  --url http://localhost:8080/genai/v1beta/files/{file_id}
{
  "name": "<string>",
  "displayName": "<string>",
  "mimeType": "<string>",
  "sizeBytes": "<string>",
  "createTime": "2023-11-07T05:31:56Z",
  "updateTime": "2023-11-07T05:31:56Z",
  "expirationTime": "2023-11-07T05:31:56Z",
  "sha256Hash": "<string>",
  "uri": "<string>",
  "state": "STATE_UNSPECIFIED",
  "error": {
    "code": 123,
    "message": "<string>"
  },
  "videoMetadata": {
    "videoDuration": "<string>"
  }
}

Path Parameters

file_id
string
required

File ID

Response

Successful response

name
string

File resource name (e.g., files/abc123)

displayName
string
mimeType
string
sizeBytes
string

Size in bytes (returned as string by Gemini API)

createTime
string<date-time>
updateTime
string<date-time>
expirationTime
string<date-time>
sha256Hash
string
uri
string

URI for accessing the file content

state
enum<string>
Available options:
STATE_UNSPECIFIED,
PROCESSING,
ACTIVE,
FAILED
error
object
videoMetadata
object