# Get agent file

`GET /v1/projects/{project}/agents/{agent}/files/{file}`, operation `agents.GetAgentFile`

Gets one of an agent's files: its name, type and size, and what the agent's model reads of it.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `project` | path | Yes | `string` | The project's ID. |
| `agent` | path | Yes | `string` | The agent's ID. |
| `file` | path | Yes | `string` | The file's ID. |

## Responses

### 200

OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `createTime` | `string (date-time)` | Yes | When it was uploaded. |
| `creator` | `string` | Yes | Who uploaded it, such as user:usr_…. |
| `filename` | `string` | Yes | Its file name. |
| `height` | `integer (int32)` | No | An image's height, in pixels. |
| `mediaType` | `string` | Yes | Its media type, such as image/png or application/pdf. |
| `modelReads` | `string` | Yes | What the agent's model reads of the file in a message: CONTENT, the file itself, as an image or a document, which models that read neither get a placeholder for; or DESCRIPTION, its name, media type, size and ID alone, by which the agent's tools open it. Values: `CONTENT`, `DESCRIPTION`. |
| `name` | `string` | Yes | Resource name, projects/{project_id}/agents/{agent_id}/files/{file_id}, by which a message's file part attaches it. |
| `sha256` | `string` | Yes | The SHA-256 of its content, in hexadecimal. |
| `sizeBytes` | `integer (int64)` | Yes | Its size, in bytes. |
| `width` | `integer (int32)` | No | An image's width, in pixels. |

### default

Error

Base URL: `https://api.kosem.ai`. See [API conventions](https://docs.kosem.ai/reference/api-conventions.md) for authentication, pagination and errors, and [https://docs.kosem.ai/openapi.yaml](https://docs.kosem.ai/openapi.yaml) for the full OpenAPI document.