Get contents of multiple files in a single request

POST

/api/v4/projects/{id}/repository/blobs/batch

• GitLab REST API

Each blob is truncated to the first 1 MB; the truncated field indicates when this happens.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

One of:

string

string

integer

integer

The ID or URL-encoded path of the project

Example

1

Request Body^required

Media typeapplication/json

object

files

required

Array of file objects to retrieve (max 20)

Array<object>

nullable

object

path

required

The file path

string

nullable

Example

app/models/user.rb

ref

The branch, tag, or commit. Defaults to the default branch

string

nullable

Example

main

Responses

200

OK

Media typeapplication/json

object

path

string

ref

string

size

integer

truncated

boolean

encoding

string

content

string

Example

{
  "path": "app/models/user.rb",
  "ref": "main",
  "size": 1476,
  "truncated": false,
  "encoding": "base64",
  "content": "VGhpcyBpcyBhIGZpbGU="
}

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found