Repository files API

GET /projects/:id/repository/files/:file_path/blame
AttributeTypeRequiredDescription
idinteger or stringyesThe ID or URL-encoded path of the project owned by the authenticated user.
file_pathstringyesURL-encoded full path to new file, such aslib%2Fclass%2Erb.
refstringyesThe name of branch, tag or commit.
range[end]integeryesThe last line of the range to blame.
range[start]integeryesThe first line of the range to blame.
rangehashnoBlame range.
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/13083/repository/files/path%2Fto%2Ffile.rb/blame?ref=master"
Example response:
[
    "commit": {
      "id": "d42409d56517157c48bf3bd97d3f75974dde19fb",
      "message": "Add feature\n\nalso fix bug\n",
      "parent_ids": [
        "cc6e14f9328fa6d7b5a0d3c30dc2002a3f2a3822"
      "authored_date": "2015-12-18T08:12:22.000Z",
      "author_name": "John Doe",
      "author_email": "john.doe@example.com",
      "committed_date": "2015-12-18T08:12:22.000Z",
      "committer_name": "John Doe",
      "committer_email": "john.doe@example.com"
    "lines": [
      "require 'fileutils'",
      "require 'open3'",
HEAD method returns just file metadata, as in Get file from repository.

HTTP/1.1 200 OK
X-Gitlab-Blob-Id: 79f7bbd25901e8334750839545a9bd021f0e4c83
X-Gitlab-Commit-Id: d5a3ff139356ce33e37e73add446f16869741b50
X-Gitlab-Content-Sha256: 4c294617b60715c1d218e61164a3abd4808a4284cbc30e6728a01ad9aada4481
X-Gitlab-Encoding: base64
X-Gitlab-File-Name: file.rb
X-Gitlab-File-Path: path/to/file.rb
X-Gitlab-Last-Commit-Id: 570e7b2abdd848b95f2f578043fc23bd6f6fd24d
X-Gitlab-Ref: master
X-Gitlab-Size: 1476
X-Gitlab-Execute-Filemode: false

GET /projects/:id/repository/files/:file_path/raw
AttributeTypeRequiredDescription
idinteger or stringyesThe ID or URL-encoded path of the project owned by the authenticated user.
file_pathstringyesURL-encoded full path to new file, such as lib%2Fclass%2Erb.
refstringyesThe name of branch, tag or commit. Default is the HEAD of the project.
lfsbooleannoDetermines if the response should be Git LFS file contents, rather than the pointer. If the file is not tracked by Git LFS, ignored. Defaults to false.
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/13083/repository/files/app%2Fmodels%2Fkey%2Erb/raw?ref=master"
Like Get file from repository, you can use HEAD to get just file metadata.

POST /projects/:id/repository/files/:file_path
AttributeTypeRequiredDescription
branchstringyesName of the new branch to create. The commit is added to this branch.
commit_messagestringyesThe commit message.
contentstringyesThe file’s content.
file_pathstringyesURL-encoded full path to new file. For example: lib%2Fclass%2Erb.
idinteger or stringyesThe ID or URL-encoded path of the project owned by the authenticated user.
author_emailstringnoThe commit author’s email address.
author_namestringnoThe commit author’s name.
encodingstringnoChange encoding to base64. Default is text.
execute_filemodebooleannoEnables or disables the execute flag on the file. Can be true or false.
start_branchstringnoName of the base branch to create the new branch from.
curl --request POST --header 'PRIVATE-TOKEN: <your_access_token>' \
     --header "Content-Type: application/json" \
     --data '{"branch": "master", "author_email": "author@example.com", "author_name": "Firstname Lastname",
               "content": "some content", "commit_message": "create a new file"}' \
     "https://gitlab.example.com/api/v4/projects/13083/repository/files/app%2Fproject%2Erb"
Example response:
{
  "file_path": "app/project.rb",
  "branch": "master"
Update existing file in repository
The execute_filemode parameter was introduced in GitLab 14.10.