Skip to content
Try Gitea Cloud ☁️ for 30 days → Accelerate your Development & Deploys!
GiteaGitea Documentation
This is the documentation of the next version, still under development. See the latest release.

Create a column in a project

POST
/repos/{owner}/{repo}/projects/{id}/columns
curl --request POST \
  --url https://gitea.com/api/v1/repos/example/example/projects/1/columns \
  --header 'Authorization: Basic <credentials>' \
  --header 'Content-Type: application/json' \
  --data '{ "color": "example", "title": "example" }'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
owner
required
string

Owner of the repo

repo
required
string

Name of the repo

id
required
integer format: int64

Id of the project

Request Body

Section titled “Request Body”
Media typeapplication/json

CreateProjectColumnOption represents options for creating a project column

object
color

Column color in 6-digit hex format, e.g. #FF0000

string
title
required
string
Examplegenerated
{
  "color": "example",
  "title": "example"
}

Responses

Section titled “Responses”

201

Section titled “201”

ProjectColumn

Media typeapplication/json

ProjectColumn represents a project column (board)

object
color
string
created_at
string format: date-time
creator

User represents a user

object
active

Is user active

boolean
avatar_url

URL to the user’s avatar

string format: uri
created
string format: date-time
description

The user’s description

string
email
string format: email
followers_count

User counts

integer format: int64
following_count
integer format: int64
full_name

The user’s full name

string
html_url

URL to the user’s gitea page

string format: uri
id

The user’s id

integer format: int64
is_admin

Is the user an administrator

boolean
language

User locale

string
last_login
string format: date-time
location

The user’s location

string
login

Login of the user, same as username

string
login_name

Identifier of the user, provided by the external authenticator (if configured)

string
prohibit_login

Is user login prohibited

boolean
restricted

Is user restricted

boolean
source_id

The ID of the user’s Authentication Source

integer format: int64
starred_repos_count
integer format: int64
visibility

User visibility level option: public, limited, private

string
Allowed values: public limited private
website

The user’s website

string
default
boolean
id
integer format: int64
project_id
integer format: int64
sorting
integer format: int64
title
string
updated_at

Null only for legacy rows that carry no update timestamp

string format: date-time
Example
{
  "creator": {
    "visibility": "public"
  }
}

403

Section titled “403”

APIForbiddenError is a forbidden error response

Headers

Section titled “Headers”
message
string
url
string

404

Section titled “404”

APINotFound is a not found empty response

422

Section titled “422”

APIValidationError is error format response related to input validation

Headers

Section titled “Headers”
message
string
url
string

423

Section titled “423”

APIRepoArchivedError is an error that is raised when an archived repo should be modified

Headers

Section titled “Headers”
message
string
url
string