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.

Edit a project column

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

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
org
required
string

Name of the organization

id
required
integer format: int64

Id of the project

column_id
required
integer format: int64

Id of the column

Request Body

Section titled “Request Body”
Media typeapplication/json

EditProjectColumnOption represents options for editing a project column

object
color

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

string
sorting

Position of the column within the project, between -128 and 127

integer format: int64
title
string
Examplegenerated
{
  "color": "example",
  "sorting": 1,
  "title": "example"
}

Responses

Section titled “Responses”

200

Section titled “200”

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