Create associations

PUT

/rest/api/3/field/association

Associates fields with projects.

Fields will be associated with each issue type on the requested projects.

Fields will be associated with all projects that share the same field configuration which the provided projects are using. This means that while the field will be associated with the requested projects, it will also be associated with any other projects that share the same field configuration.

If a success response is returned it means that the field association has been created in any applicable contexts where it wasn't already present.

Up to 50 fields and up to 100 projects can be associated in a single request. If more fields or projects are provided a 400 response will be returned.

Permissions required: Administer Jira global permission.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/rest/api/3/field/association' \
--header 'Content-Type: application/json' \
--data-raw '{
    "associationContexts": [
        {
            "identifier": 10000,
            "type": "PROJECT_ID"
        },
        {
            "identifier": 10001,
            "type": "PROJECT_ID"
        }
    ],
    "fields": [
        {
            "identifier": "customfield_10000",
            "type": "FIELD_ID"
        },
        {
            "identifier": "customfield_10001",
            "type": "FIELD_ID"
        }
    ]
}'

Response Example

null

Request

Body Params application/json

Examples

Responses

🟢204No Content

application/json

Returned if the field association validation passes.

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

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

Remove associations

Get custom field contexts