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/2/field/{fieldId}/context/{contextId}/project

Request

  • Base URL: https://your-domain.atlassian.net
  • URL: https://your-domain.atlassian.net/rest/api/2/field/{fieldId}/context/{contextId}/project
  • Auth: one of:
    • HTTP basic
    • OAuth 2 (authorization code, authorization URL 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 26 revisions of this API.