---
title: "Create Issue"
method: POST
path: "/api/repos/{namespace}/{repository}/issues"
tags: ["issues"]
---

# Create Issue

`POST /api/repos/{namespace}/{repository}/issues`

## Request

- Base URL: `https://api.git.mari.zip` (the document declares no server; this is the origin it was published from)
- URL: `https://api.git.mari.zip/api/repos/{namespace}/{repository}/issues`
- Auth: API key in cookie `gitarena-session`
- TypeScript: <https://skmtc.dev/mari/apis/gitarena/docs/api/repos/:namespace/:repository/issues/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `namespace` string, required
- `repository` string, required

## Request body

- CreateIssueRequest
  - `assignees` string[], nullable
  - `body` string, required
  - `labels` string[], nullable
  - `milestoneId` string, uuid, nullable
  - `priority` string, nullable
  - `title` string, required

## Response `201`

Issue created

- IssueResponse
  - `assignee_ids` string[], required
  - `assignees` string[], required
  - `author_id` string, uuid, required
  - `author_username` string, required
  - `body` string, required
  - `comment_count` integer, required
  - `git_bug_id` string, required
  - `id` string, uuid, required
  - `index` integer, required
  - `labels` string[], required
  - `milestone` MilestoneBrief
    - `closed` boolean, required
    - `due_date` string, date-time, nullable
    - `id` string, uuid, required
    - `title` string, required
  - `priority` string, required
  - `reactions` ReactionGroup[], required
    - `count` integer, required
    - `emoji` string, required
    - `reacted` boolean, required
  - `status` 'open' | 'in_progress' | 'completed' | 'not_planned', required
  - `title` string, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Invalid request
- `401`: Authentication required
- `404`: Repository not found or access denied

## Changes

- **2026-10-29** `efaeb85ac1be`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mari/apis/gitarena/changes/api/repos/:namespace/:repository/issues/post.md)

---

[API](https://skmtc.dev/mari/apis/gitarena.md) - [All operations](https://skmtc.dev/mari/apis/gitarena/llms.txt) - [OpenAPI document](https://skmtc.dev/mari/apis/gitarena/revisions/437eec085d26?raw)