Create project category

POST

/rest/api/3/projectCategory

Creates a project category.

Permissions required: Administer Jira global permission.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://jira.local:8080/jira/rest//rest/api/3/projectCategory' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "Created Project Category",
    "name": "CREATED"
}'

Response Example

201 - Success

{"self":"https://your-domain.atlassian.net/rest/api/3/projectCategory/10100","id":"10100","name":"CREATED","description":"Created Project Category"}

Request

Body Params application/json

A project category.

description

string

optional

The description of the project category.

name

string

optional

The name of the project category. Required on create, optional on update.

Examples

Responses

🟢201Returned if the request is successful.

application/json

Body

A project category.

description

string

optional

The description of the project category.

string

read-onlyoptional

The ID of the project category.

name

string

optional

The name of the project category. Required on create, optional on update.

self

string <uri>

read-onlyoptional

The URL of the project category.

🟠400Returned if: * `name` is not provided or exceeds 255 characters. * `description` exceeds 1000 characters.

🟠401Returned if the authentication credentials are incorrect or missing.

🟠403Returned if the user does not have the necessary permission.

🟠409Returned if the project category name is in use.

Modified at 2023-07-13 03:27:27

Get all project categories

Get project category by ID