Linear API

https://studio.apollographql.com/public/Linear-API/variant/current/
Admin
A GraphQL API designed for programmatic interaction with Linear, a project management tool, enabling...
Tokens:199,926
Snippets:2,919
Trust Score:10
Update:1 week ago
Show doc for...
Tokens:
Raw
### query originPendingInstallations

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=Query.originPendingInstallations

Lists the Origin installations the current user started on Origin that no workspace has connected yet, matched by the user's email.

```APIDOC
## [QUERY] originPendingInstallations

### Description
[Internal] Lists the Origin installations the current user started on Origin that no workspace has connected yet, matched by the user's email.

### Method
QUERY

### Endpoint
https://api.linear.app/graphql

### Parameters
#### Query Parameters
- **query** (String) - Required - The GraphQL query string. The query should request the `originPendingInstallations` field.

### Request Example
```graphql
query ExampleQuery {
  originPendingInstallations {
    connectedToWorkspace
    installationId
    ownerSlug
    ownerType
    repositorySelection
  }
}
```

### Response
#### Success Response (200)
- **originPendingInstallations** (Array of OriginInstallationDetails) - List of pending Origin installations.
  - **connectedToWorkspace** (Boolean!) - Whether the installation is connected to a workspace.
  - **installationId** (String!) - The installation ID.
  - **ownerSlug** (String!) - The owner slug.
  - **ownerType** (String) - The owner type.
  - **repositorySelection** (String!) - The repository selection.

#### Response Example
```json
{
  "data": {
    "originPendingInstallations": [
      {
        "connectedToWorkspace": false,
        "installationId": "string",
        "ownerSlug": "string",
        "ownerType": "string",
        "repositorySelection": "string"
      }
    ]
  }
}
```
```

--------------------------------

### Query originInstallUrl

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AiConversationRemoveSpendLimitToolCall.args

GraphQL query to get the origin installation URL.

```APIDOC
## Query originInstallUrl

### Description
Retrieves the installation URL for the origin.

### Method
QUERY

### Endpoint
originInstallUrl

### Parameters
None

### Response
#### Success Response
- **OriginInstallUrlPayload!** - The installation URL payload.

```

--------------------------------

### originInstallUrl

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.executionSkippedReason

Returns the installation URL for the origin integration.

```APIDOC
## originInstallUrl

### Description
Returns the installation URL for the origin integration.

### Type
Query

### Arguments
None

### Returns
OriginInstallUrlPayload!
```

--------------------------------

### originPendingInstallations

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.executionSkippedReason

Returns a list of pending origin installations.

```APIDOC
## originPendingInstallations

### Description
Returns a list of pending origin installations.

### Type
Query

### Arguments
None

### Returns
[OriginInstallationDetails!]!
```

--------------------------------

### originInstallation

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.executionSkippedReason

Fetches details of a specific origin installation by its ID.

```APIDOC
## originInstallation

### Description
Fetches details of a specific origin installation by its ID.

### Type
Query

### Arguments
- **installationId** (String!) - Required - The ID of the installation.

### Returns
OriginInstallationDetails!
```

--------------------------------

### verifyGitHubEnterpriseServerInstallation

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.executionSkippedReason

Query to verify a GitHub Enterprise Server installation.

```APIDOC
## verifyGitHubEnterpriseServerInstallation

### Description
Query to verify a GitHub Enterprise Server installation.

### Type
GraphQL Query

### Arguments
- **integrationId** (String!) - Required - The ID of the integration.

### Return Type
GitHubEnterpriseServerInstallVerificationPayload!
```

--------------------------------

### Query originInstallation

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AiConversationRemoveSpendLimitToolCall.args

GraphQL query to fetch details of an origin installation.

```APIDOC
## Query originInstallation

### Description
Retrieves details of a specific origin installation.

### Method
QUERY

### Endpoint
originInstallation

### Parameters
#### Arguments
- **installationId** (String!) - Required - The ID of the installation.

### Response
#### Success Response
- **OriginInstallationDetails!** - Details of the installation.

```

--------------------------------

### Query originPendingInstallations

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AiConversationRemoveSpendLimitToolCall.args

GraphQL query to list all pending origin installations.

```APIDOC
## Query originPendingInstallations

### Description
Retrieves a list of pending origin installations.

### Method
QUERY

### Endpoint
originPendingInstallations

### Parameters
None

### Response
#### Success Response
- **[OriginInstallationDetails!]!** - List of pending installations.

```

--------------------------------

### verifyGitHubEnterpriseServerInstallation

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.content

Verifies a GitHub Enterprise Server installation.

```APIDOC
## verifyGitHubEnterpriseServerInstallation

### Description
Verifies a GitHub Enterprise Server installation.

### Method
QUERY

### Endpoint
verifyGitHubEnterpriseServerInstallation

### Parameters
#### Query Parameters
- **integrationId** (String!) - Required - The ID of the integration.

### Response
#### Success Response
- **result** (GitHubEnterpriseServerInstallVerificationPayload!) - Verification payload.

```

--------------------------------

### verifyGitHubEnterpriseServerInstallation

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.archivedAt

Query to verify a GitHub Enterprise Server installation by integration ID.

```APIDOC
## verifyGitHubEnterpriseServerInstallation

### Description
Verifies a GitHub Enterprise Server installation using the provided integration ID.

### Method
QUERY

### Endpoint
https://api.linear.app/graphql

### Parameters
#### Arguments
- **integrationId** (String!) - Required - The ID of the integration to verify.

### Response
#### Success Response
- Returns `GitHubEnterpriseServerInstallVerificationPayload!` - The verification payload.

```

--------------------------------

### Mutation.partnerApplicationCreate(input)

Source: https://studio.apollographql.com/public/Linear-API/variant/current/schema/reference/inputs/PartnerApplicationCreateInput

Submits a Startup Program partner application from the website, creating a triage issue for the startup team. Protected by reCAPTCHA.

```APIDOC
## Mutation.partnerApplicationCreate(input)

### Description
Submits a Startup Program partner application from the website, creating a triage issue for the startup team. Protected by reCAPTCHA.

### Method
Mutation

### Endpoint
partnerApplicationCreate(input)

### Parameters
#### Input Fields (PartnerApplicationCreateInput)
- **cohortsPerYear** (String) - Optional - Number of cohorts run per year (accelerators and programs).
- **companiesPerCohort** (String) - Optional - Number of companies per cohort (accelerators and programs).
- **consent** (Boolean!) - Required - Whether the applicant confirmed the distribution terms.
- **description** (String!) - Required - One-line description of what the organization does.
- **distributionChannels** ([String!]) - Optional - Channels the organization will use to distribute the offer.
- **email** (String!) - Required - Business email of the applicant.
- **fullName** (String!) - Required - Full name of the applicant.
- **investmentStages** ([String!]) - Optional - Stages the firm primarily invests at (venture capital firms).
- **networkSize** (String) - Optional - Number of active members or startups in the network (communities).
- **offersSoftwarePerks** (String) - Optional - Whether the organization already offers software perks from other companies.
- **organizationName** (String!) - Required - Name of the partner organization.
- **organizationType** (String!) - Required - Type of the partner organization (e.g., venture capital firm, accelerator).
- **organizationWebsite** (String!) - Required - Website of the partner organization.
- **otherPerks** (String) - Optional - Which other software perks the organization offers, when applicable.
- **portfolioCompanies** (String) - Optional - Number of active portfolio companies (venture capital firms).
- **region** (String!) - Required - Primary countries or regions the organization operates in.
- **role** (String!) - Required - The applicant's role or title at the organization.

### Response
Returns a payload with the result of the mutation. (Exact response fields not specified in source.)

### Authentication
Protected by reCAPTCHA.
```

--------------------------------

### ProjectCreateInput

Source: https://studio.apollographql.com/public/Linear-API/variant/current/schema/reference/inputs/ProjectCreateInput

Documentation for the ProjectCreateInput input object and the projectCreate mutation that uses it.

```APIDOC
## ProjectCreateInput

### Description
Input for creating a new project. A name and at least one team are required. All other fields are optional and will use defaults if not specified.

### Kind of Type
InputObject

### Fields
- **color** (String) - Optional - The color of the project.
- **content** (String) - Optional - The project content as markdown.
- **convertedFromIssueId** (String) - Optional - The ID of the issue that was converted into this project.
- **description** (String) - Optional - The description for the project.
- **icon** (String) - Optional - The icon of the project.
- **id** (String) - Optional - The identifier in UUID v4 format. If none is provided, the backend will generate one.
- **labelIds** ([String!]) - Optional - The identifiers of the project labels associated with this project.
- **lastAppliedTemplateId** (String) - Optional - The ID of the last template applied to the project.
- **leadId** (String) - Optional - The identifier of the project lead.
- **leadTeamId** (String) - Optional - [Internal] The identifier of the team that leads the project.
- **memberIds** ([String!]) - Optional - The identifiers of the members of this project.
- **name** (String!) - Required - The name of the project.
- **priority** (Int) - Optional - The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.
- **prioritySortOrder** (Float) - Optional - The sort order for the project within shared views, when ordered by priority.
- **sortOrder** (Float) - Optional - The sort order for the project within shared views.
- **startDate** (TimelessDate) - Optional - The planned start date of the project.
- **startDateResolution** (DateResolutionType) - Optional - The resolution of the project's start date.
- **state** (String) - Optional - [DEPRECATED] The state of the project. @deprecated(reason: Use statusId instead)
- **statusId** (String) - Optional - The ID of the project status.
- **targetDate** (TimelessDate) - Optional - The planned target date of the project.
- **targetDateResolution** (DateResolutionType) - Optional - The resolution of the project's estimated completion date.
- **teamIds** ([String!]!) - Required - The identifiers of the teams this project is associated with.
- **templateId** (String) - Optional - The ID of a project template to apply when creating the project. Overrides useDefaultTemplate if both are provided.
- **useDefaultTemplate** (Boolean) - Optional - When set to true, the default project template of the first team provided will be applied. If templateId is provided, this will be ignored.

### Used by
- Mutation.projectCreate(input)

### Mutation
#### projectCreate(input)
Creates a new project.
```

--------------------------------

### ssoUrlFromEmail

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=ProjectMilestoneFilter.createdAt

GraphQL query to get an SSO URL from an email address.

```APIDOC
## Query ssoUrlFromEmail

### Description
Generates an SSO URL from an email address.

### Method
QUERY

### Endpoint
https://api.linear.app/graphql

### Parameters
#### Query Parameters
- **email** (String!) - Required - The user's email.
- **type** (IdentityProviderType!) - Required - The identity provider type.
- **isDesktop** (Boolean) - Optional - Whether the request is from desktop.

### Response
#### Success Response
- **SsoUrlFromEmailResponse** - The SSO URL response.

### Example
```graphql
query {
  ssoUrlFromEmail(
    email: "user@example.com"
    type: GOOGLE
  ) {
    # fields
  }
}
```
```

--------------------------------

### Query: releaseNotes

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.archivedAt

Fetches a paginated list of release notes. Returns a ReleaseNoteConnection.

```APIDOC
## Query: releaseNotes

### Description
Fetches a paginated list of release notes. Returns a ReleaseNoteConnection.

### Method
Query

### Endpoint
releaseNotes

### Parameters
#### Query Parameters
- **after** (String) - Optional - Cursor for pagination.
- **before** (String) - Optional - Cursor for pagination.
- **filter** (ReleaseNoteFilter) - Optional - Filter to apply to the list.
- **first** (Int) - Optional - Number of items to return.
- **includeArchived** (Boolean) - Optional - Whether to include archived items.
- **last** (Int) - Optional - Number of items to return from the end.
- **orderBy** (PaginationOrderBy) - Optional - Ordering of the results.

### Response
#### Success Response
- **ReleaseNoteConnection** (object) - Paginated list of release notes.

#### Response Example
```graphql
{
  releaseNotes(first: 10) {
    nodes {
      id
      title
    }
  }
}
```
```

--------------------------------

### Query projectStatusProjectCount

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AiConversationRemoveSpendLimitToolCall.args

GraphQL query to get the number of projects for a status.

```APIDOC
## Query projectStatusProjectCount

### Description
Retrieves the count of projects with a given status.

### Method
QUERY

### Endpoint
projectStatusProjectCount

### Parameters
#### Arguments
- **id** (String!) - Required - The ID of the project status.

### Response
#### Success Response
- **ProjectStatusCountPayload!** - The count of projects.

```

--------------------------------

### Query projectFilterSuggestion

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AiConversationRemoveSpendLimitToolCall.args

GraphQL query to get a project filter suggestion.

```APIDOC
## Query projectFilterSuggestion

### Description
Provides a suggestion for a project filter based on a prompt.

### Method
QUERY

### Endpoint
projectFilterSuggestion

### Parameters
#### Arguments
- **prompt** (String!) - Required - The prompt for the suggestion.
- **teamId** (String) - Optional - The team ID to scope the suggestion.

### Response
#### Success Response
- **ProjectFilterSuggestionPayload!** - The filter suggestion.

```

--------------------------------

### Query partnerOfferWorkspaces

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AiConversationRemoveSpendLimitToolCall.args

GraphQL query to get workspaces for a partner offer.

```APIDOC
## Query partnerOfferWorkspaces

### Description
Retrieves workspaces associated with a partner offer using a token.

### Method
QUERY

### Endpoint
partnerOfferWorkspaces

### Parameters
#### Arguments
- **token** (String!) - Required - The token for the partner offer.

### Response
#### Success Response
- **PartnerOfferWorkspacesPayload** - Workspaces associated with the offer.

```

--------------------------------

### Mutation.initiativeCreate(input)

Source: https://studio.apollographql.com/public/Linear-API/variant/current/schema/reference/inputs/InitiativeCreateInput

Creates a new initiative using the provided InitiativeCreateInput. The input object contains all the properties for the new initiative.

```APIDOC
## Mutation.initiativeCreate(input)

### Description
Creates a new initiative.

### Input Object: InitiativeCreateInput

The properties of the initiative to create.

### Fields
- **color** (String) - The initiative's color.
- **content** (String) - The initiative's content in markdown format.
- **description** (String) - The description of the initiative.
- **icon** (String) - The initiative's icon.
- **id** (String) - The identifier in UUID v4 format. If none is provided, the backend will generate one.
- **labelIds** ([String!]) - The identifiers of the initiative labels associated with this initiative.
- **leadTeamId** (String) - The team that leads the initiative.
- **name** (String!) - The name of the initiative.
- **ownerId** (String) - The owner of the initiative.
- **priority** (Int) - The priority of the initiative. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.
- **prioritySortOrder** (Float) - The sort order of the initiative within the workspace, when ordered by priority.
- **sortOrder** (Float) - The sort order of the initiative within the workspace.
- **status** (InitiativeStatus) - The initiative's status.
- **targetDate** (TimelessDate) - The estimated completion date of the initiative.
- **targetDateResolution** (DateResolutionType) - The resolution of the initiative's estimated completion date.

### Example
graphql
mutation {
  initiativeCreate(input: {
    name: "New Initiative"
    description: "Description"
    priority: 2
  }) {
    # response fields
  }
}


```

--------------------------------

### releasePipelines(after: String, before: String, filter: ReleasePipelineFilter, first: Int, includeArchived: Boolean, last: Int, orderBy: PaginationOrderBy, sort: [ReleasePipelineSortInput!]): ReleasePipelineConnection!

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=ProjectMilestoneFilter.or

Retrieves a paginated list of release pipelines with optional filtering, ordering, and sorting.

```APIDOC
## releasePipelines(after: String, before: String, filter: ReleasePipelineFilter, first: Int, includeArchived: Boolean, last: Int, orderBy: PaginationOrderBy, sort: [ReleasePipelineSortInput!]): ReleasePipelineConnection!

### Description
Retrieves a paginated list of release pipelines with optional filtering, ordering, and sorting.

### Arguments
- **after** (String) - Optional - Cursor for pagination, returns items after this cursor.
- **before** (String) - Optional - Cursor for pagination, returns items before this cursor.
- **filter** (ReleasePipelineFilter) - Optional - Filter to apply to the list.
- **first** (Int) - Optional - Number of items to return from the start.
- **includeArchived** (Boolean) - Optional - Whether to include archived items.
- **last** (Int) - Optional - Number of items to return from the end.
- **orderBy** (PaginationOrderBy) - Optional - Ordering of the results.
- **sort** ([ReleasePipelineSortInput!]) - Optional - Sorting options for the results.

### Return Type
ReleasePipelineConnection!
```

--------------------------------

### Query rateLimitStatus

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AiConversationRemoveSpendLimitToolCall.args

GraphQL query to get the current rate limit status.

```APIDOC
## Query rateLimitStatus

### Description
Retrieves the current rate limit status.

### Method
QUERY

### Endpoint
rateLimitStatus

### Parameters
None

### Response
#### Success Response
- **RateLimitPayload!** - The rate limit status.

```

--------------------------------

### Query: integrationTemplates

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.contextualMetadata

Fetches a paginated list of integration templates.

```APIDOC
## Query integrationTemplates

### Description
Fetches a paginated list of integration templates.

### Method
query

### Endpoint
integrationTemplates

### Parameters
#### Query Parameters
- **after** (String) - Optional - Cursor for pagination.
- **before** (String) - Optional - Cursor for pagination.
- **first** (Int) - Optional - Number of items to return.
- **includeArchived** (Boolean) - Optional - Include archived templates.
- **last** (Int) - Optional - Number of items to return from the end.
- **orderBy** (PaginationOrderBy) - Optional - Ordering of results.

### Response
#### Success Response
- **IntegrationTemplateConnection** - The result of the query.
```

--------------------------------

### Query organizationInviteDetails

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AiConversationRemoveSpendLimitToolCall.args

GraphQL query to get detailed information about an organization invite.

```APIDOC
## Query organizationInviteDetails

### Description
Retrieves detailed information about an organization invite.

### Method
QUERY

### Endpoint
organizationInviteDetails

### Parameters
#### Arguments
- **id** (String!) - Required - The ID of the organization invite.

### Response
#### Success Response
- **OrganizationInviteDetailsPayload!** - Detailed invite information.

```

--------------------------------

### Query: initiativeToProjects

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.contextualMetadata

Fetches a paginated list of initiative-to-project links.

```APIDOC
## Query initiativeToProjects

### Description
Fetches a paginated list of initiative-to-project links.

### Method
query

### Endpoint
initiativeToProjects

### Parameters
#### Query Parameters
- **after** (String) - Optional - Cursor for pagination.
- **before** (String) - Optional - Cursor for pagination.
- **first** (Int) - Optional - Number of items to return.
- **includeArchived** (Boolean) - Optional - Include archived links.
- **last** (Int) - Optional - Number of items to return from the end.
- **orderBy** (PaginationOrderBy) - Optional - Ordering of results.

### Response
#### Success Response
- **InitiativeToProjectConnection** - The result of the query.
```

--------------------------------

### Query releasePipelineByAccessKey

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AiConversationRemoveSpendLimitToolCall.args

GraphQL query to get the release pipeline for the current access key.

```APIDOC
## Query releasePipelineByAccessKey

### Description
Retrieves the release pipeline associated with the current access key.

### Method
QUERY

### Endpoint
releasePipelineByAccessKey

### Parameters
None

### Response
#### Success Response
- **AccessKeyReleasePipeline!** - The release pipeline for the access key.

```

--------------------------------

### Query: slaConfigurations

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.archivedAt

Fetches SLA configurations for a team. Returns a list of SlaConfiguration objects.

```APIDOC
## Query: slaConfigurations

### Description
Fetches SLA configurations for a team. Returns a list of SlaConfiguration objects.

### Method
Query

### Endpoint
slaConfigurations

### Parameters
#### Query Parameters
- **teamId** (String!) - Required - The ID of the team.

### Response
#### Success Response
- **SlaConfiguration** (list) - List of SLA configurations.

#### Response Example
```graphql
{
  slaConfigurations(teamId: "team-id") {
    id
    name
  }
}
```
```

--------------------------------

### ssoUrlFromEmail

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=IssueSearchResult.labels

GraphQL query to get an SSO URL for a user based on email and identity provider type.

```APIDOC
## Query: ssoUrlFromEmail

### Description
Generates an SSO URL for a user based on email and identity provider.

### Method
QUERY

### Endpoint
https://api.linear.app/graphql

### Parameters
#### Query Parameters
- **email** (String!) - Required - The user's email.
- **type** (IdentityProviderType!) - Required - The identity provider type.
- **isDesktop** (Boolean) - Optional - Whether the request is from desktop.

### Response
#### Success Response
- **SsoUrlFromEmailResponse** - The SSO URL response.
```

--------------------------------

### releaseNotes(after: String, before: String, filter: ReleaseNoteFilter, first: Int, includeArchived: Boolean, last: Int, orderBy: PaginationOrderBy): ReleaseNoteConnection!

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=ProjectMilestoneFilter.or

Retrieves a paginated list of release notes with optional filtering and ordering.

```APIDOC
## releaseNotes(after: String, before: String, filter: ReleaseNoteFilter, first: Int, includeArchived: Boolean, last: Int, orderBy: PaginationOrderBy): ReleaseNoteConnection!

### Description
Retrieves a paginated list of release notes with optional filtering and ordering.

### Arguments
- **after** (String) - Optional - Cursor for pagination, returns items after this cursor.
- **before** (String) - Optional - Cursor for pagination, returns items before this cursor.
- **filter** (ReleaseNoteFilter) - Optional - Filter to apply to the list.
- **first** (Int) - Optional - Number of items to return from the start.
- **includeArchived** (Boolean) - Optional - Whether to include archived items.
- **last** (Int) - Optional - Number of items to return from the end.
- **orderBy** (PaginationOrderBy) - Optional - Ordering of the results.

### Return Type
ReleaseNoteConnection!
```

--------------------------------

### ExampleQuery

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=Query.release

The page contains a single query example named ExampleQuery. No code body is displayed in the source, only the query name is shown.

```graphql
ExampleQuery
```

--------------------------------

### ExampleQuery

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=Query.issues

An example GraphQL query demonstrating how to fetch archived integrations, archived teams, and audit entry types from the Linear API.

```APIDOC
## Query ExampleQuery

### Description
An example GraphQL query that retrieves archived integrations, archived teams, and audit entry types from the Linear API.

### Operation
query ExampleQuery {
  archivedIntegrations {
    archivedAt
  }
  archivedTeams {
    agentAutomationEnabled
  }
  auditEntryTypes {
    description
  }
}

### Response
#### Success Response
- **archivedIntegrations** (ArchivedIntegrationsConnection) - Contains archived integrations with their archivedAt timestamps.
- **archivedTeams** (ArchivedTeamsConnection) - Contains archived teams with their agentAutomationEnabled flag.
- **auditEntryTypes** (AuditEntryTypeConnection) - Contains audit entry types with their descriptions.
```

--------------------------------

### Query: integrationsSettings

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.contextualMetadata

Fetches integration settings by ID.

```APIDOC
## Query integrationsSettings

### Description
Fetches integration settings by ID.

### Method
query

### Endpoint
integrationsSettings

### Parameters
#### Query Parameters
- **id** (String!) - Required - The ID of the integration settings.

### Response
#### Success Response
- **IntegrationsSettings** - The integration settings.
```

--------------------------------

### GraphQL query: ExampleQuery for archived integrations and teams

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.sentAt

Query the archivedIntegrations and archivedTeams fields with their archivedAt timestamps. Use this as a starting point for exploring archived data in the Linear API.

```GraphQL
query ExampleQuery {
  archivedIntegrations {
    archivedAt
  }
  archivedTeams {
    archivedAt
  }
}
```

--------------------------------

### Query: integrations

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.contextualMetadata

Fetches a paginated list of integrations.

```APIDOC
## Query integrations

### Description
Fetches a paginated list of integrations.

### Method
query

### Endpoint
integrations

### Parameters
#### Query Parameters
- **after** (String) - Optional - Cursor for pagination.
- **before** (String) - Optional - Cursor for pagination.
- **first** (Int) - Optional - Number of items to return.
- **includeArchived** (Boolean) - Optional - Include archived integrations.
- **last** (Int) - Optional - Number of items to return from the end.
- **orderBy** (PaginationOrderBy) - Optional - Ordering of results.

### Response
#### Success Response
- **IntegrationConnection** - The result of the query.
```

--------------------------------

### releaseSearch

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=Query.releaseSearch

Search releases with optional text matching against name, version, and pipeline name. When no search term is provided, returns releases ordered by stage priority (started > planned > completed > canceled).

```APIDOC
## releaseSearch

### Description
Search releases with optional text matching against name, version, and pipeline name. When no search term is provided, returns releases ordered by stage priority (started > planned > completed > canceled).

### Type
[Release!]!

### Arguments
- **filter** (ReleaseFilter) - Optional - Filter for releases.
- **first** (Int) - Optional - Number of results to return. Default: 20.
- **term** (String) - Optional - Text to search for in name, version, and pipeline name.

### Return Type
[Release!]!

### Release Type Fields
- **archivedAt** (DateTime) - Timestamp when the release was archived.
- **autoArchivedAt** (DateTime) - Timestamp when the release was auto-archived.
- **canceledAt** (DateTime) - Timestamp when the release was canceled.
- **commitSha** (String) - Commit SHA associated with the release.
- **completedAt** (DateTime) - Timestamp when the release was completed.
- **createdAt** (DateTime!) - Timestamp when the release was created.
- **creator** (User) - User who created the release.
- **currentProgress** (JSONObject!) - Current progress of the release.
- **description** (String) - Description of the release.
- **documents** (DocumentConnection!) - Documents associated with the release. Arguments: after, before, filter, first, includeArchived, last, orderBy.
- **history** (ReleaseHistoryConnection!) - History of the release. Arguments: after, before, first, includeArchived, last, orderBy.
- **id** (ID!) - Unique identifier of the release.
- **issueCount** (Int!) - Number of issues in the release. Arguments: includeArchived.
- **issues** (IssueConnection!) - Issues associated with the release. Arguments: after, before, filter, first, includeArchived, last, orderBy.
- **links** (EntityExternalLinkConnection!) - External links associated with the release. Arguments: after, before, first, includeArchived, last, orderBy.
- **name** (String!) - Name of the release.
- **pipeline** (ReleasePipeline!) - Pipeline the release belongs to.
- **progressHistory** (JSONObject!) - Progress history of the release.
- **releaseNote** (ReleaseNote) - Release note associated with the release.
- **releaseNotes** ([ReleaseNote!]!) - Release notes associated with the release.
- **slugId** (String!) - Slug identifier of the release.
- **stage** (ReleaseStage!) - Current stage of the release.
- **startDate** (TimelessDate) - Start date of the release.
- **startedAt** (DateTime) - Timestamp when the release was started.
- **targetDate** (TimelessDate) - Target date of the release.
- **trashed** (Boolean) - Whether the release is trashed.
- **updatedAt** (DateTime!) - Timestamp when the release was last updated.
- **url** (String!) - URL of the release.
- **version** (String) - Version of the release.

### Example Query
```graphql
query ExampleQuery {
  releaseSearch(filter: {}, first: 20, term: "") {
    id
    name
    version
    stage
  }
}
```
```

--------------------------------

### Query: releasePipelines

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.archivedAt

Fetches a paginated list of release pipelines. Returns a ReleasePipelineConnection.

```APIDOC
## Query: releasePipelines

### Description
Fetches a paginated list of release pipelines. Returns a ReleasePipelineConnection.

### Method
Query

### Endpoint
releasePipelines

### Parameters
#### Query Parameters
- **after** (String) - Optional - Cursor for pagination.
- **before** (String) - Optional - Cursor for pagination.
- **filter** (ReleasePipelineFilter) - Optional - Filter to apply to the list.
- **first** (Int) - Optional - Number of items to return.
- **includeArchived** (Boolean) - Optional - Whether to include archived items.
- **last** (Int) - Optional - Number of items to return from the end.
- **orderBy** (PaginationOrderBy) - Optional - Ordering of the results.
- **sort** ([ReleasePipelineSortInput!]) - Optional - Sorting options.

### Response
#### Success Response
- **ReleasePipelineConnection** (object) - Paginated list of release pipelines.

#### Response Example
```graphql
{
  releasePipelines(first: 10) {
    nodes {
      id
      name
    }
  }
}
```
```

--------------------------------

### Query applicationInfo

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.ephemeral

Returns application information for a given client ID.

```APIDOC
## Query applicationInfo

### Description
Returns application information for a given client ID.

### Method
Query

### Endpoint
applicationInfo

### Parameters
#### Query Parameters
- **clientId** (String!) - Required - The client ID of the application.

### Response
#### Success Response
- **Application!** - The application information.

#### Response Example
```json
{
  "data": {
    "applicationInfo": {
      "id": "app-id"
    }
  }
}
```
```

--------------------------------

### GraphQL query: releaseNote(id: String!)

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=Query.releaseNote

Fetches a release note by its UUID or slug identifier. The query requires the id argument of type String! and returns a ReleaseNote object. The example is named ExampleQuery in the Explorer.

```GraphQL
query ExampleQuery {
  releaseNote(id: "") {
    id
    title
    url
  }
}
```

--------------------------------

### Query: templates

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.archivedAt

Fetches all templates. Returns a list of Template objects.

```APIDOC
## Query: templates

### Description
Fetches all templates. Returns a list of Template objects.

### Method
Query

### Endpoint
templates

### Parameters
None

### Response
#### Success Response
- **Template** (list) - List of all templates.

#### Response Example
```graphql
{
  templates {
    id
    name
  }
}
```
```

--------------------------------

### ExampleQuery: releaseSearch GraphQL query

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=Query.releaseSearch

GraphQL query that searches releases with optional text matching against name, version, and pipeline name. When no search term is provided, returns releases ordered by stage priority (started > planned > completed > canceled).

```GraphQL
query ExampleQuery {
  releaseSearch(first: 20) {
    id
    name
    version
    stage
    pipeline {
      id
      name
    }
  }
}
```

--------------------------------

### query organizationInvites

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=Query.organizationInvites

Fetches all pending and accepted invites for the workspace. Supports pagination and ordering.

```APIDOC
## [QUERY] organizationInvites

### Description
Returns all pending and accepted invites for the workspace.

### Method
QUERY

### Endpoint
https://api.linear.app/graphql

### Operation
organizationInvites

### Arguments
#### Query Parameters
- **after** (String) - Optional - Returns the elements in the list that come after the specified cursor.
- **before** (String) - Optional - Returns the elements in the list that come before the specified cursor.
- **first** (Int) - Optional - The number of items to return from the start of the list.
- **includeArchived** (Boolean) - Optional - Whether to include archived items.
- **last** (Int) - Optional - The number of items to return from the end of the list.
- **orderBy** (PaginationOrderBy) - Optional - The order in which to return the items.

### Response
#### Success Response
- **edges** ([OrganizationInviteEdge!]!) - The list of edges in the connection.
- **nodes** ([OrganizationInvite!]!) - The list of nodes in the connection.
- **pageInfo** (PageInfo!) - Information to aid in pagination.

### Response Example
{
  "data": {
    "organizationInvites": {
      "edges": [
        {
          "node": {
            "id": "string",
            "email": "string",
            "role": "ADMIN",
            "createdAt": "2023-01-01T00:00:00Z"
          }
        }
      ],
      "pageInfo": {
        "hasNextPage": false,
        "hasPreviousPage": false
      }
    }
  }
},
```

```APIDOC
## [QUERY] organizationInvites

### Description
Fetches all pending and accepted invites for the workspace.

### Method
QUERY

### Endpoint
https://api.linear.app/graphql

### Parameters
#### Query Parameters
- **after** (String) - Optional - A cursor to fetch results after a specific position.
- **before** (String) - Optional - A cursor to fetch results before a specific position.
- **first** (Int) - Optional - The number of results to fetch from the beginning of the list.
- **includeArchived** (Boolean) - Optional - Whether to include archived invites.
- **last** (Int) - Optional - The number of results to fetch from the end of the list.
- **orderBy** (PaginationOrderBy) - Optional - The order in which to return results.

### Request Example
```graphql
query {
  organizationInvites(after: "...", before: "...", first: 10, includeArchived: false, last: 10, orderBy: createdAt) {
    edges {
      node {
        id
        email
        role
        createdAt
      }
    }
    nodes {
      id
      email
      role
      createdAt
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }
  }
}
```

### Response
#### Success Response (200)
- **data.organizationInvites** (OrganizationInviteConnection) - The connection object containing the invites.
  - **edges** ([OrganizationInviteEdge!]!) - A list of edges, each containing a node and a cursor.
  - **nodes** ([OrganizationInvite!]!) - A list of organization invite nodes.
  - **pageInfo** (PageInfo!) - Information about pagination in a connection.

#### Response Example
{
  "data": {
    "organizationInvites": {
      "edges": [
        {
          "node": {
            "id": "string",
            "email": "string",
            "role": "ADMIN",
            "createdAt": "2023-01-01T00:00:00Z"
          }
        }
      ],
      "pageInfo": {
        "hasNextPage": false,
        "hasPreviousPage": false
      }
    }
  }
}
```

--------------------------------

### projects(after: String, before: String, filter: ProjectFilter, first: Int, includeArchived: Boolean, last: Int, orderBy: PaginationOrderBy, sort: [ProjectSortInput!]): ProjectConnection!

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=ProjectMilestoneFilter.or

Retrieves a paginated list of projects with optional filtering, ordering, and sorting.

```APIDOC
## projects(after: String, before: String, filter: ProjectFilter, first: Int, includeArchived: Boolean, last: Int, orderBy: PaginationOrderBy, sort: [ProjectSortInput!]): ProjectConnection!

### Description
Retrieves a paginated list of projects with optional filtering, ordering, and sorting.

### Arguments
- **after** (String) - Optional - Cursor for pagination, returns items after this cursor.
- **before** (String) - Optional - Cursor for pagination, returns items before this cursor.
- **filter** (ProjectFilter) - Optional - Filter to apply to the list.
- **first** (Int) - Optional - Number of items to return from the start.
- **includeArchived** (Boolean) - Optional - Whether to include archived items.
- **last** (Int) - Optional - Number of items to return from the end.
- **orderBy** (PaginationOrderBy) - Optional - Ordering of the results.
- **sort** ([ProjectSortInput!]) - Optional - Sorting options for the results.

### Return Type
ProjectConnection!
```

--------------------------------

### releases(after: String, before: String, filter: ReleaseFilter, first: Int, includeArchived: Boolean, last: Int, orderBy: PaginationOrderBy, sort: [ReleaseSortInput!]): ReleaseConnection!

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=ProjectMilestoneFilter.or

Retrieves a paginated list of releases with optional filtering, ordering, and sorting.

```APIDOC
## releases(after: String, before: String, filter: ReleaseFilter, first: Int, includeArchived: Boolean, last: Int, orderBy: PaginationOrderBy, sort: [ReleaseSortInput!]): ReleaseConnection!

### Description
Retrieves a paginated list of releases with optional filtering, ordering, and sorting.

### Arguments
- **after** (String) - Optional - Cursor for pagination, returns items after this cursor.
- **before** (String) - Optional - Cursor for pagination, returns items before this cursor.
- **filter** (ReleaseFilter) - Optional - Filter to apply to the list.
- **first** (Int) - Optional - Number of items to return from the start.
- **includeArchived** (Boolean) - Optional - Whether to include archived items.
- **last** (Int) - Optional - Number of items to return from the end.
- **orderBy** (PaginationOrderBy) - Optional - Ordering of the results.
- **sort** ([ReleaseSortInput!]) - Optional - Sorting options for the results.

### Return Type
ReleaseConnection!
```

--------------------------------

### Query: integration

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.contextualMetadata

Fetches an integration by ID.

```APIDOC
## Query integration

### Description
Fetches an integration by ID.

### Method
query

### Endpoint
integration

### Parameters
#### Query Parameters
- **id** (String!) - Required - The ID of the integration.

### Response
#### Success Response
- **Integration** - The integration.
```

--------------------------------

### Query: releaseStages

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.archivedAt

Fetches a paginated list of release stages. Returns a ReleaseStageConnection.

```APIDOC
## Query: releaseStages

### Description
Fetches a paginated list of release stages. Returns a ReleaseStageConnection.

### Method
Query

### Endpoint
releaseStages

### Parameters
#### Query Parameters
- **after** (String) - Optional - Cursor for pagination.
- **before** (String) - Optional - Cursor for pagination.
- **filter** (ReleaseStageFilter) - Optional - Filter to apply to the list.
- **first** (Int) - Optional - Number of items to return.
- **includeArchived** (Boolean) - Optional - Whether to include archived items.
- **last** (Int) - Optional - Number of items to return from the end.
- **orderBy** (PaginationOrderBy) - Optional - Ordering of the results.

### Response
#### Success Response
- **ReleaseStageConnection** (object) - Paginated list of release stages.

#### Response Example
```graphql
{
  releaseStages(first: 10) {
    nodes {
      id
      name
    }
  }
}
```
```

--------------------------------

### Mutation.webhookCreate(input)

Source: https://studio.apollographql.com/public/Linear-API/variant/current/schema/reference/inputs/WebhookCreateInput

Documentation for the webhookCreate mutation and its input type WebhookCreateInput.

```APIDOC
## Mutation.webhookCreate(input)

### Description
Creates a new webhook subscription for the workspace. Requires specifying a URL, resource types to subscribe to, and either a specific team or all public teams.

### Method
Mutation

### Endpoint
webhookCreate(input)

### Parameters
#### Input Fields (WebhookCreateInput)
- **allPublicTeams** (Boolean) - Optional - Whether this webhook is enabled for all public teams.
- **enabled** (Boolean) - Optional - Whether this webhook is enabled.
- **id** (String) - Optional - The identifier in UUID v4 format. If none is provided, the backend will generate one.
- **label** (String) - Optional - Label for the webhook.
- **resourceTypes** ([String!]!) - Required - List of resources the webhook should subscribe to.
- **secret** (String) - Optional - A secret token used to sign the webhook payload.
- **teamId** (String) - Optional - The identifier or key of the team associated with the Webhook.
- **url** (String!) - Required - The URL that will be called on data changes.

### Request Example
```graphql
mutation {
  webhookCreate(input: {
    url: "https://example.com/webhook",
    resourceTypes: ["Issue"],
    teamId: "team-id",
    enabled: true,
    label: "My Webhook",
    secret: "secret-token"
  }) {
    # response fields
  }
}
```

### Response
#### Success Response
Returns the created webhook payload. The exact response fields are not specified in the source.

#### Response Example
```json
{
  "data": {
    "webhookCreate": {
      "success": true
    }
  }
}
```
```

--------------------------------

### project

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.executionSkippedReason

Fetches a single project by its ID.

```APIDOC
## project

### Description
Fetches a single project by its ID.

### Type
Query

### Arguments
- **id** (String!) - Required - The ID of the project.

### Returns
Project!
```

--------------------------------

### templates

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.content

Fetches all templates.

```APIDOC
## templates

### Description
Fetches all templates.

### Method
QUERY

### Endpoint
templates

### Parameters
None

### Response
#### Success Response
- **result** ([Template!]!) - List of all templates.

```

--------------------------------

### Mutation.agentActivityCreatePrompt(input)

Source: https://studio.apollographql.com/public/Linear-API/variant/current/schema/reference/inputs/AgentActivityCreatePromptInput

Creates a prompt agent activity from Linear user input. This mutation is protected by reCAPTCHA.

```APIDOC
## [POST] /graphql

### Description
Creates a prompt agent activity from Linear user input. This mutation is protected by reCAPTCHA.

### Method
POST

### Endpoint
/graphql

### Parameters
#### Request Body
- **input** (AgentActivityCreatePromptInput!) - Required - The input object for creating a prompt agent activity.

### Request Example
```graphql
mutation {
  agentActivityCreatePrompt(input: {
    agentSessionId: "string",
    content: {
      // AgentActivityPromptCreateInputContent fields
    },
    contextualMetadata: {},
    id: "string",
    queued: false,
    signal: "",
    signalMetadata: {},
    sourceCommentId: "string"
  }) {
    // response fields
  }
}
```

### Response
#### Success Response (200)
- **agentActivityCreatePrompt** (AgentActivityPayload) - The created agent activity.

#### Response Example
```json
{
  "data": {
    "agentActivityCreatePrompt": {
      // AgentActivityPayload fields
    }
  }
}
```

```

--------------------------------

### releaseStages

Source: https://studio.apollographql.com/public/Linear-API/variant/current/explorer?searchQuery=AgentActivity.content

Fetches a paginated list of release stages with optional filtering and ordering.

```APIDOC
## releaseStages

### Description
Fetches a paginated list of release stages with optional filtering and ordering.

### Method
QUERY

### Endpoint
releaseStages

### Parameters
#### Query Parameters
- **after** (String) - Optional - Cursor for pagination.
- **before** (String) - Optional - Cursor for pagination.
- **filter** (ReleaseStageFilter) - Optional - Filter for release stages.
- **first** (Int) - Optional - Number of results to return.
- **includeArchived** (Boolean) - Optional - Include archived items.
- **last** (Int) - Optional - Number of results to return from the end.
- **orderBy** (PaginationOrderBy) - Optional - Ordering of results.

### Response
#### Success Response
- **result** (ReleaseStageConnection!) - Paginated list of release stages.

```
Tokens:
Raw