Open Context Protocol is live! 🚀 Read the launch post

createIssueType

Create issue type

Details

  • Method: POST
  • Path: /rest/api/3/issuetype
  • Operation ID: createIssueType

Parameters

{
  "description": {
    "description": "The description of the issue type.",
    "required": false,
    "location": "body",
    "type": "string"
  },
  "hierarchyLevel": {
    "description": "The hierarchy level of the issue type. Use:\n\n *  `-1` for Subtask.\n *  `0` for Base.\n\nDefaults to `0`.",
    "required": false,
    "location": "body",
    "type": "integer"
  },
  "name": {
    "description": "The unique name for the issue type. The maximum length is 60 characters.",
    "required": true,
    "location": "body",
    "type": "string"
  },
  "type": {
    "description": "Deprecated. Use `hierarchyLevel` instead. See the [deprecation notice](https://community.developer.atlassian.com/t/deprecation-of-the-epic-link-parent-link-and-other-related-fields-in-rest-apis-and-webhooks/54048) for details.\n\nWhether the issue type is `subtype` or `standard`. Defaults to `standard`.",
    "required": false,
    "location": "body",
    "type": "string",
    "enum": [
      "subtask",
      "standard"
    ]
  }
}

Response Schema

{
  "additionalProperties": false,
  "description": "Details about an issue type.",
  "properties": {
    "avatarId": {
      "description": "The ID of the issue type's avatar.",
      "format": "int64",
      "readOnly": true,
      "type": "integer"
    },
    "description": {
      "description": "The description of the issue type.",
      "readOnly": true,
      "type": "string"
    },
    "entityId": {
      "description": "Unique ID for next-gen projects.",
      "format": "uuid",
      "readOnly": true,
      "type": "string"
    },
    "hierarchyLevel": {
      "description": "Hierarchy level of the issue type.",
      "format": "int32",
      "readOnly": true,
      "type": "integer"
    },
    "iconUrl": {
      "description": "The URL of the issue type's avatar.",
      "readOnly": true,
      "type": "string"
    },
    "id": {
      "description": "The ID of the issue type.",
      "readOnly": true,
      "type": "string"
    },
    "name": {
      "description": "The name of the issue type.",
      "readOnly": true,
      "type": "string"
    },
    "scope": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Scope"
        }
      ],
      "description": "Details of the next-gen projects the issue type is available in.",
      "readOnly": true
    },
    "self": {
      "description": "The URL of these issue type details.",
      "readOnly": true,
      "type": "string"
    },
    "subtask": {
      "description": "Whether this issue type is used to create subtasks.",
      "readOnly": true,
      "type": "boolean"
    }
  },
  "type": "object"
}

Usage

from ocp_agent import OCPAgent

agent = OCPAgent()
await agent.register_api('jira')

# Call this tool
result = await agent.call_tool('createIssueType', {
    # Add required parameters here
})