linear

Use the bundled Python CLI: run `python3 scripts/linear_api.py create-issue --title "Your title" --team ENG --priority 2`. Alternatively, send a GraphQL `issueCreate` mutation with curl to https://api.linear.app/graphql using your LINEAR_API_KEY as the Authorization header.

Create a personal API key in Linear Settings under Account > Security & access, then set it as the LINEAR_API_KEY environment variable. Pass it directly in the Authorization header with no Bearer prefix.

First query the team's workflow states to get the target state's UUID, then call the `issueUpdate` mutation with that stateId. The Python helper's `update-status` command resolves state names to UUIDs automatically.

Yes. Extract the trailing hex slugId from the document URL and filter the documents collection with `slugId: { eq: ... }`, since the `document(id:)` query only accepts UUIDs. The helper's `get-document` command handles both forms.

Linear allows 5,000 requests per hour and 3,000,000 complexity points per hour per API key. Use `first: N` to limit result sizes and monitor the X-RateLimit-Requests-Remaining response header.

GraphQL APIs return HTTP 200 even when the query fails, placing error details in the response's `errors` array. Always inspect that array before using the `data` payload.