---
title: "Remove associations"
method: DELETE
path: "/rest/api/3/field/association"
tags: ["Issue custom field associations"]
---

# 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](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Request body

- FieldAssociationsRequest — Details of field associations with projects.
  - `associationContexts` AssociationContextObject[], required — Contexts to associate/unassociate the fields with.
    - `identifier` object
    - `type` string, required
  - `fields` FieldIdentifierObject[], required — Fields to associate/unassociate with projects.
    - `identifier` object
    - `type` string, required

## Response `204`

Returned if the field association validation passes.

- unknown

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `404` — Returned if the field, project, or issue type is not found.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/5a51740d7ab3/schema)