airbyte/docs/ai-agents/connectors/linear/REFERENCE.md

Linear

Supported Entities and Actions

Entity	Actions
Issues	List, Get
Projects	List, Get
Teams	List, Get

Issues

Issues List

Returns a paginated list of issues via GraphQL with pagination support

Python SDK

linear.issues.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "issues",
    "action": "list"
}'

Params

Parameter Name	Type	Required	Description
first	integer	No	Number of items to return (max 250)
after	string	No	Cursor to start after (for pagination)

Response Schema

Records

Field Name	Type	Description
data	object

Issues Get

Get a single issue by ID via GraphQL

Python SDK

linear.issues.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "issues",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Params

Parameter Name	Type	Required	Description
id	string	Yes	Issue ID

Response Schema

Records

Field Name	Type	Description
data	object

Projects

Projects List

Returns a paginated list of projects via GraphQL with pagination support

Python SDK

linear.projects.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "projects",
    "action": "list"
}'

Params

Parameter Name	Type	Required	Description
first	integer	No	Number of items to return (max 250)
after	string	No	Cursor to start after (for pagination)

Response Schema

Records

Field Name	Type	Description
data	object

Projects Get

Get a single project by ID via GraphQL

Python SDK

linear.projects.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "projects",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Params

Parameter Name	Type	Required	Description
id	string	Yes	Project ID

Response Schema

Records

Field Name	Type	Description
data	object

Teams

Teams List

Returns a list of teams via GraphQL with pagination support

Python SDK

linear.teams.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "teams",
    "action": "list"
}'

Params

Parameter Name	Type	Required	Description
first	integer	No	Number of items to return (max 250)
after	string	No	Cursor to start after (for pagination)

Response Schema

Records

Field Name	Type	Description
data	object

Teams Get

Get a single team by ID via GraphQL

Python SDK

linear.teams.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "teams",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Params

Parameter Name	Type	Required	Description
id	string	Yes	Team ID

Response Schema

Records

Field Name	Type	Description
data	object

Authentication

The Linear connector supports the following authentication methods:

Authentication

Field Name	Type	Required	Description
api_key	str	Yes	API authentication key

Example

Python SDK

LinearConnector(
  auth_config=LinearAuthConfig(
    api_key="<API authentication key>"
  )
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/instances' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
  "connector_definition_id": "1c5d8316-ed42-4473-8fbc-2626f03f070c",
  "auth_config": {
    "api_key": "<API authentication key>"
  },
  "name": "My Linear Connector"
}'