Files
Retrieve a file
Read file metadata including detected MIME type and downloadability.
Upload a file first, then replace the example file ID with its returned ID.
GET
/file/v1/files/{file_id}● SupportedRequest parameters
file_idstring必填path: ID of a tenant-owned live file, as returned by upload or list; starts with file_dp_.
Returns
200 file
Errors follow the OpenAI format — see error codes
Response
HTTP 200
OK
application/json
| Name | Type | Description |
|---|---|---|
| id | string | File identifier: file_dp_ followed by a 26-character uppercase Crockford ULID. Use the ID returned by upload or list. |
| bytes | integer | The size of the file, in bytes. |
| created_at | integer | The Unix timestamp (in seconds) for when the file was created. |
| expires_at | integer | The Unix timestamp (in seconds) for when the file will expire. |
| filename | string | The name of the file. |
| object | string | The object type, which is always `file`. |
| purpose | string | Upload purpose. Image references in conversations require user_data. |
| status | string | Deprecated. The current status of the file, which can be either `uploaded`, `processed`, or `error`. |
| status_details | string | null | Deprecated; always null or absent. |
| mime_type | string | Content-detected MIME type. |
| downloadable | boolean | Tenant-owned live files can be downloaded through this face. |
| scope | object | Present for session output files. |
| scope.type | string | Kind of scope; always `session`. |
| scope.id | string | Id of the session the file belongs to. |
| relative_path | string | Path within the session output directory; present for session outputs. |
| revision | integer | Session output revision; present for session outputs. |