List all files in an artifacts archive

GET

/api/v4/projects/{id}/jobs/{job_id}/artifacts/tree

• GitLab REST API

Lists all files in a specified artifacts archive without extracting them.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

One of:

string

string

integer

integer

The ID or URL-encoded path of the project

job_id

required

integer

ID of a job

Example

42

Query Parameters

path

string

"" nullable

Path to browse in the artifacts archive. Defaults to root directory.

Example

coverage/reports

recursive

boolean

nullable

If true, return all entries recursively.

Example

false

job_token

string

nullable

CI/CD job token for multi-project pipelines. Premium and Ultimate only.

page

integer

default: 1 nullable

Current page number

Example

1

per_page

integer

default: 20 nullable

Number of items per page

Example

20

Responses

200

OK

Media type application/json

object

name

string

path

string

type

string

size

integer

mode

string

Example

{
  "name": "index.html",
  "path": "coverage/index.html",
  "type": "file",
  "size": 12345,
  "mode": "100644"
}

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not found