Skip to content

Retrieve job artifacts

GET
/api/v4/projects/{id}/jobs/artifacts/{ref_name}/download

Retrieves the artifacts archive for the latest successful job on a specified branch or tag.

id
required
One of:
string

The ID or URL-encoded path of the project

ref_name
required
string

Branch or tag name in repository. HEAD or SHA references are not supported.

job
required
string
nullable

The name of the job.

job_token
string
nullable

To be used with triggers for multi-project pipelines, available only on Premium and Ultimate tiers.

search_recent_successful_pipelines
boolean
nullable

Search across recent successful pipelines instead of just the latest one.

OK

Bad Request

Unauthorized

Forbidden

Not found