GIgitlab
job_artifacts

List all files in an artifacts archive

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

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

Request

  • Base URL
    https://gitlab.com
  • Auth
    none declared

Path parameters

idstring required

The ID or URL-encoded path of the project

job_idinteger required

ID of a job

Query parameters

pathstring

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

recursiveboolean

If true, return all entries recursively.

job_tokenstring

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

pageinteger

Current page number

per_pageinteger

Number of items per page

Response

List all files in an artifacts archive

namestring required
pathstring required
type'file' | 'directory' required
sizeinteger
modestring required

Example response

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

Changes

No recorded changes to this operation across all 5 revisions of this API.