Skip to content
Skribly Docs

Create an issue

POST
/issues
curl --request POST \
  --url http://localhost:8100/api/v1/issues \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "title": "example", "description": "example", "type": "task", "priority": "lowest", "status": "example", "assignee": "example", "parent": "example", "labels": [ "example" ], "estimate_hours": 1, "due_date": "2026-04-15", "project": "WEB" }'

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
title
required
string
<= 255 characters
description

Markdown

string | null
type
string
Allowed values: task bug feature
priority
string
Allowed values: lowest low medium high urgent
status

Status id or name

string
assignee

me, a user id or e-mail, or null

string | null
parent

Parent issue key in the same project

string | null
labels

Label names; unknown ones are created

Array<string>
estimate_hours
number | null
due_date
string | null format: date
project
required

Project key or id

string

Responses

Section titled “Responses”

201

Section titled “201”

Created

Media typeapplication/json
object
data
object
id
integer
key
string
number
integer
title
string
description
string
type
object
id
required
string
name
required
string
current
boolean
status
object
id
integer
name
string
category
string
Allowed values: todo in_progress done
priority
object
id
required
string
name
required
string
current
boolean
labels
Array<string>
assignee
object
id
integer
name
string
email
string format: email
reporter
object
id
integer
name
string
email
string format: email
project
object
id
integer
key
string
name
string
parent
object
key
string
title
string
subtasks
Array<object>
object
key
string
title
string
status
string
estimate_hours
number | null
spent_hours
number
due_date
string | null format: date
url
string format: uri
created_at
string format: date-time
updated_at
string format: date-time
closed_at
string | null format: date-time
comments

Only on GET /issues/{key}

Array<object>
object
id
integer
author
object
id
integer
name
string
body

Markdown

string
created_at
string format: date-time
updated_at
string format: date-time
attachments

Only on GET /issues/{key}

Array<object>
object
id
integer
name
string
size
integer
type
string
url
string format: uri

Example 

{
  "data": {
    "key": "WEB-12",
    "status": {
      "category": "todo"
    }
  }
}

403

Section titled “403”

The role or the token’s abilities do not allow it

Media typeapplication/json
object
message
string
errors
object
key
additional properties
Array<string>

Example generated

{
  "message": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  }
}

422

Section titled “422”

Invalid input

Media typeapplication/json
object
message
string
errors
object
key
additional properties
Array<string>

Example generated

{
  "message": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  }
}