Create project

• Authorization

  string

  header

  required

  Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

• name

  string

  required
• description

  string | null
• icon

  string | null

  Linear project icon identifier (Linear's internal icon set, no public list). Echo back a value from a previous response or the dashboard.

• color

  string | null

  Hex color in #RRGGBB or #RGB form.

• state

  enum<string>

  Lifecycle category. Distinct from linear_status_id, which selects a specific status within the category.

  One of:

  backlog

  planned

  started

  completed

  canceled
• team_id

  string

  required

  Linear team id. Fetch from GET /me under linear_team_ids.

• linear_status_id

  string

  Linear project status id. Fetch from GET /projects/statuses.

• is_visible

  boolean

  Whether the project is shown on the customer portal. Defaults to hidden.

• portal_instance_ids

  string[]

  Every portal the item is on, from GET /portal/instances. Use "__main__" for the Main portal. Replaces the current list. The item shows on these portals only while is_visible is true.

Successful response

• id

  string

  required
• name

  string

  required
• description

  string | null

  required
• color

  string | null

  required
• icon

  string | null

  required

  Name of a Nucleo icon (PascalCase, e.g. Notepad, Atom). Must be a valid icon from https://nucleoapp.com - unknown names will not render in the dashboard or portal.

• state

  string | null

  required
• progress

  number | null

  required
• sort_order

  number

  required
• total_score

  number

  required
• is_visible

  boolean | null

  required
• portal_instance_ids

  string[]

  required
• created_at

  string

  required
• updated_at

  string

  required
• linear_project_id

  string | null

  required
• linear_team_ids

  string[]

  required
• linear_team_names

  string[]

  required