> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List release files

> List release files.

`releaseFiles(projectReference: String!, releaseReference: String!, pattern: String, limit: Int, cursor: String, sortBy: ReleaseFileSortBy, sortOrder: ReleaseFileSortOrder, includeServerFunctions: Boolean, fields: String): ReleaseFilePage!`

Requires project.read.

## Arguments

| Argument | Type | Required | Description |
| - | - | - | - |
| `projectReference` | [`String!`](https://veryfront.com/docs/cloud/graphql/types/string) | Yes | Project UUID, slug or configured domain. |
| `releaseReference` | [`String!`](https://veryfront.com/docs/cloud/graphql/types/string) | Yes | Release ID, latest or a version specifier. |
| `pattern` | [`String`](https://veryfront.com/docs/cloud/graphql/types/string) | No | File glob, for example pages/\*\*. |
| `limit` | [`Int`](https://veryfront.com/docs/cloud/graphql/types/int) | No | Files per page, between 1 and 100. Defaults to 100. |
| `cursor` | [`String`](https://veryfront.com/docs/cloud/graphql/types/string) | No | pageInfo.endCursor of the previous page. |
| `sortBy` | [`ReleaseFileSortBy`](https://veryfront.com/docs/cloud/graphql/types/releasefilesortby) | No | Sort field. Defaults to updated\_at. Default: `"updated_at"`. |
| `sortOrder` | [`ReleaseFileSortOrder`](https://veryfront.com/docs/cloud/graphql/types/releasefilesortorder) | No | Sort direction. Defaults to desc. Default: `"desc"`. |
| `includeServerFunctions` | [`Boolean`](https://veryfront.com/docs/cloud/graphql/types/boolean) | No | Set to false to read server-function source only as an editor. Omit to use the rule every GraphQL file read uses. |
| `fields` | [`String`](https://veryfront.com/docs/cloud/graphql/types/string) | No | Accepted as on REST, for example (id,path,size); the selection set chooses the fields GraphQL serves. |

## Response

Returns [`ReleaseFilePage!`](https://veryfront.com/docs/cloud/graphql/types/releasefilepage). Open the type for its fields and nested types.

| Field | Type | Description |
| - | - | - |
| `data` | [`[ReleaseFile!]!`](https://veryfront.com/docs/cloud/graphql/types/releasefile) | Files of this page. |
| `pageInfo` | [`PageInfo!`](https://veryfront.com/docs/cloud/graphql/types/pageinfo) | Continue from endCursor while hasNextPage is true. |
| `releaseId` | [`ID!`](https://veryfront.com/docs/cloud/graphql/types/id) | ID of the release. |
| `releaseVersion` | [`String`](https://veryfront.com/docs/cloud/graphql/types/string) | Version of the release, or null for a release created before versioning. |
| `links` | [`JSON`](https://veryfront.com/docs/cloud/graphql/types/json) | Links to this release file list. |

Types marked with `!` cannot be null. Lists use `[Type]` notation. The [type index](https://veryfront.com/docs/cloud/graphql/schema.md) lists all published input and response types.

## Example

```graphql title="query.graphql" theme={null}
query ReleaseFiles($projectReference: String!, $releaseReference: String!, $pattern: String, $limit: Int, $cursor: String, $sortBy: ReleaseFileSortBy, $sortOrder: ReleaseFileSortOrder, $includeServerFunctions: Boolean, $fields: String) {
  releaseFiles(projectReference: $projectReference, releaseReference: $releaseReference, pattern: $pattern, limit: $limit, cursor: $cursor, sortBy: $sortBy, sortOrder: $sortOrder, includeServerFunctions: $includeServerFunctions, fields: $fields) {
    links
    releaseId
    releaseVersion
    data {
      id
      updatedAt
      content
      links
      path
    }
    pageInfo {
      hasNextPage
      endCursor
      hasPreviousPage
      startCursor
    }
  }
}
```

```json title="variables.json" theme={null}
{
  "projectReference": "00000000-0000-4000-8000-000000000001",
  "releaseReference": "example"
}
```

<details>
  <summary>Try this query</summary>

  Calls use `https://api.veryfront.com/graphql`. Replace sample values with resources you can access. See [Authentication](https://veryfront.com/docs/cloud/authentication.md) for credentials and permissions.

  Bearer token or API key

  Stored in this tab's session. Clear credential

  Query

  Variables (JSON)
</details>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.