{ "info": { "_postman_id": "9d44a13c-8285-4aa0-b753-59e999c02790", "name": "Atlassian rest/api/3/app/", "description": "Needs description.\n\nContact Support:\n Email: ecosystem@atlassian.com", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "lastUpdatedBy": "35240", "uid": "35240-9d44a13c-8285-4aa0-b753-59e999c02790" }, "item": [ { "name": "rest", "item": [ { "name": "api", "item": [ { "name": "3", "item": [ { "name": "app", "item": [ { "name": "field", "item": [ { "name": "value", "item": [ { "name": "Atlassian Update Custom Fields", "id": "abc42366-6550-42cd-a54c-741758a65fef", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/MultipleCustomFieldValuesUpdateDetails not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/value?generateChangelog=true", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", "value" ], "query": [ { "description": "Whether to generate a changelog for this update.", "key": "generateChangelog", "value": "true" } ] }, "description": "Updates the value of one or more custom fields on one or more issues. Combinations of custom field and issue should be unique within the request.

Apps can only perform this operation on [custom fields](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field/) and [custom field types](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field-type/) declared in their own manifests.

**[Permissions](#permissions) required:** Only the app that owns the custom field or custom field type can update its values with this operation." }, "response": [ { "id": "f6d6d45e-e959-42db-8a3f-b237d1d1e8ab", "name": "Returned if the request is successful.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/MultipleCustomFieldValuesUpdateDetails not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/value?generateChangelog=true", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", "value" ], "query": [ { "description": "Whether to generate a changelog for this update.", "key": "generateChangelog", "value": "true" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-f6d6d45e-e959-42db-8a3f-b237d1d1e8ab" }, { "id": "0f74f14a-e451-4596-8b44-5687317d2722", "name": "Returned if the request is invalid.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/MultipleCustomFieldValuesUpdateDetails not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/value?generateChangelog=true", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", "value" ], "query": [ { "description": "Whether to generate a changelog for this update.", "key": "generateChangelog", "value": "true" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-0f74f14a-e451-4596-8b44-5687317d2722" }, { "id": "2ed13f91-7a10-431d-88da-8e4fa851c0a0", "name": "Returned if the request is not authenticated as the app that provided all the fields.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/MultipleCustomFieldValuesUpdateDetails not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/value?generateChangelog=true", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", "value" ], "query": [ { "description": "Whether to generate a changelog for this update.", "key": "generateChangelog", "value": "true" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-2ed13f91-7a10-431d-88da-8e4fa851c0a0" }, { "id": "7d61e197-6c65-4bde-b8b5-86f1f4d9663b", "name": "Returned if any field is not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/MultipleCustomFieldValuesUpdateDetails not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/value?generateChangelog=true", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", "value" ], "query": [ { "description": "Whether to generate a changelog for this update.", "key": "generateChangelog", "value": "true" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-7d61e197-6c65-4bde-b8b5-86f1f4d9663b" } ], "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-abc42366-6550-42cd-a54c-741758a65fef" } ], "id": "f4b99011-0d09-4daf-8d86-b1a1c5cec8fa", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-f4b99011-0d09-4daf-8d86-b1a1c5cec8fa" }, { "name": "{fieldIdOrKey}", "item": [ { "name": "context", "item": [ { "name": "configuration", "item": [ { "name": "Atlassian Get Custom Field Configurations", "id": "364f705f-1411-4bf3-939e-97bb56b4e19e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/context/configuration?id=&id=&fieldContextId=&fieldContextId=&issueId=&projectKeyOrId=&issueTypeId=&startAt=0&maxResults=100", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "context", "configuration" ], "query": [ { "description": "The list of configuration IDs. To include multiple configurations, separate IDs with an ampersand: `id=10000&id=10001`. Can't be provided with `fieldContextId`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "id", "value": "" }, { "description": "The list of configuration IDs. To include multiple configurations, separate IDs with an ampersand: `id=10000&id=10001`. Can't be provided with `fieldContextId`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "id", "value": "" }, { "description": "The list of field context IDs. To include multiple field contexts, separate IDs with an ampersand: `fieldContextId=10000&fieldContextId=10001`. Can't be provided with `id`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "fieldContextId", "value": "" }, { "description": "The list of field context IDs. To include multiple field contexts, separate IDs with an ampersand: `fieldContextId=10000&fieldContextId=10001`. Can't be provided with `id`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "fieldContextId", "value": "" }, { "description": "The ID of the issue to filter results by. If the issue doesn't exist, an empty list is returned. Can't be provided with `projectKeyOrId`, or `issueTypeId`.", "key": "issueId", "value": "" }, { "description": "The ID or key of the project to filter results by. Must be provided with `issueTypeId`. Can't be provided with `issueId`.", "key": "projectKeyOrId", "value": "" }, { "description": "The ID of the issue type to filter results by. Must be provided with `projectKeyOrId`. Can't be provided with `issueId`.", "key": "issueTypeId", "value": "" }, { "description": "The index of the first item to return in a page of results (page offset).", "key": "startAt", "value": "0" }, { "description": "The maximum number of items to return per page.", "key": "maxResults", "value": "100" } ], "variable": [ { "id": "251e1791-572a-429e-9162-816efd631808", "key": "fieldIdOrKey", "value": "", "description": "(Required) The ID or key of the custom field, for example `customfield_10000`." } ] }, "description": "Returns a [paginated](#pagination) list of configurations for 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/).

The result can be filtered by one of these criteria:

* `id`.
* `fieldContextId`.
* `issueId`.
* `projectKeyOrId` and `issueTypeId`.

Otherwise, all configurations are returned.

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg). Jira permissions are not required for the Forge app that provided the custom field type." }, "response": [ { "id": "68b427b5-720f-493c-bccf-c33aaafa5dab", "name": "Returned if the request is successful.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/context/configuration?id=&fieldContextId=&issueId=&projectKeyOrId=&issueTypeId=&startAt=0&maxResults=100", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "context", "configuration" ], "query": [ { "description": "The list of configuration IDs. To include multiple configurations, separate IDs with an ampersand: `id=10000&id=10001`. Can't be provided with `fieldContextId`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "id", "value": "" }, { "description": "The list of field context IDs. To include multiple field contexts, separate IDs with an ampersand: `fieldContextId=10000&fieldContextId=10001`. Can't be provided with `id`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "fieldContextId", "value": "" }, { "description": "The ID of the issue to filter results by. If the issue doesn't exist, an empty list is returned. Can't be provided with `projectKeyOrId`, or `issueTypeId`.", "key": "issueId", "value": "" }, { "description": "The ID or key of the project to filter results by. Must be provided with `issueTypeId`. Can't be provided with `issueId`.", "key": "projectKeyOrId", "value": "" }, { "description": "The ID of the issue type to filter results by. Must be provided with `projectKeyOrId`. Can't be provided with `issueId`.", "key": "issueTypeId", "value": "" }, { "description": "The index of the first item to return in a page of results (page offset).", "key": "startAt", "value": "0" }, { "description": "The maximum number of items to return per page.", "key": "maxResults", "value": "100" } ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"isLast\": \"\",\n \"maxResults\": \"\",\n \"nextPage\": \"\",\n \"self\": \"\",\n \"startAt\": \"\",\n \"total\": \"\",\n \"values\": [\n {\n \"value\": \"reference #/components/schemas/ContextualConfiguration not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/components/schemas/ContextualConfiguration not found in the OpenAPI spec\"\n }\n ]\n}", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-68b427b5-720f-493c-bccf-c33aaafa5dab" }, { "id": "2702dbe2-b938-4d1a-802e-243666b24524", "name": "Returned if the request is invalid.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/context/configuration?id=&fieldContextId=&issueId=&projectKeyOrId=&issueTypeId=&startAt=0&maxResults=100", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "context", "configuration" ], "query": [ { "description": "The list of configuration IDs. To include multiple configurations, separate IDs with an ampersand: `id=10000&id=10001`. Can't be provided with `fieldContextId`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "id", "value": "" }, { "description": "The list of field context IDs. To include multiple field contexts, separate IDs with an ampersand: `fieldContextId=10000&fieldContextId=10001`. Can't be provided with `id`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "fieldContextId", "value": "" }, { "description": "The ID of the issue to filter results by. If the issue doesn't exist, an empty list is returned. Can't be provided with `projectKeyOrId`, or `issueTypeId`.", "key": "issueId", "value": "" }, { "description": "The ID or key of the project to filter results by. Must be provided with `issueTypeId`. Can't be provided with `issueId`.", "key": "projectKeyOrId", "value": "" }, { "description": "The ID of the issue type to filter results by. Must be provided with `projectKeyOrId`. Can't be provided with `issueId`.", "key": "issueTypeId", "value": "" }, { "description": "The index of the first item to return in a page of results (page offset).", "key": "startAt", "value": "0" }, { "description": "The maximum number of items to return per page.", "key": "maxResults", "value": "100" } ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-2702dbe2-b938-4d1a-802e-243666b24524" }, { "id": "c69fcf63-0d33-4d8f-865c-faf0a03db80c", "name": "Returned if the authentication credentials are incorrect or missing.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/context/configuration?id=&fieldContextId=&issueId=&projectKeyOrId=&issueTypeId=&startAt=0&maxResults=100", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "context", "configuration" ], "query": [ { "description": "The list of configuration IDs. To include multiple configurations, separate IDs with an ampersand: `id=10000&id=10001`. Can't be provided with `fieldContextId`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "id", "value": "" }, { "description": "The list of field context IDs. To include multiple field contexts, separate IDs with an ampersand: `fieldContextId=10000&fieldContextId=10001`. Can't be provided with `id`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "fieldContextId", "value": "" }, { "description": "The ID of the issue to filter results by. If the issue doesn't exist, an empty list is returned. Can't be provided with `projectKeyOrId`, or `issueTypeId`.", "key": "issueId", "value": "" }, { "description": "The ID or key of the project to filter results by. Must be provided with `issueTypeId`. Can't be provided with `issueId`.", "key": "projectKeyOrId", "value": "" }, { "description": "The ID of the issue type to filter results by. Must be provided with `projectKeyOrId`. Can't be provided with `issueId`.", "key": "issueTypeId", "value": "" }, { "description": "The index of the first item to return in a page of results (page offset).", "key": "startAt", "value": "0" }, { "description": "The maximum number of items to return per page.", "key": "maxResults", "value": "100" } ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-c69fcf63-0d33-4d8f-865c-faf0a03db80c" }, { "id": "f903fc53-4d26-45dc-b1d2-d12a2925013d", "name": "Returned if the user is not a Jira admin or the request is not authenticated as from the app that provided the field.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/context/configuration?id=&fieldContextId=&issueId=&projectKeyOrId=&issueTypeId=&startAt=0&maxResults=100", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "context", "configuration" ], "query": [ { "description": "The list of configuration IDs. To include multiple configurations, separate IDs with an ampersand: `id=10000&id=10001`. Can't be provided with `fieldContextId`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "id", "value": "" }, { "description": "The list of field context IDs. To include multiple field contexts, separate IDs with an ampersand: `fieldContextId=10000&fieldContextId=10001`. Can't be provided with `id`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "fieldContextId", "value": "" }, { "description": "The ID of the issue to filter results by. If the issue doesn't exist, an empty list is returned. Can't be provided with `projectKeyOrId`, or `issueTypeId`.", "key": "issueId", "value": "" }, { "description": "The ID or key of the project to filter results by. Must be provided with `issueTypeId`. Can't be provided with `issueId`.", "key": "projectKeyOrId", "value": "" }, { "description": "The ID of the issue type to filter results by. Must be provided with `projectKeyOrId`. Can't be provided with `issueId`.", "key": "issueTypeId", "value": "" }, { "description": "The index of the first item to return in a page of results (page offset).", "key": "startAt", "value": "0" }, { "description": "The maximum number of items to return per page.", "key": "maxResults", "value": "100" } ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-f903fc53-4d26-45dc-b1d2-d12a2925013d" }, { "id": "c90ea8bf-a540-4b35-8cc4-2f3595d90fc6", "name": "Returned if the custom field is not found.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/context/configuration?id=&fieldContextId=&issueId=&projectKeyOrId=&issueTypeId=&startAt=0&maxResults=100", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "context", "configuration" ], "query": [ { "description": "The list of configuration IDs. To include multiple configurations, separate IDs with an ampersand: `id=10000&id=10001`. Can't be provided with `fieldContextId`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "id", "value": "" }, { "description": "The list of field context IDs. To include multiple field contexts, separate IDs with an ampersand: `fieldContextId=10000&fieldContextId=10001`. Can't be provided with `id`, `issueId`, `projectKeyOrId`, or `issueTypeId`.", "key": "fieldContextId", "value": "" }, { "description": "The ID of the issue to filter results by. If the issue doesn't exist, an empty list is returned. Can't be provided with `projectKeyOrId`, or `issueTypeId`.", "key": "issueId", "value": "" }, { "description": "The ID or key of the project to filter results by. Must be provided with `issueTypeId`. Can't be provided with `issueId`.", "key": "projectKeyOrId", "value": "" }, { "description": "The ID of the issue type to filter results by. Must be provided with `projectKeyOrId`. Can't be provided with `issueId`.", "key": "issueTypeId", "value": "" }, { "description": "The index of the first item to return in a page of results (page offset).", "key": "startAt", "value": "0" }, { "description": "The maximum number of items to return per page.", "key": "maxResults", "value": "100" } ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-c90ea8bf-a540-4b35-8cc4-2f3595d90fc6" } ], "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-364f705f-1411-4bf3-939e-97bb56b4e19e" }, { "name": "Atlassian Update Custom Field Configurations", "id": "26b020f3-c5c9-4191-b4f4-3d721e56e113", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/CustomFieldConfigurations not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/context/configuration", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "context", "configuration" ], "variable": [ { "id": "e3b67b4e-ceb4-44bf-85b3-b82fe4cba0d4", "key": "fieldIdOrKey", "value": "", "description": "(Required) The ID or key of the custom field, for example `customfield_10000`." } ] }, "description": "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." }, "response": [ { "id": "6850512c-d3a3-428c-859e-c5faf4b74751", "name": "Returned if the request is successful.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/CustomFieldConfigurations not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/context/configuration", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "context", "configuration" ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-6850512c-d3a3-428c-859e-c5faf4b74751" }, { "id": "d39c316f-602d-4d2f-99f0-ab76d947f869", "name": "Returned if the request is invalid.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/CustomFieldConfigurations not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/context/configuration", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "context", "configuration" ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-d39c316f-602d-4d2f-99f0-ab76d947f869" }, { "id": "8bebaac8-6b8c-438c-b9f9-3dd7e2164eb5", "name": "Returned if the authentication credentials are incorrect or missing.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/CustomFieldConfigurations not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/context/configuration", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "context", "configuration" ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-8bebaac8-6b8c-438c-b9f9-3dd7e2164eb5" }, { "id": "588af7e3-c30a-4085-8fb2-503f334a206c", "name": "Returned if the user is not a Jira admin or the request is not authenticated as from the app that provided the field.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/CustomFieldConfigurations not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/context/configuration", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "context", "configuration" ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-588af7e3-c30a-4085-8fb2-503f334a206c" }, { "id": "e983c91f-74d2-48a7-80a5-521cc83ca25b", "name": "Returned if the custom field is not found.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/CustomFieldConfigurations not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/context/configuration", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "context", "configuration" ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-e983c91f-74d2-48a7-80a5-521cc83ca25b" } ], "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-26b020f3-c5c9-4191-b4f4-3d721e56e113" } ], "id": "c7555beb-ab62-405d-b9f7-7adf52de9690", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-c7555beb-ab62-405d-b9f7-7adf52de9690" } ], "id": "63578a27-9302-49bc-9b30-aa146b124734", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-63578a27-9302-49bc-9b30-aa146b124734" }, { "name": "value", "item": [ { "name": "Atlassian Update Custom Field Value", "id": "49b3b843-2577-48ba-9cbb-c36af168c787", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/CustomFieldValueUpdateDetails not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/value?generateChangelog=true", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "value" ], "query": [ { "description": "Whether to generate a changelog for this update.", "key": "generateChangelog", "value": "true" } ], "variable": [ { "id": "bd7e0bf7-6b73-4a56-9dcc-edf7a956d01e", "key": "fieldIdOrKey", "value": "", "description": "(Required) The ID or key of the custom field. For example, `customfield_10010`." } ] }, "description": "Updates the value of a custom field on one or more issues.

Apps can only perform this operation on [custom fields](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field/) and [custom field types](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field-type/) declared in their own manifests.

**[Permissions](#permissions) required:** Only the app that owns the custom field or custom field type can update its values with this operation." }, "response": [ { "id": "5f7a488a-6e54-4aa2-9b70-d4e2dfe84542", "name": "Returned if the request is successful.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/CustomFieldValueUpdateDetails not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/value?generateChangelog=true", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "value" ], "query": [ { "description": "Whether to generate a changelog for this update.", "key": "generateChangelog", "value": "true" } ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-5f7a488a-6e54-4aa2-9b70-d4e2dfe84542" }, { "id": "481fe5f1-fc63-408c-82a1-df3c3397eaf9", "name": "Returned if the request is invalid.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/CustomFieldValueUpdateDetails not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/value?generateChangelog=true", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "value" ], "query": [ { "description": "Whether to generate a changelog for this update.", "key": "generateChangelog", "value": "true" } ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-481fe5f1-fc63-408c-82a1-df3c3397eaf9" }, { "id": "6166652d-32f7-4577-9806-10d6719eacff", "name": "Returned if the request is not authenticated as the app that provided the field.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/CustomFieldValueUpdateDetails not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/value?generateChangelog=true", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "value" ], "query": [ { "description": "Whether to generate a changelog for this update.", "key": "generateChangelog", "value": "true" } ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-6166652d-32f7-4577-9806-10d6719eacff" }, { "id": "26db7787-7b2e-4263-9f9f-8ae7b7d33c68", "name": "Returned if the field is not found.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"value\": \"reference #/components/schemas/CustomFieldValueUpdateDetails not found in the OpenAPI spec\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/rest/api/3/app/field/:fieldIdOrKey/value?generateChangelog=true", "host": [ "{{baseUrl}}" ], "path": [ "rest", "api", "3", "app", "field", ":fieldIdOrKey", "value" ], "query": [ { "description": "Whether to generate a changelog for this update.", "key": "generateChangelog", "value": "true" } ], "variable": [ { "key": "fieldIdOrKey" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-26db7787-7b2e-4263-9f9f-8ae7b7d33c68" } ], "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-49b3b843-2577-48ba-9cbb-c36af168c787" } ], "id": "20320931-f3b3-4c5e-b106-a0f9df36c02f", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-20320931-f3b3-4c5e-b106-a0f9df36c02f" } ], "id": "14ae0c40-7a19-4c99-a654-4d0d7960770f", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-14ae0c40-7a19-4c99-a654-4d0d7960770f" } ], "id": "30e22777-4343-41e1-b699-a460a8436790", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-30e22777-4343-41e1-b699-a460a8436790" } ], "id": "93396515-b091-42f1-ad38-74a95da0bcee", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-93396515-b091-42f1-ad38-74a95da0bcee" } ], "id": "af73d32a-79a1-4fef-bab5-7006a3506bf9", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-af73d32a-79a1-4fef-bab5-7006a3506bf9" } ], "id": "afaa3f38-ba52-4fb5-b91b-e2bb30742fbb", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-afaa3f38-ba52-4fb5-b91b-e2bb30742fbb" } ], "id": "b8172b33-1558-4aab-ab93-367b874a481e", "createdAt": "2026-06-05T15:06:53.000Z", "updatedAt": "2026-06-05T15:06:53.000Z", "uid": "35240-b8172b33-1558-4aab-ab93-367b874a481e" } ], "variable": [ { "key": "baseUrl", "value": "https://your-domain.atlassian.net" } ] }