---
title: "Update custom field configurations"
method: PUT
path: "/rest/api/3/app/field/{fieldIdOrKey}/context/configuration"
tags: ["Issue custom field configuration (apps)"]
---

# Update custom field configurations

`PUT /rest/api/3/app/field/{fieldIdOrKey}/context/configuration`

Update the configuration for contexts of a custom field of a [type](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field-type/) created by a [Forge app](https://developer.atlassian.com/platform/forge/).

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg). Jira permissions are not required for the Forge app that created the custom field type.

## Path parameters

- `fieldIdOrKey` string, required

## Request body

- CustomFieldConfigurations — Details of configurations for a custom field.
  - `configurations` ContextualConfiguration[], required — The list of custom field configuration details.
    - `configuration` unknown
    - `fieldContextId` string, required — The ID of the field context the configuration is associated with.
    - `id` string, required — The ID of the configuration.
    - `schema` unknown

## Response `200`

Returned if the request is successful.

- unknown

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user is not a Jira admin or the request is not authenticated as from the app that provided the field.
- `404` — Returned if the custom field 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)