> ## Documentation Index
> Fetch the complete documentation index at: https://developers.getfernand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Linear properties

Retrieves all available Linear properties needed.
Returns a 404 error if the Linear integration is not configured for the organization.


## OpenAPI

````yaml https://api.getfernand.com/openapi.json get /integrations/linear/properties
openapi: 3.0.3
info:
  title: Fernand API Documentation
  version: '3.0'
  description: This is the documentation for the [Fernand](https://getfernand.com) API.
  termsOfService: https://getfernand.com/terms
  contact:
    name: Fernand Support
    url: https://getfernand.com
    email: support@getfernand.com
  x-logo:
    url: https://app.getfernand.com/images/favicon/icon_128.png
servers:
  - url: https://api.getfernand.com
    description: ''
    x-last-modified: 1764750693905
security:
  - apiKeyHeader: []
externalDocs:
  description: You can access our documentation online by visiting https://api.fernand.help
  url: https://api.fernand.help
paths:
  /integrations/linear/properties:
    get:
      tags:
        - Linear Integration
      summary: Get Linear properties
      description: >-
        Retrieves all available Linear properties needed.

        Returns a 404 error if the Linear integration is not configured for the
        organization.
      operationId: getLinearProperties
      responses:
        '200':
          description: Linear properties retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      states:
                        type: array
                        description: >-
                          List of available workflow states (excluding completed
                          and canceled states).
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: Unique identifier of the workflow state.
                              example: 8a7b93d1-18f7-4a9f-b5c6-3e2d1f9a8c7b
                            name:
                              type: string
                              description: Name of the workflow state.
                              example: In Progress
                            type:
                              type: string
                              description: >-
                                Type of the workflow state (triage, backlog,
                                unstarted, started).
                              example: started
                            color:
                              type: string
                              description: Color hex code of the workflow state.
                              example: '#f2c94c'
                            position:
                              type: number
                              description: Position order of the state in the workflow.
                              example: 2
                            team_id:
                              type: string
                              description: ID of the team this state belongs to.
                              example: 7b8c9d0e-1f2a-3b4c-5d6e-7f8a9b0c1d2e
                      priorities:
                        type: array
                        description: List of available issue priorities.
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              description: >-
                                Priority level (0=No priority, 1=Urgent, 2=High,
                                3=Medium, 4=Low).
                              example: 1
                            name:
                              type: string
                              description: Display name of the priority level.
                              example: Urgent
                      users:
                        type: array
                        description: List of assignable users in the organization.
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: >-
                                Unique identifier of the user (null for
                                "Unassigned" option).
                              example: 9c0d1e2f-3a4b-5c6d-7e8f-9a0b1c2d3e4f
                            name:
                              type: string
                              description: Display name of the user.
                              example: Richard Hendricks
                            avatar_url:
                              type: string
                              description: >-
                                URL to the user's avatar image (null for
                                "Unassigned" option).
                              example: https://avatar.linear.app/9c0d1e2f
                      labels:
                        type: array
                        description: List of available issue labels.
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: Unique identifier of the label.
                              example: 0d1e2f3a-4b5c-6d7e-8f9a-0b1c2d3e4f5a
                            color:
                              type: string
                              description: Color hex code of the label.
                              example: '#5e6ad2'
                            name:
                              type: string
                              description: Name of the label.
                              example: Bug
                            team_id:
                              type: string
                              description: >-
                                ID of the team this label belongs to (null if
                                organization-wide).
                              example: 7b8c9d0e-1f2a-3b4c-5d6e-7f8a9b0c1d2e
                      teams:
                        type: array
                        description: List of teams in the organization.
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: Unique identifier of the team.
                              example: 7b8c9d0e-1f2a-3b4c-5d6e-7f8a9b0c1d2e
                            name:
                              type: string
                              description: Name of the team.
                              example: Engineering
                      projects:
                        type: array
                        description: List of available projects.
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: >-
                                Unique identifier of the project (null for "No
                                project" option).
                              example: 1e2f3a4b-5c6d-7e8f-9a0b-1c2d3e4f5a6b
                            name:
                              type: string
                              description: Name of the project.
                              example: Q1 2026 Roadmap
                            teams:
                              type: array
                              description: >-
                                Array of team IDs this project belongs to (null
                                for "No project" option).
                              items:
                                type: string
                              example:
                                - 7b8c9d0e-1f2a-3b4c-5d6e-7f8a9b0c1d2e
        '400':
          description: Error loading data from Linear.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: >-
                      An unknown error occured while trying to load data on
                      Linear
        '404':
          description: Linear integration not found for this organization.
components:
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      description: >-
        Authenticate your account by including your secret key in API requests.

        You can manage your API keys in the
        [Dashboard](https://app.getfernand.com/).


        Authentication to the API is performed by using the HTTP Header
        X-API-Key.
      name: X-API-Key
      in: header
      x-last-modified: 1764750344730

````