Get the metadata and contents of requested files

POST

/repos/{owner}/{repo}/file-contents

curl --request POST \
  --url https://gitea.com/api/v1/repos/example/example/file-contents \
  --header 'Authorization: Basic <credentials>' \
  --header 'Content-Type: application/json' \
  --data '{ "files": [ "example" ] }'

Uses automatic pagination based on default page size and max response size and returns the maximum allowed number of files. Files which could not be retrieved are null. Files which are too large are being returned with encoding == null, content == null and size > 0, they can be requested separately by using the download_url.

Authorizations

• BasicAuth
• Token
• AccessToken
• AuthorizationHeaderToken
• SudoParam
• SudoHeader
• TOTPHeader

Parameters

Path Parameters

owner

required

string

Owner of the repo

repo

required

string

Name of the repo

Query Parameters

ref

string

The name of the commit/branch/tag. Default to the repository’s default branch.

Request Body

GetFilesOptions options for retrieving metadate and content of multiple files

object

files

Array<string>

Example^generated

{
  "files": [
    "example"
  ]
}

GetFilesOptions options for retrieving metadate and content of multiple files

object

files

Array<string>

Responses

200

ContentsListResponse

Media typeapplication/json

Array<object>

ContentsResponse contains information about a repo’s entry’s (dir, file, symlink, submodule) metadata and content

object

_links

FileLinksResponse contains the links for a repo’s file

object

git

string

html

string

self

string

content

content is populated when type is file, otherwise null

string

download_url

string

encoding

encoding is populated when type is file, otherwise null

string

git_url

string

html_url

string

last_author_date

string format: date-time

last_commit_sha

string

last_committer_date

string format: date-time

name

string

path

string

sha

string

size

integer format: int64

submodule_git_url

submodule_git_url is populated when type is submodule, otherwise null

string

target

target is populated when type is symlink, otherwise null

string

type

type will be file, dir, symlink, or submodule

string

url

string

Example^generated

[
  {
    "_links": {
      "git": "example",
      "html": "example",
      "self": "example"
    },
    "content": "example",
    "download_url": "example",
    "encoding": "example",
    "git_url": "example",
    "html_url": "example",
    "last_author_date": "2026-04-15T12:00:00Z",
    "last_commit_sha": "example",
    "last_committer_date": "2026-04-15T12:00:00Z",
    "name": "example",
    "path": "example",
    "sha": "example",
    "size": 1,
    "submodule_git_url": "example",
    "target": "example",
    "type": "example",
    "url": "example"
  }
]

404

APINotFound is a not found empty response

Media typeapplication/json