Linear API: GraphQL errors return 200 OK, check the errors array

TL;DR

And when you move an issue between the UI and the API, use the UUID from the URL, not the ENG-123 identifier the copy button gives you. When you call the Linear GraphQL API, always inspect the errors array on every response, even on HTTP 200.

Steps

1. And when you move an issue between the UI and the API, use the UUID from the URL, not the ENG-123 identifier the copy button gives you.
2. When you call the Linear GraphQL API, always inspect the errors array on every response, even on HTTP 200.

When to use

You are seeing this: When you call the Linear GraphQL API, always inspect the errors array on every response, even on HTTP 200. Use this skill when you run into "Linear API: GraphQL errors return 200 OK, check the errors array".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Edge cases

• Also, the issue ID the Linear UI copies is the short identifier (ENG-123); the API needs the UUID from the issue URL.

Source: Linear API notes (rebar wiki, quoting API behavior): GraphQL errors return 200 OK with an errors array, so checking HTTP status alone misses failures. Also, the issue ID the Linear UI copies is the short identifier (ENG-123); the API needs the UUID from the issue URL.

Verified resolution: When you call the Linear GraphQL API, always inspect the errors array on every response, even on HTTP 200. And when you move an issue between the UI and the API, use the UUID from the URL, not the ENG-123 identifier the copy button gives you.

Source URL: https://github.com/spotcircuit/rebar/blob/HEAD/wiki/patterns/linear-api.md