---
title: "Assign custom field context to projects"
method: PUT
path: "/rest/api/2/field/{fieldId}/context/{contextId}/project"
tags: ["Issue custom field contexts"]
---

# Assign custom field context to projects

`PUT /rest/api/2/field/{fieldId}/context/{contextId}/project`

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](https://developer.atlassian.com/changelog/#CHANGE-3019)

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Path parameters

- `fieldId` string, required
- `contextId` integer, required

## Request body

- ProjectIds — A list of project IDs.
  - `projectIds` string[], required — The IDs of projects.

## Response `204`

Returned if operation is successful.

- unknown

## Other responses

- `400` — Returned if the request is not valid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the required permissions.
- `404` — Returned if the custom field, context, or project is not found.

---

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