API Change: Pipeline Error Response Format Update
We’ve updated how pipeline errors are returned in the CircleCI API.
What’s changing
Previously, related lines from a single config error were returned as separate objects in the errors array:
"errors": [
{ "type": "config-deprecated-syntax", "message": "Error calling workflow: 'build-test-deploy'" },
{ "type": "config-deprecated-syntax", "message": "Error calling job: 'buggy-orb/exhibit-bug'" },
{ "type": "config-deprecated-syntax", "message": "Referred to a variable that does not exist" }
]
Going forward, all lines belonging to the same error are consolidated into a single object, with lines separated by a newline character (\n):
"errors": [
{ "type": "config-deprecated-syntax", "message": "Error calling workflow: 'build-test-deploy'\nError calling job: 'buggy-orb/exhibit-bug'\nReferred to a variable that does not exist" }
]
Why we’re making this change
This consolidation lays the groundwork for returning multiple distinct errors in a single response. Soon, if your config has more than one unrelated issue, you’ll see each as a separate object in the errors array — so you can identify and fix all problems at once, rather than triggering your pipeline multiple times.
What you need to do
If your code parses the errors array, verify it handles multi-line message values correctly. The number of objects in the array will now reflect the number of distinct errors, not the number of individual error lines.
Affected APIs
v2:
GET /api/v2/pipeline
GET /api/v2/pipeline/{pipeline-id}
GET /api/v2/project/{project-slug}/pipeline
GET /api/v2/project/{project-slug}/pipeline/mine
GET /api/v2/project/{project-slug}/pipeline/{pipeline-number}
v3:
GET /api/v3/runs
GET /api/v3/runs/search
GET /api/v3/runs/{id}
We’ve updated how pipeline errors are returned in the CircleCI API.
What’s changingPreviously, related lines from a single config error were returned as separate objects in the errors array:
"errors": [
{ "type": "config-deprecated-syntax", "message": "Error calling workflow: 'build-test-deploy'" },
{ "type": "config-deprecated-syntax", "message": "Error calling job: 'buggy-orb/exhibit-bug'" },
{ "type": "config-deprecated-syntax", "message": "Referred to a variable that does not exist" }
]
Going forward, all lines belonging to the same error are consolidated into a single object, with lines separated by a newline character (\n):
"errors": [
{ "type": "config-deprecated-syntax", "message": "Error calling workflow: 'build-test-deploy'\nError calling job: 'buggy-orb/exhibit-bug'\nReferred to a variable that does not exist" }
]
Why we’re making this changeThis consolidation lays the groundwork for returning multiple distinct errors in a single response. Soon, if your config has more than one unrelated issue, you’ll see each as a separate object in the errors array — so you can identify and fix all problems at once, rather than triggering your pipeline multiple times.
If your code parses the errors array, verify it handles multi-line message values correctly. The number of objects in the array will now reflect the number of distinct errors, not the number of individual error lines.
v2:
GET /api/v2/pipelineGET /api/v2/pipeline/{pipeline-id}GET /api/v2/project/{project-slug}/pipelineGET /api/v2/project/{project-slug}/pipeline/mineGET /api/v2/project/{project-slug}/pipeline/{pipeline-number}v3:
GET /api/v3/runsGET /api/v3/runs/searchGET /api/v3/runs/{id}| # | Наименование новости | Тональность | Информативность | Дата публикации |
|---|---|---|---|---|
| 1 | The new Pipelines page is now live for all users | 0 | 6.33 | 29-06-2026 |
| 2 | Hosted MCP server now available | 0 | 6.31 | 14-09-2026 |
| 3 | Deprecation of GraphQL Unstable API - January 1st, 2027 | 0 | 10.55 | 03-09-2026 |
| 4 | OAuth 2.0 API Access with Dynamic Client Registration | 0 | 9.68 | 12-08-2026 |
| 5 | Missing docs - V2 API tests endpoint | 0 | 14.38 | 21-08-2026 |
| 6 | New CLI flag: circleci run get --failure-report | 0 | 7.17 | 31-07-2026 |
| 7 | Fix with Claude Code now available from more places in the CircleCI UI | 0 | 5.17 | 12-08-2026 |
| 8 | Fix failing workflows with Claude Code, directly from the CircleCI UI | 0 | 15.94 | 06-08-2026 |
| 9 | Customise pipelines vie | 0 | 19.59 | 09-08-2026 |
| 10 | Workflow cancellation display status reliability improvements | 0 | 6.31 | 02-07-2026 |