---
title: "Create an issue"
method: POST
path: "/api/v1/projects/{project_id}/sprints/{sprint_id}/issues"
tags: ["Issues"]
---

# Create an issue

`POST /api/v1/projects/{project_id}/sprints/{sprint_id}/issues`

## Request

- Base URL: `https://sprintflint.com`
- URL: `https://sprintflint.com/api/v1/projects/{project_id}/sprints/{sprint_id}/issues`
- Auth: API key in header `X-API-Token`

Creates a new issue (ticket) in the sprint

## Request body

- object
  - `issue` object
    - `title` string, required: Issue title
    - `description` string: Issue description
    - `status` 'backlog' | 'todo' | 'in_progress' | 'done' | 'cancelled': Issue status
    - `story_points` integer: Story points estimate
    - `assignee_id` integer: Assignee account ID

## Response `201`

issue created

- Issue
  - `id` integer, required
  - `title` string, required
  - `description` string, nullable
  - `status` 'backlog' | 'todo' | 'in_progress' | 'done' | 'cancelled', required
  - `story_points` integer, nullable
  - `position` integer, required
  - `issue_number` string, nullable
  - `sprint_id` integer, required
  - `assignee_id` integer, nullable
  - `started_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: validation errors

---

[API](https://skmtc.dev/sprintflint/apis/sprintflint-api.md) · [All operations](https://skmtc.dev/sprintflint/apis/sprintflint-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sprintflint/apis/sprintflint-api/revisions/3d4ea91ea0ca?raw)