naftiko: 1.0.0-alpha2
info:
  label: Atlassian The Jira Cloud platform REST API — Issue Custom Field Options
  description: 'Atlassian The Jira Cloud platform REST API — Issue Custom Field Options. 6 operations. Lead operation: Atlassian
    Get Custom Field Option. Self-contained Naftiko capability covering one Atlassian business surface.'
  tags:
  - Atlassian
  - Issue Custom Field Options
  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-options
    baseUri: https://your-domain.atlassian.net
    description: Atlassian The Jira Cloud platform REST API — Issue Custom Field Options business capability. Self-contained,
      no shared references.
    resources:
    - name: rest-api-3-customFieldOption-id
      path: /rest/api/3/customFieldOption/{id}
      operations:
      - name: atlassiangetcustomfieldoption
        method: GET
        description: Atlassian Get Custom Field Option
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The ID of the custom field option.
          required: true
    - name: rest-api-3-field-fieldId-context-contextId-option
      path: /rest/api/3/field/{fieldId}/context/{contextId}/option
      operations:
      - name: atlassiangetoptionsforcontext
        method: GET
        description: Atlassian Get Custom Field Options 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: optionId
          in: query
          type: integer
          description: The ID of the option.
        - name: onlyOptions
          in: query
          type: boolean
          description: Whether only options are returned.
        - 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: atlassiancreatecustomfieldoption
        method: POST
        description: Atlassian Create Custom Field Options 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: atlassianupdatecustomfieldoption
        method: PUT
        description: Atlassian Update Custom Field Options 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-option-move
      path: /rest/api/3/field/{fieldId}/context/{contextId}/option/move
      operations:
      - name: atlassianreordercustomfieldoptions
        method: PUT
        description: Atlassian Reorder Custom Field Options 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-option-optionId
      path: /rest/api/3/field/{fieldId}/context/{contextId}/option/{optionId}
      operations:
      - name: atlassiandeletecustomfieldoption
        method: DELETE
        description: Atlassian Delete Custom Field Options 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 from which an option should be deleted.
          required: true
        - name: optionId
          in: path
          type: integer
          description: The ID of the option to delete.
          required: true
    authentication:
      type: bearer
      token: '{{env.ATLASSIAN_API_KEY}}'
  exposes:
  - type: rest
    namespace: jira-issue-custom-field-options-rest
    port: 8080
    description: REST adapter for Atlassian The Jira Cloud platform REST API — Issue Custom Field Options. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/api/3/customfieldoption/{id}
      name: rest-api-3-customfieldoption-id
      description: REST surface for rest-api-3-customFieldOption-id.
      operations:
      - method: GET
        name: atlassiangetcustomfieldoption
        description: Atlassian Get Custom Field Option
        call: jira-issue-custom-field-options.atlassiangetcustomfieldoption
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/field/{fieldid}/context/{contextid}/option
      name: rest-api-3-field-fieldid-context-contextid-option
      description: REST surface for rest-api-3-field-fieldId-context-contextId-option.
      operations:
      - method: GET
        name: atlassiangetoptionsforcontext
        description: Atlassian Get Custom Field Options Context
        call: jira-issue-custom-field-options.atlassiangetoptionsforcontext
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
          optionId: rest.optionId
          onlyOptions: rest.onlyOptions
          startAt: rest.startAt
          maxResults: rest.maxResults
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: atlassiancreatecustomfieldoption
        description: Atlassian Create Custom Field Options Context
        call: jira-issue-custom-field-options.atlassiancreatecustomfieldoption
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: atlassianupdatecustomfieldoption
        description: Atlassian Update Custom Field Options Context
        call: jira-issue-custom-field-options.atlassianupdatecustomfieldoption
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/field/{fieldid}/context/{contextid}/option/move
      name: rest-api-3-field-fieldid-context-contextid-option-move
      description: REST surface for rest-api-3-field-fieldId-context-contextId-option-move.
      operations:
      - method: PUT
        name: atlassianreordercustomfieldoptions
        description: Atlassian Reorder Custom Field Options Context
        call: jira-issue-custom-field-options.atlassianreordercustomfieldoptions
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/field/{fieldid}/context/{contextid}/option/{optionid}
      name: rest-api-3-field-fieldid-context-contextid-option-optionid
      description: REST surface for rest-api-3-field-fieldId-context-contextId-option-optionId.
      operations:
      - method: DELETE
        name: atlassiandeletecustomfieldoption
        description: Atlassian Delete Custom Field Options Context
        call: jira-issue-custom-field-options.atlassiandeletecustomfieldoption
        with:
          fieldId: rest.fieldId
          contextId: rest.contextId
          optionId: rest.optionId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: jira-issue-custom-field-options-mcp
    port: 9090
    transport: http
    description: MCP adapter for Atlassian The Jira Cloud platform REST API — Issue Custom Field Options. One tool per consumed
      operation, routed inline through this capability's consumes block.
    tools:
    - name: atlassian-get-custom-field-option
      description: Atlassian Get Custom Field Option
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-issue-custom-field-options.atlassiangetcustomfieldoption
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-custom-field-options
      description: Atlassian Get Custom Field Options Context
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-issue-custom-field-options.atlassiangetoptionsforcontext
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
        optionId: tools.optionId
        onlyOptions: tools.onlyOptions
        startAt: tools.startAt
        maxResults: tools.maxResults
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-create-custom-field-options
      description: Atlassian Create Custom Field Options Context
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: jira-issue-custom-field-options.atlassiancreatecustomfieldoption
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-update-custom-field-options
      description: Atlassian Update Custom Field Options Context
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: jira-issue-custom-field-options.atlassianupdatecustomfieldoption
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-reorder-custom-field-options
      description: Atlassian Reorder Custom Field Options Context
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: jira-issue-custom-field-options.atlassianreordercustomfieldoptions
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-delete-custom-field-options
      description: Atlassian Delete Custom Field Options Context
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: jira-issue-custom-field-options.atlassiandeletecustomfieldoption
      with:
        fieldId: tools.fieldId
        contextId: tools.contextId
        optionId: tools.optionId
      outputParameters:
      - type: object
        mapping: $.