# File an issue

**POST** `/v1/issues`

**Operation ID**: `create_14`
**Summary**: File an issue
Files a new issue on the organization's board. Search first and update an existing issue instead of filing a duplicate; this call never matches existing issues.

## Tags
- Issues
## Request Body

**Content-Type**: `application/json`

**Schema**: `CreateIssueRequest`

## Responses

### 200

Issue filed

- **Content-Type**: `application/json` / `Issue`
### 400

Invalid issue, or a field only people may set

- **Content-Type**: `application/json` / `IssueErrorResponse`
### 401

Unauthorized

### 403

No permission to file issues, or to share them with the given teams

- **Content-Type**: `application/json` / `IssueErrorResponse`