ATatlassian
Issue custom field contexts

Assign custom field context to projects

Assigns a custom field context to projects.

If any project in the request is assigned to any context of the custom field, the operation fails.

This API will not allow adding projects to the global context from April 2026. Instead, an HTTP 400 response will be returned. See CHANGE-3019

Permissions required: Administer Jira global permission.

put/rest/api/3/field/{fieldId}/context/{contextId}/project

Request

  • Base URL
    https://your-domain.atlassian.net
  • URL
    https://your-domain.atlassian.net/rest/api/3/field/{fieldId}/context/{contextId}/project
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.atlassian.com/authorize
      Token URL: https://auth.atlassian.com/oauth/token scopes: manage:jira-configuration

Path parameters

fieldIdstring required

The ID of the custom field.

contextIdinteger required

The ID of the context.

Request body

projectIdsstring[] required

The IDs of projects.

Response

Returned if operation is successful.

unknown required

Changes

No recorded changes to this operation across all 31 revisions of this API.