Skip to main content
GET
/
projects
/
{project_reference}
/
files
List Project Files
curl --request GET \
  --url https://api.veryfront.com/projects/{project_reference}/files \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "path": "<string>",
      "content": "<string>",
      "size": 123,
      "type": "page",
      "updated_at": "<string>",
      "id": "<string>",
      "version_id": "<string>",
      "checksum": "<string>",
      "_links": {
        "self": {
          "href": "<string>"
        }
      }
    }
  ],
  "page_info": {
    "self": "<string>",
    "first": null,
    "next": "<string>",
    "prev": "<string>"
  },
  "_links": {}
}

Authorizations

Authorization
string
header
required

Authentication via JWT token or API key. JWT: Get from Veryfront dashboard. API Key: Format "vf__" - create via /api-keys endpoint.

Path Parameters

project_reference
string
required

Project ID or slug

Query Parameters

pattern
string

File pattern filter (e.g., *.tsx)

cursor
string

Cursor for pagination

limit
number
default:100

Number of items per page (default: 100, max: 100)

Required range: 1 <= x <= 100
sort_by
string
default:updated_at

Field to sort by (default: updated_at)

sort_order
enum<string>
default:desc

Sort direction (default: desc)

Available options:
asc,
desc
branch
string

Branch name or ID (omit for main branch)

fields
string

Sparse fieldset filter per Zalando #157. Examples: (id,name), (id,files(path)), !(content)

Example:

"(id,path,type,size)"

Response

Paginated list of files (supports sparse fieldsets per Zalando #157)

data
object[]
required
page_info
object
required

Hypermedia links for resource navigation