{"id":23967,"library":"linear-api","title":"Linear API Python Client","description":"A set of Python utilities for calling the Linear API. Current version 0.2.0, supports Python >=3.9. Development is active but the library is still early-stage.","status":"active","version":"0.2.0","language":"python","source_language":"en","source_url":"https://github.com/ShoggothAI/linear-api","tags":["linear","api","client","project-management"],"install":[{"cmd":"pip install linear-api","lang":"bash","label":"Install via pip"}],"dependencies":[],"imports":[{"note":"Old or incorrect class name; the correct class is LinearAPI.","wrong":"from linear_api import LinearClient","symbol":"LinearAPI","correct":"from linear_api import LinearAPI"},{"symbol":"LinearIssue","correct":"from linear_api import LinearIssue"}],"quickstart":{"code":"from linear_api import LinearAPI\nimport os\n\nclient = LinearAPI(api_key=os.environ.get('LINEAR_API_KEY', ''))\nme = client.viewer()\nprint(f\"Hello {me['name']}\")\n","lang":"python","description":"Initialize the client with your API key and fetch the current user."},"warnings":[{"fix":"Pin to a specific version, e.g., pip install linear-api==0.2.0, and check the changelog before upgrading.","message":"The API is in early development (v0.x). There may be breaking changes between minor versions without deprecation warnings.","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Use 'from linear_api import ...' (underscore).","message":"The module name uses an underscore: linear_api, not linear-api. Importing from 'linear-api' (with a hyphen) will fail.","severity":"gotcha","affected_versions":"all"},{"fix":"Use LinearAPI(api_key='...') instead of LinearAPI(token='...').","message":"The constructor argument 'token' was renamed to 'api_key' in v0.2.0.","severity":"deprecated","affected_versions":"0.2.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run: pip install linear-api, then import as 'from linear_api import LinearAPI'.","cause":"Installed package 'linear-api' but tried to import 'linear-api' (with hyphen) or haven't installed at all.","error":"ModuleNotFoundError: No module named 'linear_api'"},{"fix":"Use: LinearAPI(api_key='your_key')","cause":"Using old parameter name 'token' which was renamed to 'api_key' in v0.2.0.","error":"linear_api.LinearAPI.__init__() got an unexpected keyword argument 'token'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}