Remove associations

DELETE

/rest/api/3/field/association

Unassociates a set of fields with a project and issue type context.

Fields will be unassociated with all projects/issue types that share the same field configuration which the provided project and issue types are using. This means that while the field will be unassociated with the provided project and issue types, it will also be unassociated with any other projects and issue types that share the same field configuration.

If a success response is returned it means that the field association has been removed in any applicable contexts where it was present.

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

Permissions required: Administer Jira global permission.

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

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/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

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

Move custom field to trash

Create associations