Open Context Protocol is live! 🚀 Read the launch post
getCreateIssueMetaIssueTypes

getCreateIssueMetaIssueTypes

Get create metadata issue types for a project

Details

  • Method: GET
  • Path: /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes
  • Operation ID: getCreateIssueMetaIssueTypes

Parameters

{
  "projectIdOrKey": {
    "description": "The ID or key of the project.",
    "required": true,
    "location": "path",
    "type": "string"
  },
  "startAt": {
    "description": "The index of the first item to return in a page of results (page offset).",
    "required": false,
    "location": "query",
    "type": "integer",
    "format": "int32"
  },
  "maxResults": {
    "description": "The maximum number of items to return per page.",
    "required": false,
    "location": "query",
    "type": "integer",
    "format": "int32"
  }
}

Response Schema

{
  "additionalProperties": true,
  "description": "A page of CreateMetaIssueTypes.",
  "properties": {
    "createMetaIssueType": {
      "items": {
        "additionalProperties": false,
        "description": "Details of the issue creation metadata for 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"
          },
          "expand": {
            "description": "Expand options that include additional issue type metadata details in the response.",
            "readOnly": true,
            "type": "string",
            "xml": {
              "attribute": true
            }
          },
          "fields": {
            "additionalProperties": {
              "additionalProperties": false,
              "description": "The metadata describing an issue field.",
              "properties": {
                "allowedValues": {
                  "description": "The list of values allowed in the field.",
                  "items": {
                    "readOnly": true
                  },
                  "readOnly": true,
                  "type": "array"
                },
                "autoCompleteUrl": {
                  "description": "The URL that can be used to automatically complete the field.",
                  "readOnly": true,
                  "type": "string"
                },
                "configuration": {
                  "additionalProperties": {
                    "readOnly": true
                  },
                  "description": "The configuration properties.",
                  "readOnly": true,
                  "type": "object"
                },
                "defaultValue": {
                  "description": "The default value of the field.",
                  "readOnly": true
                },
                "hasDefaultValue": {
                  "description": "Whether the field has a default value.",
                  "readOnly": true,
                  "type": "boolean"
                },
                "key": {
                  "description": "The key of the field.",
                  "readOnly": true,
                  "type": "string"
                },
                "name": {
                  "description": "The name of the field.",
                  "readOnly": true,
                  "type": "string"
                },
                "operations": {
                  "description": "The list of operations that can be performed on the field.",
                  "items": {
                    "readOnly": true,
                    "type": "string"
                  },
                  "readOnly": true,
                  "type": "array"
                },
                "required": {
                  "description": "Whether the field is required.",
                  "readOnly": true,
                  "type": "boolean"
                },
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/JsonTypeBean"
                    }
                  ],
                  "description": "The data type of the field.",
                  "readOnly": true
                }
              },
              "required": [
                "key",
                "name",
                "operations",
                "required",
                "schema"
              ],
              "type": "object",
              "xml": {
                "name": "availableField"
              }
            },
            "description": "List of the fields available when creating an issue for the issue type.",
            "readOnly": true,
            "type": "object"
          },
          "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"
      },
      "type": "array",
      "writeOnly": true
    },
    "issueTypes": {
      "description": "The list of CreateMetaIssueType.",
      "items": {
        "additionalProperties": false,
        "description": "Details of the issue creation metadata for 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"
          },
          "expand": {
            "description": "Expand options that include additional issue type metadata details in the response.",
            "readOnly": true,
            "type": "string",
            "xml": {
              "attribute": true
            }
          },
          "fields": {
            "additionalProperties": {
              "additionalProperties": false,
              "description": "The metadata describing an issue field.",
              "properties": {
                "allowedValues": {
                  "description": "The list of values allowed in the field.",
                  "items": {
                    "readOnly": true
                  },
                  "readOnly": true,
                  "type": "array"
                },
                "autoCompleteUrl": {
                  "description": "The URL that can be used to automatically complete the field.",
                  "readOnly": true,
                  "type": "string"
                },
                "configuration": {
                  "additionalProperties": {
                    "readOnly": true
                  },
                  "description": "The configuration properties.",
                  "readOnly": true,
                  "type": "object"
                },
                "defaultValue": {
                  "description": "The default value of the field.",
                  "readOnly": true
                },
                "hasDefaultValue": {
                  "description": "Whether the field has a default value.",
                  "readOnly": true,
                  "type": "boolean"
                },
                "key": {
                  "description": "The key of the field.",
                  "readOnly": true,
                  "type": "string"
                },
                "name": {
                  "description": "The name of the field.",
                  "readOnly": true,
                  "type": "string"
                },
                "operations": {
                  "description": "The list of operations that can be performed on the field.",
                  "items": {
                    "readOnly": true,
                    "type": "string"
                  },
                  "readOnly": true,
                  "type": "array"
                },
                "required": {
                  "description": "Whether the field is required.",
                  "readOnly": true,
                  "type": "boolean"
                },
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/JsonTypeBean"
                    }
                  ],
                  "description": "The data type of the field.",
                  "readOnly": true
                }
              },
              "required": [
                "key",
                "name",
                "operations",
                "required",
                "schema"
              ],
              "type": "object",
              "xml": {
                "name": "availableField"
              }
            },
            "description": "List of the fields available when creating an issue for the issue type.",
            "readOnly": true,
            "type": "object"
          },
          "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"
      },
      "readOnly": true,
      "type": "array"
    },
    "maxResults": {
      "description": "The maximum number of items to return per page.",
      "format": "int32",
      "readOnly": true,
      "type": "integer"
    },
    "startAt": {
      "description": "The index of the first item returned.",
      "format": "int64",
      "readOnly": true,
      "type": "integer"
    },
    "total": {
      "description": "The total number of items in all pages.",
      "format": "int64",
      "readOnly": true,
      "type": "integer"
    }
  },
  "type": "object"
}

Usage

from ocp_agent import OCPAgent

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

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