Atlassian The Jira Cloud platform REST API — Issue Custom Field Contexts

naftiko: 1.0.0-alpha2
info:
  label: Atlassian The Jira Cloud platform REST API — Issue Custom Field Contexts
  description: 'Atlassian The Jira Cloud platform REST API — Issue Custom Field Contexts. 13 operations. Lead operation: Atlassian
    Get Custom Field Contexts. Self-contained Naftiko capability covering one Atlassian business surface.'
  tags:
  - Atlassian
  - Issue Custom Field Contexts
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ATLASSIAN_API_KEY: ATLASSIAN_API_KEY
capability:
  consumes:
  - type: http
    namespace: jira-issue-custom-field-contexts
    baseUri: https://your-domain.atlassian.net
    description: Atlassian The Jira Cloud platform REST API — Issue Custom Field Contexts business capability. Self-contained,
      no shared references.
    resources:
    - name: rest-api-3-field-fieldId-context
      path: /rest/api/3/field/{fieldId}/context
      operations:
      - name: atlassiangetcontextsforfield
        method: GET
        description: Atlassian Get Custom Field Contexts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fieldId
          in: path
          type: string
          description: The ID of the custom field.
          required: true
        - name: isAnyIssueType
          in: query
          type: boolean
          description: Whether to return contexts that apply to all issue types.
        - name: isGlobalContext
          in: query
          type: boolean
          description: Whether to return contexts that apply to all projects.
        - name: contextId
          in: query
          type: array
          description: 'The list of context IDs. To include multiple contexts, separate IDs with ampersand: `contextId=10000&contextId=10001`.'
        - name: startAt
          in: query
          type: integer
          description: The index of the first item to return in a page of results (page offset).
        - name: maxResults
          in: query
          type: integer
          description: The maximum number of items to return per page.
      - name: atlassiancreatecustomfieldcontext
        method: POST
        description: Atlassian Create Custom Field Context
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fieldId
          in: path
          type: string
          description: The ID of the custom field.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-field-fieldId-context-defaultValue
      path: /rest/api/3/field/{fieldId}/context/defaultValue
      operations:
      - name: atlassiangetdefaultvalues
        method: GET
        description: Atlassian Get Custom Field Contexts Default Values
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fieldId
          in: path
          type: string
          description: The ID of the custom field, for example `customfield\_10000`.
          required: true
        - name: contextId
          in: query
          type: array
          description: The IDs of the contexts.
        - name: startAt
          in: query
          type: integer
          description: The index of the first item to return in a page of results (page offset).
        - name: maxResults
          in: query
          type: integer
          description: The maximum number of items to return per page.
      - name: atlassiansetdefaultvalues
        method: PUT
        description: Atlassian Set Custom Field Contexts Default Values
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fieldId
          in: path
          type: string
          description: The ID of the custom field.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-field-fieldId-context-issuetypemapping
      path: /rest/api/3/field/{fieldId}/context/issuetypemapping
      operations:
      - name: atlassiangetissuetypemappingsforcontexts
        method: GET
        description: Atlassian Get Issue Types For Custom Field Context
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fieldId
          in: path
          type: string
          description: The ID of the custom field.
          required: true
        - name: contextId
          in: query
          type: array
          description: The ID of the context. To include multiple contexts, provide an ampersand-separated list. For example,
            `contextId=10001&contextId=10002`.
        - name: startAt
          in: query
          type: integer
          description: The index of the first item to return in a page of results (page offset).
        - name: maxResults
          in: query
          type: integer
          description: The maximum number of items to return per page.
    - name: rest-api-3-field-fieldId-context-mapping
      path: /rest/api/3/field/{fieldId}/context/mapping
      operations:
      - name: atlassiangetcustomfieldcontextsforprojectsandissuetypes
        method: POST
        description: Atlassian Get Custom Field Contexts For Projects And Issue Types
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fieldId
          in: path
          type: string
          description: The ID of the custom field.
          required: true
        - name: startAt
          in: query
          type: integer
          description: The index of the first item to return in a page of results (page offset).
        - name: maxResults
          in: query
          type: integer
          description: The maximum number of items to return per page.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-field-fieldId-context-projectmapping
      path: /rest/api/3/field/{fieldId}/context/projectmapping
      operations:
      - name: atlassiangetprojectcontextmapping
        method: GET
        description: Atlassian Get Project Mappings For Custom Field Context
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fieldId
          in: path
          type: string
          description: The ID of the custom field, for example `customfield\_10000`.
          required: true
        - name: contextId
          in: query
          type: array
          description: 'The list of context IDs. To include multiple context, separate IDs with ampersand: `contextId=10000&contextId=10001`.'
        - name: startAt
          in: query
          type: integer
          description: The index of the first item to return in a page of results (page offset).
        - name: maxResults
          in: query
          type: integer
          description: The maximum number of items to return per page.
    - name: rest-api-3-field-fieldId-context-contextId
      path: /rest/api/3/field/{fieldId}/context/{contextId}
      operations:
      - name: atlassiandeletecustomfieldcontext
        method: DELETE
        description: Atlassian Delete Custom Field Context
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fieldId
          in: path
          type: string
          description: The ID of the custom field.
          required: true
        - name: contextId
          in: path
          type: integer
          description: The ID of the context.
          required: true
      - name: atlassianupdatecustomfieldcontext
        method: PUT
        description: Atlassian Update Custom Field Context
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fieldId
          in: path
          type: string
          description: The ID of the custom field.
          required: true
        - name: contextId
          in: path
          type: integer
          description: The ID of the context.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-field-fieldId-context-contextId-issuetype
      path: /rest/api/3/field/{fieldId}/context/{contextId}/issuetype
      operations:
      - name: atlassianaddissuetypestocontext
        method: PUT
        description: Atlassian Add Issue Types To Context
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fieldId
          in: path
          type: string
          description: The ID of the custom field.
          required: true
        - name: contextId
          in: path
          type: integer
          description: The ID of the context.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-field-fieldId-context-contextId-issuetype-remove
      path: /rest/api/3/field/{fieldId}/context/{contextId}/issuetype/remove
      operations:
      - name: atlassianremoveissuetypesfromcontext
        method: POST
        description: Atlassian Remove Issue Types From Context
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fieldId
          in: path
          type: string
          description: The ID of the custom field.
          required: true
        - name: contextId
          in: path
          type: integer
          description: The ID of the context.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-field-fieldId-context-contextId-project
      path: /rest/api/3/field/{fieldId}/context/{contextId}/project
      operations:
      - name: atlassianassignprojectstocustomfieldcontext
        method: PUT
        description: Atlassian Assign Custom Field Context To Projects
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fieldId
          in: path
          type: string
          description: The ID of the custom field.
          required: true
        - name: contextId
          in: path
          type: integer
          description: The ID of the context.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-field-fieldId-context-contextId-project-remove
      path: /rest/api/3/field/{fieldId}/context/{contextId}/project/remove
      operations:
      - name: atlassianremovecustomfieldcontextfromprojects
        method: POST
        description: Atlassian Remove Custom Field Context From Projects
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fieldId
          in: path
          type: string
          description: The ID of the custom field.
          required: true
        - name: contextId
          in: path
          type: integer
          description: The ID of the context.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: bearer
      token: '{{env.ATLASSIAN_API_KEY}}'
  exposes:
  - type: rest
    namespace: jira-issue-custom-field-contexts-rest
    port: 8080
    description: REST adapter for Atlassian The Jira Cloud platform REST API — Issue Custom Field Contexts. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/api/3/field/{fieldid}/context
      name: rest-api-3-field-fieldid-context
      description: REST surface for rest-api-3-field-fieldId-context.
      operations:
      - method: GET
        name: atlassiangetcontextsforfield
        description: Atlassian Get Custom Field Contexts
        call: jira-issue-custom-field-contexts.atlassiangetcontextsforfield
        with:
          fieldId: rest.fieldId
          isAnyIssueType: rest.isAnyIssueType
          isGlobalContext: rest.isGlobalContext
          contextId: rest.contextId
          startAt: rest.startAt
          maxResults: rest.maxResults
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: atlassiancreatecustomfieldcontext
        description: Atlassian Create Custom Field Context
        call: jira-issue-custom-field-contexts.atlassiancreatecustomfieldcontext
        with:
          fieldId: rest.fieldId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/field/{fieldid}/context/defaultvalue
      name: rest-api-3-field-fieldid-context-defaultvalue
      description: REST surface for rest-api-3-field-fieldId-context-defaultValue.
      operations:
      - method: GET
        name: atlassiangetdefaultvalues
        description: Atlassian Get Custom Field Contexts Default Values
        call: jira-issue-custom-field-contexts.atlassiangetdefaultvalues
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
          startAt: rest.startAt
          maxResults: rest.maxResults
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: atlassiansetdefaultvalues
        description: Atlassian Set Custom Field Contexts Default Values
        call: jira-issue-custom-field-contexts.atlassiansetdefaultvalues
        with:
          fieldId: rest.fieldId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/field/{fieldid}/context/issuetypemapping
      name: rest-api-3-field-fieldid-context-issuetypemapping
      description: REST surface for rest-api-3-field-fieldId-context-issuetypemapping.
      operations:
      - method: GET
        name: atlassiangetissuetypemappingsforcontexts
        description: Atlassian Get Issue Types For Custom Field Context
        call: jira-issue-custom-field-contexts.atlassiangetissuetypemappingsforcontexts
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
          startAt: rest.startAt
          maxResults: rest.maxResults
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/field/{fieldid}/context/mapping
      name: rest-api-3-field-fieldid-context-mapping
      description: REST surface for rest-api-3-field-fieldId-context-mapping.
      operations:
      - method: POST
        name: atlassiangetcustomfieldcontextsforprojectsandissuetypes
        description: Atlassian Get Custom Field Contexts For Projects And Issue Types
        call: jira-issue-custom-field-contexts.atlassiangetcustomfieldcontextsforprojectsandissuetypes
        with:
          fieldId: rest.fieldId
          startAt: rest.startAt
          maxResults: rest.maxResults
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/field/{fieldid}/context/projectmapping
      name: rest-api-3-field-fieldid-context-projectmapping
      description: REST surface for rest-api-3-field-fieldId-context-projectmapping.
      operations:
      - method: GET
        name: atlassiangetprojectcontextmapping
        description: Atlassian Get Project Mappings For Custom Field Context
        call: jira-issue-custom-field-contexts.atlassiangetprojectcontextmapping
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
          startAt: rest.startAt
          maxResults: rest.maxResults
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/field/{fieldid}/context/{contextid}
      name: rest-api-3-field-fieldid-context-contextid
      description: REST surface for rest-api-3-field-fieldId-context-contextId.
      operations:
      - method: DELETE
        name: atlassiandeletecustomfieldcontext
        description: Atlassian Delete Custom Field Context
        call: jira-issue-custom-field-contexts.atlassiandeletecustomfieldcontext
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: atlassianupdatecustomfieldcontext
        description: Atlassian Update Custom Field Context
        call: jira-issue-custom-field-contexts.atlassianupdatecustomfieldcontext
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/field/{fieldid}/context/{contextid}/issuetype
      name: rest-api-3-field-fieldid-context-contextid-issuetype
      description: REST surface for rest-api-3-field-fieldId-context-contextId-issuetype.
      operations:
      - method: PUT
        name: atlassianaddissuetypestocontext
        description: Atlassian Add Issue Types To Context
        call: jira-issue-custom-field-contexts.atlassianaddissuetypestocontext
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/field/{fieldid}/context/{contextid}/issuetype/remove
      name: rest-api-3-field-fieldid-context-contextid-issuetype-remove
      description: REST surface for rest-api-3-field-fieldId-context-contextId-issuetype-remove.
      operations:
      - method: POST
        name: atlassianremoveissuetypesfromcontext
        description: Atlassian Remove Issue Types From Context
        call: jira-issue-custom-field-contexts.atlassianremoveissuetypesfromcontext
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/field/{fieldid}/context/{contextid}/project
      name: rest-api-3-field-fieldid-context-contextid-project
      description: REST surface for rest-api-3-field-fieldId-context-contextId-project.
      operations:
      - method: PUT
        name: atlassianassignprojectstocustomfieldcontext
        description: Atlassian Assign Custom Field Context To Projects
        call: jira-issue-custom-field-contexts.atlassianassignprojectstocustomfieldcontext
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/field/{fieldid}/context/{contextid}/project/remove
      name: rest-api-3-field-fieldid-context-contextid-project-remove
      description: REST surface for rest-api-3-field-fieldId-context-contextId-project-remove.
      operations:
      - method: POST
        name: atlassianremovecustomfieldcontextfromprojects
        description: Atlassian Remove Custom Field Context From Projects
        call: jira-issue-custom-field-contexts.atlassianremovecustomfieldcontextfromprojects
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: jira-issue-custom-field-contexts-mcp
    port: 9090
    transport: http
    description: MCP adapter for Atlassian The Jira Cloud platform REST API — Issue Custom Field Contexts. One tool per consumed
      operation, routed inline through this capability's consumes block.
    tools:
    - name: atlassian-get-custom-field-contexts
      description: Atlassian Get Custom Field Contexts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-issue-custom-field-contexts.atlassiangetcontextsforfield
      with:
        fieldId: tools.fieldId
        isAnyIssueType: tools.isAnyIssueType
        isGlobalContext: tools.isGlobalContext
        contextId: tools.contextId
        startAt: tools.startAt
        maxResults: tools.maxResults
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-create-custom-field-context
      description: Atlassian Create Custom Field Context
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: jira-issue-custom-field-contexts.atlassiancreatecustomfieldcontext
      with:
        fieldId: tools.fieldId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-custom-field-contexts-2
      description: Atlassian Get Custom Field Contexts Default Values
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-issue-custom-field-contexts.atlassiangetdefaultvalues
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
        startAt: tools.startAt
        maxResults: tools.maxResults
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-set-custom-field-contexts
      description: Atlassian Set Custom Field Contexts Default Values
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: jira-issue-custom-field-contexts.atlassiansetdefaultvalues
      with:
        fieldId: tools.fieldId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-issue-types-custom
      description: Atlassian Get Issue Types For Custom Field Context
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-issue-custom-field-contexts.atlassiangetissuetypemappingsforcontexts
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
        startAt: tools.startAt
        maxResults: tools.maxResults
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-custom-field-contexts-3
      description: Atlassian Get Custom Field Contexts For Projects And Issue Types
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: jira-issue-custom-field-contexts.atlassiangetcustomfieldcontextsforprojectsandissuetypes
      with:
        fieldId: tools.fieldId
        startAt: tools.startAt
        maxResults: tools.maxResults
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-project-mappings-custom
      description: Atlassian Get Project Mappings For Custom Field Context
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-issue-custom-field-contexts.atlassiangetprojectcontextmapping
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
        startAt: tools.startAt
        maxResults: tools.maxResults
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-delete-custom-field-context
      description: Atlassian Delete Custom Field Context
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: jira-issue-custom-field-contexts.atlassiandeletecustomfieldcontext
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-update-custom-field-context
      description: Atlassian Update Custom Field Context
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: jira-issue-custom-field-contexts.atlassianupdatecustomfieldcontext
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-add-issue-types-context
      description: Atlassian Add Issue Types To Context
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: jira-issue-custom-field-contexts.atlassianaddissuetypestocontext
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-remove-issue-types-context
      description: Atlassian Remove Issue Types From Context
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: jira-issue-custom-field-contexts.atlassianremoveissuetypesfromcontext
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-assign-custom-field-context
      description: Atlassian Assign Custom Field Context To Projects
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: jira-issue-custom-field-contexts.atlassianassignprojectstocustomfieldcontext
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-remove-custom-field-context
      description: Atlassian Remove Custom Field Context From Projects
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: jira-issue-custom-field-contexts.atlassianremovecustomfieldcontextfromprojects
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.