Return failure_reason in Jobs API

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

  • Close this issue

Problem to solve

The current GET /projects/:id/jobs/:job_id returns a generic status filed, e.g. "status": "failed". The UI shows a more detailed message, e.g. There has been a runner system failure, please try again. Internally this detailed message seems to be available in failure_reason, but this field is not exposed in the REST API.

Intended users

Further details

Users who want to analyze the cause of failing builds are helped with more detailed information.

Proposal

Expose failure_reason in applicable REST API endpoints like GET /projects/:id/jobs/:job_id.

Permissions and Security

Documentation

The documentation at https://docs.gitlab.com/ee/api/jobs.html needs to be updated. The example output screens should show the new filed.

Testing

What does success look like, and how can we measure that?

What is the type of buyer?

Links / references

Edited Aug 28, 2025 by 🤖 GitLab Bot 🤖
Assignee Loading
Time tracking Loading