Documentation Index
Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.
GET /v1/files/{file_id}
Retrieves the detailed metadata for a single file by file ID.
Path parameters
| Parameter | Type | Required | Description |
|---|
file_id | string | Yes | File unique identifier with the file_ prefix |
| Header | Required | Description |
|---|
Authorization | Yes | Bearer $QODER_PAT |
Example request
curl -X GET "https://openapi.qoder.sh/api/v1/cloud/files/file_019e3bb8c1387743bf4ef115aae5acb1" \
-H "Authorization: Bearer $QODER_PAT"
Example response
HTTP 200 OK
{
"created_at": "2026-05-18T15:33:44Z",
"file_id": "file_019e3bb8c1387743bf4ef115aae5acb1",
"filename": "qoder-test-upload.txt",
"metadata": {},
"mime_type": "text/plain",
"purpose": "session_resource",
"size_bytes": 110,
"status": "ready",
"updated_at": "2026-05-18T15:33:44Z"
}
Response fields
| Field | Type | Description |
|---|
file_id | string | File unique identifier |
filename | string | Original filename |
size_bytes | integer | File size in bytes |
mime_type | string | MIME type |
purpose | string | File purpose |
status | string | File status (ready indicates available) |
metadata | object | Custom metadata |
created_at | string | Creation time (ISO 8601) |
updated_at | string | Last update time (ISO 8601) |
Errors
| HTTP | Type | Trigger |
|---|
| 401 | – | Missing or invalid authentication token |
| 404 | not_found_error | File with the given ID does not exist |
Error response example
{
"error": {
"message": "File 'file_nonexistent123' was not found.",
"type": "not_found_error"
},
"type": "error"
}
