# Jira Issue fields API

**Canonical:** https://apis.io/apis/jira/jira-issue-fields-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 Issue fields 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 Issue Fields. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and an API reference.

This resource represents issue fields, both system and custom fields. Use it to get fields, field configurations, and create custom fields.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| GET | `/rest/api/3/field` | Get fields |
| POST | `/rest/api/3/field` | Create custom field |
| GET | `/rest/api/3/field/search` | Get fields paginated |
| GET | `/rest/api/3/field/search/trashed` | Get fields in trash paginated |
| PUT | `/rest/api/3/field/{fieldId}` | Update custom field |
| GET | `/rest/api/3/field/{fieldId}/association/project` | Get field project associations |
| GET | `/rest/api/3/field/{fieldId}/contexts` | Get contexts for a field |
| DELETE | `/rest/api/3/field/{id}` | Delete custom field |
| POST | `/rest/api/3/field/{id}/restore` | Restore custom field from trash |
| POST | `/rest/api/3/field/{id}/trash` | Move custom field to trash |
| GET | `/rest/api/3/projects/fields` | Get fields for projects |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-issue-fields-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

Issue Fields

---

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