Atlassian rest/api/3/workflow/ — Workflow Transition Properties

naftiko: 1.0.0-alpha2
info:
  label: Atlassian rest/api/3/workflow/ — Workflow Transition Properties
  description: 'Atlassian rest/api/3/workflow/ — Workflow Transition Properties. 4 operations. Lead operation: Atlassian Delete
    Workflow Transition Property. Self-contained Naftiko capability covering one Atlassian business surface.'
  tags:
  - Atlassian
  - Workflow Transition Properties
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ATLASSIAN_API_KEY: ATLASSIAN_API_KEY
capability:
  consumes:
  - type: http
    namespace: rest-api-3-workflow--workflow-transition-properties
    baseUri: https://your-domain.atlassian.net
    description: Atlassian rest/api/3/workflow/ — Workflow Transition Properties business capability. Self-contained, no shared
      references.
    resources:
    - name: rest-api-3-workflow-transitions-transitionId-properties
      path: /rest/api/3/workflow/transitions/{transitionId}/properties
      operations:
      - name: atlassiandeleteworkflowtransitionproperty
        method: DELETE
        description: Atlassian Delete Workflow Transition Property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: transitionId
          in: path
          type: integer
          description: The ID of the transition. To get the ID, view the workflow in text mode in the Jira admin settings.
            The ID is shown next to the transition.
          required: true
        - name: key
          in: query
          type: string
          description: The name of the transition property to delete, also known as the name of the property.
          required: true
        - name: workflowName
          in: query
          type: string
          description: The name of the workflow that the transition belongs to.
          required: true
        - name: workflowMode
          in: query
          type: string
          description: The workflow status. Set to `live` for inactive workflows or `draft` for draft workflows. Active workflows
            cannot be edited.
      - name: atlassiangetworkflowtransitionproperties
        method: GET
        description: Atlassian Get Workflow Transition Properties
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: transitionId
          in: path
          type: integer
          description: The ID of the transition. To get the ID, view the workflow in text mode in the Jira administration
            console. The ID is shown next to the transition.
          required: true
        - name: includeReservedKeys
          in: query
          type: boolean
          description: Some properties with keys that have the *jira.* prefix are reserved, which means they are not editable.
            To include these properties in the results, set this par
        - name: key
          in: query
          type: string
          description: The key of the property being returned, also known as the name of the property. If this parameter is
            not specified, all properties on the transition are returne
        - name: workflowName
          in: query
          type: string
          description: The name of the workflow that the transition belongs to.
          required: true
        - name: workflowMode
          in: query
          type: string
          description: The workflow status. Set to *live* for active and inactive workflows, or *draft* for draft workflows.
      - name: atlassiancreateworkflowtransitionproperty
        method: POST
        description: Atlassian Create Workflow Transition Property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: transitionId
          in: path
          type: integer
          description: The ID of the transition. To get the ID, view the workflow in text mode in the Jira admin settings.
            The ID is shown next to the transition.
          required: true
        - name: key
          in: query
          type: string
          description: The key of the property being added, also known as the name of the property. Set this to the same value
            as the `key` defined in the request body.
          required: true
        - name: workflowName
          in: query
          type: string
          description: The name of the workflow that the transition belongs to.
          required: true
        - name: workflowMode
          in: query
          type: string
          description: The workflow status. Set to *live* for inactive workflows or *draft* for draft workflows. Active workflows
            cannot be edited.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: atlassianupdateworkflowtransitionproperty
        method: PUT
        description: Atlassian Update Workflow Transition Property
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: transitionId
          in: path
          type: integer
          description: The ID of the transition. To get the ID, view the workflow in text mode in the Jira admin settings.
            The ID is shown next to the transition.
          required: true
        - name: key
          in: query
          type: string
          description: The key of the property being updated, also known as the name of the property. Set this to the same
            value as the `key` defined in the request body.
          required: true
        - name: workflowName
          in: query
          type: string
          description: The name of the workflow that the transition belongs to.
          required: true
        - name: workflowMode
          in: query
          type: string
          description: The workflow status. Set to `live` for inactive workflows or `draft` for draft workflows. Active workflows
            cannot be edited.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
  exposes:
  - type: rest
    namespace: rest-api-3-workflow--workflow-transition-properties-rest
    port: 8080
    description: REST adapter for Atlassian rest/api/3/workflow/ — Workflow Transition Properties. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/api/3/workflow/transitions/{transitionid}/properties
      name: rest-api-3-workflow-transitions-transitionid-properties
      description: REST surface for rest-api-3-workflow-transitions-transitionId-properties.
      operations:
      - method: DELETE
        name: atlassiandeleteworkflowtransitionproperty
        description: Atlassian Delete Workflow Transition Property
        call: rest-api-3-workflow--workflow-transition-properties.atlassiandeleteworkflowtransitionproperty
        with:
          transitionId: rest.transitionId
          key: rest.key
          workflowName: rest.workflowName
          workflowMode: rest.workflowMode
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: atlassiangetworkflowtransitionproperties
        description: Atlassian Get Workflow Transition Properties
        call: rest-api-3-workflow--workflow-transition-properties.atlassiangetworkflowtransitionproperties
        with:
          transitionId: rest.transitionId
          includeReservedKeys: rest.includeReservedKeys
          key: rest.key
          workflowName: rest.workflowName
          workflowMode: rest.workflowMode
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: atlassiancreateworkflowtransitionproperty
        description: Atlassian Create Workflow Transition Property
        call: rest-api-3-workflow--workflow-transition-properties.atlassiancreateworkflowtransitionproperty
        with:
          transitionId: rest.transitionId
          key: rest.key
          workflowName: rest.workflowName
          workflowMode: rest.workflowMode
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: atlassianupdateworkflowtransitionproperty
        description: Atlassian Update Workflow Transition Property
        call: rest-api-3-workflow--workflow-transition-properties.atlassianupdateworkflowtransitionproperty
        with:
          transitionId: rest.transitionId
          key: rest.key
          workflowName: rest.workflowName
          workflowMode: rest.workflowMode
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: rest-api-3-workflow--workflow-transition-properties-mcp
    port: 9090
    transport: http
    description: MCP adapter for Atlassian rest/api/3/workflow/ — Workflow Transition Properties. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: atlassian-delete-workflow-transition-property
      description: Atlassian Delete Workflow Transition Property
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: rest-api-3-workflow--workflow-transition-properties.atlassiandeleteworkflowtransitionproperty
      with:
        transitionId: tools.transitionId
        key: tools.key
        workflowName: tools.workflowName
        workflowMode: tools.workflowMode
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-workflow-transition-properties
      description: Atlassian Get Workflow Transition Properties
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-api-3-workflow--workflow-transition-properties.atlassiangetworkflowtransitionproperties
      with:
        transitionId: tools.transitionId
        includeReservedKeys: tools.includeReservedKeys
        key: tools.key
        workflowName: tools.workflowName
        workflowMode: tools.workflowMode
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-create-workflow-transition-property
      description: Atlassian Create Workflow Transition Property
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: rest-api-3-workflow--workflow-transition-properties.atlassiancreateworkflowtransitionproperty
      with:
        transitionId: tools.transitionId
        key: tools.key
        workflowName: tools.workflowName
        workflowMode: tools.workflowMode
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-update-workflow-transition-property
      description: Atlassian Update Workflow Transition Property
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: rest-api-3-workflow--workflow-transition-properties.atlassianupdateworkflowtransitionproperty
      with:
        transitionId: tools.transitionId
        key: tools.key
        workflowName: tools.workflowName
        workflowMode: tools.workflowMode
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.