Create issue

Create an issue, filed in Linear first and mirrored to Productlane. Requires Linear to be connected and the issues:write scope.

POST /issues

Create issue

cURL

curl --request POST \
  --url https://productlane.com/api/v2/issues \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "team_id": "<string>",
  "state_id": "<string>",
  "description": "<string>",
  "project_id": "<string>",
  "assignee_id": "<string>",
  "label_ids": [
    "<string>"
  ]
}
'

200

{
  "id": "<string>",
  "identifier": "<string>",
  "title": "<string>",
  "description": "<string>",
  "priority": "<string>",
  "status": "<string>",
  "linear_team_id": "<string>",
  "url": "<string>",
  "project_id": "<string>",
  "sort_order": 123,
  "created_at": "<string>",
  "updated_at": "<string>",
  "linear_ticket_id": "<string>"
}

Authorizations

Authorization · string · header · required

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

Body

application/json

title · 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

state_id · string · required

Linear workflow state id. Fetch from GET /issues/workflow-states?team_id=....

Minimum string length: 1

priority · Option 1 · enum<number> Option 2 · enum<number> Option 3 · enum<number> Option 4 · enum<number> Option 5 · enum<number> · required

Linear issue priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.

Available options: 0

description · string

project_id · string

Linear project id to attach the issue to.

assignee_id · string

Linear user id of the assignee.

label_ids · string[]

Linear label ids to attach.

Response

200

application/json

Successful response

id · string · required

identifier · string · required

title · string · required

description · string | null · required

priority · string · required

status · string · required

linear_team_id · string · required

url · string · required

project_id · string | null · required

sort_order · number · required

created_at · string · required

updated_at · string · required

linear_ticket_id · string · required