# Get file metadata

**API:** Model API

**Endpoint:** `GET /api/v1/files/{file_id}`

**Tags:** Files

Get file metadata

## Base URL

- `https://openapi.felo.ai` — تولید

## Authentication

- `FeloBearerAuth` (http bearer) — کلید API Felo که به‌صورت `Authorization: Bearer <key>` ارسال می‌شود.
- `FeloApiKey` (apiKey in header `X-API-Key`) — کلید API Felo که به‌صورت `X-API-Key: <key>` ارسال می‌شود.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `file_id` | path | yes | string |  |

## Responses

### 200 — Successful Response

**application/json**

Schema: `FileMetadata` (`#/components/schemas/FileMetadata`)

### 422 — Validation Error

**application/json**

Schema: `HTTPValidationError` (`#/components/schemas/HTTPValidationError`)

## Schema definitions

### FileMetadata

`#/components/schemas/FileMetadata`

```json
{
  "properties": {
    "id": {
      "type": "string",
      "title": "Id"
    },
    "type": {
      "type": "string",
      "const": "file",
      "title": "Type"
    },
    "source": {
      "type": "string",
      "enum": [
        "upload",
        "generated"
      ],
      "title": "Source",
      "description": "Origin of the file: `upload` for user uploads, `generated` for model outputs."
    },
    "filename": {
      "type": "string",
      "title": "Filename"
    },
    "mime_type": {
      "type": "string",
      "title": "Mime Type"
    },
    "size_bytes": {
      "type": "integer",
      "title": "Size Bytes"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "title": "Created At"
    },
    "downloadable": {
      "type": "boolean",
      "title": "Downloadable",
      "description": "Whether the original bytes can be downloaded. Uploaded files cannot."
    }
  },
  "type": "object",
  "required": [
    "id",
    "type",
    "source",
    "filename",
    "mime_type",
    "size_bytes",
    "created_at",
    "downloadable"
  ],
  "title": "FileMetadata"
}
```

### HTTPValidationError

`#/components/schemas/HTTPValidationError`

```json
{
  "properties": {
    "detail": {
      "items": {
        "$ref": "#/components/schemas/ValidationError"
      },
      "type": "array",
      "title": "Detail"
    }
  },
  "type": "object",
  "title": "HTTPValidationError"
}
```

### ValidationError

`#/components/schemas/ValidationError`

```json
{
  "properties": {
    "loc": {
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "integer"
          }
        ]
      },
      "type": "array",
      "title": "Location"
    },
    "msg": {
      "type": "string",
      "title": "Message"
    },
    "type": {
      "type": "string",
      "title": "Error Type"
    },
    "input": {
      "title": "Input"
    },
    "ctx": {
      "type": "object",
      "title": "Context"
    }
  },
  "type": "object",
  "required": [
    "loc",
    "msg",
    "type"
  ],
  "title": "ValidationError"
}
```