# RFC-104: New Field Scheme Model APIs for Project and Work Type Associations

**URL:** <https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207>\
**Category:** Request for Comments (RFC)\
**Tags:** jira-admin, jira-cloud-rest-api, jira-cloud, rest-api\
**Created:** [July 30, 2025, 12:39am UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207 "2025-07-30T00:39:43Z")\
**Posts on this page:** 14\
**Page:** 1

<div class="post-metadata">

**Author:** ![LeanneWon](https://avatars.discourse-cdn.com/v4/letter/l/51bf81/32.png) [@LeanneWon](https://community.developer.atlassian.com/u/LeanneWon)\
**Post date:** [July 30, 2025, 12:39am UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/1 "2025-07-30T00:39:43Z")

</div>

> **Updated 19th September 2025** to include changes to proposed payloads incorporating feedback and aligning with Jira’s upcoming terminology refresh.

## Summary of Project:

> [@RFC-103: Jira Field Configuration Overhaul: Admin Experience and API Changes](https://community.developer.atlassian.com/t/rfc-103-jira-field-configuration-overhaul-admin-experience-and-api-changes/94205):
>
> Summary of Project: We’re making improvements to the user experience of fields as part of ongoing efforts to simplify the field configuration experience. The Field Configuration page in the Jira admin section is one of the important admin experiences. However, we discovered that this current admin experience is not easy and is confusing to use. To support the experience changes, our team will be working on an architectural change as detailed in this RFC. Publish: December 2025 Discuss: During …

- **Publish** : December 2025
- **Discuss** : During early access starting at 1st October 2025
- **Resolve** : TBC end of early access

## **Problem**

With the changes our team is making to the field configuration model, we’ll be replacing existing APIs to be compatible with our new model.

This RFC provides new APIs that read field configuration information, their alignment with field configuration schemes, and mappings. These will replace the old APIs when they’re deprecated in the future.

## **Proposed Solution**

To replace these APIs, below is the new API that returns a field’s context project and work type association settings.

This proposed API will support projects that are using the new field schemes as well as projects on the existing field configuration model, meaning it can be used as customers transition to the new model.

### **Get Field Association Items**

**GET** `/rest/api/3/projects/fields`  
Returns fields with parameters for given projects and work types.

**Query parameters:**

- `startAt` (integer)

- `maxResults` (integer, max: 100)

- `projectIds` (array, required)

- `workTypeIds` (array, required)

- `fieldIds` (array)

**Response:**

```json
{
  "isLast": true,
  "maxResults": 50,
  "nextPage": "/rest/api/2/projects/fields?projectId=10000&workTypeId=10001,10002&fieldId=environment&startAt=5"
  "startAt": 0,
  "total": 3,
  "values": [
    {
      "fieldId": "environment",
      "projectId": "10000",
      "workTypeId": "10001",
      "description": "For example operating system, software platform and/or hardware specifications (include as appropriate for the work).",
      "isRequired": false
    },
    {
      "fieldId": "environment",
      "projectId": "10000",
      "workTypeId": "10002",
      "description": "For example operating system, software platform and/or hardware specifications (include as appropriate for the work).",
      "isRequired": false
    }
  ]

```

* * *

## **Use Cases**

### **Use Case 1:**

User wants to know which fields are required for project, `10000`, and work type, `10001`.

**Request**

`/rest/api/3/projects/fields?projectIds=10000&workTypeIds=10001

### **Use Case 2:**

User wants to know which fields `customfield_10000` and `customfield_10001` is required for project, `10000`, and work type, `10001`.

**Request**  
`/rest/api/3/projects/fields?projectIds=10000&workTypeIds=10001&fieldIds=customfield_10000,customfield_10001`

* * *

## Early Access and Feedback

We want to gather the feedback to understand how users are using existing field configuration API and whether the new API can replace the existing APIs

If you’d like to join, fill out an [expression of interest form here.](https://earlyaccessprogram.atlassian.net/servicedesk/customer/portal/891/group/926/create/11222)

* * *

## Affected APIs

These APIs will no longer available to use after the existing field configuration model is fully deprecated.

The following APIs providing field configuration, field configuration scheme, items and mappings to eventually fetch which fields are configured to the given project and work type context.

- [Get all field configurations](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-field-configurations/#api-rest-api-3-fieldconfiguration-get)
- [Get all field configuration schemes](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-field-configurations/#api-rest-api-3-fieldconfigurationscheme-get)
- [Get field configuration schemes for projects](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-field-configurations/#api-rest-api-3-fieldconfigurationscheme-project-get)
- [Get field configuration issue type items](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-field-configurations/#api-rest-api-3-fieldconfigurationscheme-mapping-get)
- [Get field configuration items](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-field-configurations/#api-rest-api-3-fieldconfiguration-id-fields-get)

---

<div class="post-metadata">

**Author:** ![ernst.stefan](https://avatars.discourse-cdn.com/v4/letter/e/7cd45c/32.png) [@ernst.stefan](https://community.developer.atlassian.com/u/ernst.stefan)\
**Post date:** [July 30, 2025, 7:11am UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/2 "2025-07-30T07:11:50Z")

</div>

Hello @LeanneWon - thank you for the RFC. Can you already disclose which permissions the new API endpoints will require?  
I was wondering whether to use these ones vs createmeta for certain operations

---

<div class="post-metadata">

**Author:** ![LeanneWon](https://avatars.discourse-cdn.com/v4/letter/l/51bf81/32.png) [@LeanneWon](https://community.developer.atlassian.com/u/LeanneWon)\
**Post date:** [August 1, 2025, 12:39am UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/3 "2025-08-01T00:39:28Z")

</div>

Hi @ernst.stefan  
Yes, I will update the document with more information about permissions. To give you the answer quickly, this API will not require admin permission to make request.

---

<div class="post-metadata">

**Author:** ![OndejMedek](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/ondejmedek/32/42527_2.png) [@OndejMedek](https://community.developer.atlassian.com/u/OndejMedek)\
**Post date:** [August 5, 2025, 2:56pm UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/4 "2025-08-05T14:56:38Z")

</div>

Hello

> [@LeanneWon](#):
>
> **POST** `/rest/api/2/field/association/item`

Will you add it to the REST API is version 3 as well?

---

<div class="post-metadata">

**Author:** ![LeanneWon](https://avatars.discourse-cdn.com/v4/letter/l/51bf81/32.png) [@LeanneWon](https://community.developer.atlassian.com/u/LeanneWon)\
**Post date:** [August 8, 2025, 4:36am UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/5 "2025-08-08T04:36:17Z")

</div>

Hi @OndejMedek, Yes, I will be available for both version 2 and 3

---

<div class="post-metadata">

**Author:** ![AndreasEbert](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/andreasebert/32/38902_2.png) [@AndreasEbert](https://community.developer.atlassian.com/u/AndreasEbert)\
**Post date:** [September 10, 2025, 12:30pm UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/6 "2025-09-10T12:30:17Z")

</div>

@LeanneWon, in [most other API endpoints](https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issue-types/#api-group-issue-types) it’s called `issuetype`, but here it’s called `workType`. That is in-consistent. Is that intentional?

---

<div class="post-metadata">

**Author:** ![LeanneWon](https://avatars.discourse-cdn.com/v4/letter/l/51bf81/32.png) [@LeanneWon](https://community.developer.atlassian.com/u/LeanneWon)\
**Post date:** [September 10, 2025, 9:59pm UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/7 "2025-09-10T21:59:20Z")

</div>

Hi @AndreasEbert

As part of the change this year, issue type is now renamed to be work type. For an official announcement, you may refer to:

[https://community.developer.atlassian.com/t/work-is-the-new-collective-term-for-items-tracked-in-jira/88552](https://community.developer.atlassian.com/t/work-is-the-new-collective-term-for-items-tracked-in-jira/88552)

To align with this change, we are intentionally making new APIs to be aligned with the new term, “work type”. However for the existing APIs, we are keeping them as issue type to ensures that no backward-incompatible changes are introduced.

Thanks!

---

<div class="post-metadata">

**Author:** ![clouless](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/clouless/32/49469_2.png) [@clouless](https://community.developer.atlassian.com/u/clouless)\
**Post date:** [September 26, 2025, 10:47am UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/8 "2025-09-26T10:47:38Z")

</div>

Hi,

My question is about contexts:  
In your proposed solutions example, which returns the same field associated to the project with different work types =\> Are there still underlying context with a contextId? If yes how should we retrieve the contextId once we have this response?

```auto
[
    {
      "fieldId": "environment",
      "projectId": "10000", ====> CONTEXT ID
      "workTypeId": "10001", ====> 123 ??? 
      "description": "For example operating system, software platform and/or hardware specifications (include as appropriate for the work).",
      "isRequired": false
    },
    {
      "fieldId": "environment",
      "projectId": "10000", ====> CONTEXT ID
      "workTypeId": "10002", ====> 456 ??? 
      "description": "For example operating system, software platform and/or hardware specifications (include as appropriate for the work).",
      "isRequired": false
    }
  ]

```

Cheers,

Bernhard

---

<div class="post-metadata">

**Author:** ![LeanneWon](https://avatars.discourse-cdn.com/v4/letter/l/51bf81/32.png) [@LeanneWon](https://community.developer.atlassian.com/u/LeanneWon)\
**Post date:** [October 7, 2025, 2:51am UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/9 "2025-10-07T02:51:31Z")

</div>

Hi @clouless

Sorry for the delayed response.

> In your proposed solutions example, which returns the same field associated to the project with different work types =\> Are there still underlying context with a contextId?

With new model, there is no guarantee that there is context for the field returned from this API as the goal of new Field Scheme model is to have fields will be directly associated with Field scheme. This means users can no longer restrict a field to a project by deleting its global context and replacing it with a project-limited one. This can result in having fields returned from this proposed API and does not have applicable context for the given project and work types. (As started in [RFC-103: Jira Field Configuration Overhaul: Admin Experience and API Changes](https://community.developer.atlassian.com/t/rfc-103-jira-field-configuration-overhaul-admin-experience-and-api-changes/94205))

Once everyone is onboarded to use new Field Schemes, we are going to make sure there is always global context exist for all the fields, but this won’t happen until the old Field Config Schemes are fully deprecated.

Thanks!

Leanne

---

<div class="post-metadata">

**Author:** ![OndejMedek](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/ondejmedek/32/42527_2.png) [@OndejMedek](https://community.developer.atlassian.com/u/OndejMedek)\
**Post date:** [October 8, 2025, 12:27pm UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/10 "2025-10-08T12:27:36Z")

</div>

Seem to me, for the **Use Case 1:** User wants to know which fields are required for project, `10000`, and work type, `10001` - it’s possible to use endpoint [Get create field metadata for a project and issue type id](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-createmeta-projectidorkey-issuetypes-issuetypeid-get) too. Is this endpoint going to be deprecated, too?

---

<div class="post-metadata">

**Author:** ![LeanneWon](https://avatars.discourse-cdn.com/v4/letter/l/51bf81/32.png) [@LeanneWon](https://community.developer.atlassian.com/u/LeanneWon)\
**Post date:** [October 8, 2025, 9:20pm UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/11 "2025-10-08T21:20:52Z")

</div>

Hi @OndejMedek

Yes you can keep using [Get create field metadata for a project and issue type id](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-createmeta-projectidorkey-issuetypes-issuetypeid-get) endpoint and it is not being deprecated as part of this RFC.

Thanks,

Leanne

---

<div class="post-metadata">

**Author:** ![OndejMedek](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/ondejmedek/32/42527_2.png) [@OndejMedek](https://community.developer.atlassian.com/u/OndejMedek)\
**Post date:** [October 9, 2025, 8:24am UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/12 "2025-10-09T08:24:52Z")

</div>

Hi @LeanneWon If [Get create field metadata for a project and issue type id](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-createmeta-projectidorkey-issuetypes-issuetypeid-get) endpoint and my be others (e.g. [Get edit issue metadata](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-editmeta-get) ? ) will be deprecated by this RFC, may you add them to the **Affected APIs** section in your intro post?

---

<div class="post-metadata">

**Author:** ![LeanneWon](https://avatars.discourse-cdn.com/v4/letter/l/51bf81/32.png) [@LeanneWon](https://community.developer.atlassian.com/u/LeanneWon)\
**Post date:** [October 9, 2025, 10:04pm UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/13 "2025-10-09T22:04:38Z")

</div>

Hi @OndejMedek

Apologies, there was typo when I posted the last reply, it was supposed to be

> it is not being deprecated as part of this RFC.

Those APIs will not be deprecated by this RFC and you can continue to use them.

---

<div class="post-metadata">

**Author:** ![VortexWebInnovations](https://avatars.discourse-cdn.com/v4/letter/v/94ad74/32.png) [@VortexWebInnovations](https://community.developer.atlassian.com/u/VortexWebInnovations)\
**Post date:** [August 23, 2026, 5:37pm UTC](https://community.developer.atlassian.com/t/rfc-104-new-field-scheme-model-apis-for-project-and-work-type-associations/94207/14 "2026-08-23T17:37:19Z")

</div>

Hello!

Would it perhaps be time to move these APIs out of the **experimental** phase?

[https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-fields/#api-rest-api-3-projects-fields-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-fields/#api-rest-api-3-projects-fields-get)