Skip to main content
POST
/
projects
Create project
curl --request POST \
  --url https://productlane.com/api/v2/projects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "team_id": "<string>",
  "description": "<string>",
  "icon": "<string>",
  "color": "<string>",
  "linear_status_id": "<string>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "color": "<string>",
  "icon": "<string>",
  "state": "<string>",
  "progress": 123,
  "sort_order": 123,
  "created_at": "<string>",
  "updated_at": "<string>",
  "linear_project_id": "<string>",
  "linear_team_ids": [
    "<string>"
  ],
  "linear_team_names": [
    "<string>"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://productlane.mintlify.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
name
string
required
Minimum string length: 1
​
team_id
string
required

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

Minimum string length: 1
​
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.

Required string length: 1 - 64
​
color
string | null

Hex color in #RRGGBB or #RGB form.

Pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
​
state
enum<string>

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

Available options:
backlog,
planned,
started,
completed,
canceled
​
linear_status_id
string

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

Response

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
​
created_at
string
required
​
updated_at
string
required
​
linear_project_id
string | null
required
​
linear_team_ids
string[]
required
​
linear_team_names
string[]
required