> For the complete documentation index, see [llms.txt](https://docs.eclipse-pass.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eclipse-pass.org/developer-documentation/pass-core/model/file.md).

# File

Files are associated with a [Submissions](/developer-documentation/pass-core/model/submission.md) to be used to form [Deposits](/developer-documentation/pass-core/model/deposit.md) into [Repositories](/developer-documentation/pass-core/model/repository.md)

| Attribute   | Type   | Description                                                                              |
| ----------- | ------ | ---------------------------------------------------------------------------------------- |
| id\*        | String | Autogenerated identifier of object                                                       |
| name\*      | String | File name, defaults to filesystem name                                                   |
| uri\*       | String | Relative URI to the file servive which will return the bytestream                        |
| description | String | Description of file provided by [User](/developer-documentation/pass-core/model/user.md) |
| fileRole    | String | Role of the file ([*see list below*](#file-role-options))                                |
| mimeType    | String | Mime-type of file                                                                        |

| Relationship | Type   | Target                                                               | Description                      |
| ------------ | ------ | -------------------------------------------------------------------- | -------------------------------- |
| submission\* | To One | [Submission](/developer-documentation/pass-core/model/submission.md) | Submission the File is a part of |

\*required

## File role options

Status options for grant

| Value        | Description                                                                                          |
| ------------ | ---------------------------------------------------------------------------------------------------- |
| manuscript   | Author accepted manuscript                                                                           |
| supplemental | Supplemental material for the [Publication](/developer-documentation/pass-core/model/publication.md) |
| figure       | An image, data plot, map, or schematic                                                               |
| table        | Tabular data                                                                                         |