# Jira Field schemes API

**Canonical:** https://apis.io/apis/jira/jira-field-schemes-api/  
**Provider:** Jira — https://apis.io/providers/jira/  
**Base URL:** https://your-domain.atlassian.net/rest/api/2  
**Documentation:** https://developer.atlassian.com/cloud/jira/platform/rest/v2/intro/

Jira Field schemes API is one of 132 APIs that [Jira](https://apis.io/providers/jira/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Field schemes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and an API reference.

This resource represents field schemes which are replacing field configuration schemes to control field associations. They are currently in beta and only available to customers who have opted-in to the beta program. For more information see [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)

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| GET | `/rest/api/3/config/fieldschemes` | Get field schemes |
| POST | `/rest/api/3/config/fieldschemes` | Create field scheme |
| DELETE | `/rest/api/3/config/fieldschemes/fields` | Remove fields associated with field schemes |
| PUT | `/rest/api/3/config/fieldschemes/fields` | Update fields associated with field schemes |
| DELETE | `/rest/api/3/config/fieldschemes/fields/parameters` | Remove field parameters |
| PUT | `/rest/api/3/config/fieldschemes/fields/parameters` | Update field parameters |
| GET | `/rest/api/3/config/fieldschemes/projects` | Get projects with field schemes |
| PUT | `/rest/api/3/config/fieldschemes/projects` | Associate projects to field schemes |
| DELETE | `/rest/api/3/config/fieldschemes/{id}` | Delete a field scheme |
| GET | `/rest/api/3/config/fieldschemes/{id}` | Get field scheme |
| PUT | `/rest/api/3/config/fieldschemes/{id}` | Update field scheme |
| POST | `/rest/api/3/config/fieldschemes/{id}/clone` | Clone field scheme |
| GET | `/rest/api/3/config/fieldschemes/{id}/fields` | Search field scheme fields |
| GET | `/rest/api/3/config/fieldschemes/{id}/fields/{fieldId}/parameters` | Get field parameters |
| GET | `/rest/api/3/config/fieldschemes/{id}/projects` | Search field scheme projects |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-field-schemes-api-openapi.yml
- **Documentation** — https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
- **Authentication** — https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
- **Documentation** — https://developer.atlassian.com/cloud/jira/software/rest/intro/
- **Documentation** — https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
- **APIReference** — https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/

## Other Jira APIs (12)

- [Jira Cloud Platform REST API v2](https://apis.io/apis/jira/jira-cloud-platform-rest-api-v2/)
- [Jira Service Management Operations REST API](https://apis.io/apis/jira/jira-service-management-operations-rest-api/)
- [Jira Align REST API](https://apis.io/apis/jira/jira-align-rest-api/)
- [Jira Customer Service Management REST API](https://apis.io/apis/jira/jira-customer-service-management-rest-api/)
- [Jira Issue Comments API](https://apis.io/apis/jira/jira-issue-comments-api/)
- [Jira Issue Priorities API](https://apis.io/apis/jira/jira-issue-priorities-api/)
- [Jira Issue Search API](https://apis.io/apis/jira/jira-issue-search-api/)
- [Jira Issue Statuses API](https://apis.io/apis/jira/jira-issue-statuses-api/)
- [Jira Issue Transitions API](https://apis.io/apis/jira/jira-issue-transitions-api/)
- [Jira Issue Types API](https://apis.io/apis/jira/jira-issue-types-api/)
- [Jira Issues API](https://apis.io/apis/jira/jira-issues-api/)
- [Jira Projects API](https://apis.io/apis/jira/jira-projects-api/)

## Tags

Field schemes

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/jira/jira-field-schemes-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/jira/.