Create custom field context

POST

/rest/api/3/field/{fieldId}/context

Creates a custom field context.

If projectIds is empty, a global context is created. A global context is one that applies to all project. If issueTypeIds is empty, the context applies to all issue types.

Permissions required: Administer Jira global permission.

Request

Path Params

Body Params application/json

Examples

Responses

🟢201Created

application/json

Returned if the custom field context is created.

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠409409

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/rest/api/3/field//context' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "A context used to define the custom field options for bugs.",
    "issueTypeIds": [
        "10010"
    ],
    "name": "Bug fields context",
    "projectIds": []
}'

Response Example

201 - Success

{"id":"10025","name":"Bug fields context","description":"A context used to define the custom field options for bugs.","projectIds":[],"issueTypeIds":["10010"]}

Modified at 2025-07-16 07:18:01

Get custom field contexts

Get custom field contexts default values