> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# jira-itsm

> IT service management

**Server path:** `/jira-itsm` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                      | Description                                                         |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| [`jira-itsm_get_service_desk_info`](#jira-itsm_get_service_desk_info)     | Get general information about the Jira Service Desk instance        |
| [`jira-itsm_list_service_desks`](#jira-itsm_list_service_desks)           | List all service desk projects that the user has permission to view |
| [`jira-itsm_get_service_desk_by_id`](#jira-itsm_get_service_desk_by_id)   | Retrieve a specific service desk by its ID                          |
| [`jira-itsm_create_customer_request`](#jira-itsm_create_customer_request) | Create a new customer request (ticket) in a specified service desk  |
| [`jira-itsm_list_customer_requests`](#jira-itsm_list_customer_requests)   | List customer requests with optional filtering and pagination       |
| [`jira-itsm_get_customer_request`](#jira-itsm_get_customer_request)       | Retrieve a specific customer request by its ID or key               |
| [`jira_itsm_get_request_status`](#jira_itsm_get_request_status)           | Get status history for a specific customer request                  |
| [`jira_itsm_get_request_types`](#jira_itsm_get_request_types)             | Get all request types available for a specific service desk         |
| [`jira_itsm_get_request_type_by_id`](#jira_itsm_get_request_type_by_id)   | Get details of a specific request type                              |

***

## jira-itsm\_get\_service\_desk\_info

Get general information about the Jira Service Desk instance

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## jira-itsm\_list\_service\_desks

List all service desk projects that the user has permission to view

**Parameters:**

| Parameter | Type   | Required | Default | Description                                             |
| --------- | ------ | -------- | ------- | ------------------------------------------------------- |
| `start`   | number | No       | `0`     | Starting index for pagination (default: 0)              |
| `limit`   | number | No       | `50`    | Maximum number of service desks to return (default: 50) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "start": {
        "type": "number",
        "default": 0,
        "description": "Starting index for pagination (default: 0)"
      },
      "limit": {
        "type": "number",
        "default": 50,
        "description": "Maximum number of service desks to return (default: 50)"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## jira-itsm\_get\_service\_desk\_by\_id

Retrieve a specific service desk by its ID

**Parameters:**

| Parameter       | Type   | Required | Default | Description                                           |
| --------------- | ------ | -------- | ------- | ----------------------------------------------------- |
| `serviceDeskId` | string | Yes      | —       | The unique identifier of the service desk to retrieve |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "serviceDeskId": {
        "type": "string",
        "description": "The unique identifier of the service desk to retrieve"
      }
    },
    "required": [
      "PCID",
      "serviceDeskId"
    ]
  }
  ```
</Expandable>

***

## jira-itsm\_create\_customer\_request

Create a new customer request (ticket) in a specified service desk

**Parameters:**

| Parameter            | Type   | Required | Default | Description                                                    |
| -------------------- | ------ | -------- | ------- | -------------------------------------------------------------- |
| `serviceDeskId`      | string | Yes      | —       | The ID of the service desk where the request will be created   |
| `requestTypeId`      | string | Yes      | —       | The ID of the request type for the new request                 |
| `requestFieldValues` | object | Yes      | —       | Field values for the request including summary and description |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "serviceDeskId": {
        "type": "string",
        "description": "The ID of the service desk where the request will be created"
      },
      "requestTypeId": {
        "type": "string",
        "description": "The ID of the request type for the new request"
      },
      "requestFieldValues": {
        "type": "object",
        "properties": {
          "summary": {
            "type": "string",
            "description": "Title/summary of the request"
          },
          "description": {
            "type": "string",
            "description": "Detailed description of the request"
          }
        },
        "description": "Field values for the request including summary and description"
      }
    },
    "required": [
      "PCID",
      "serviceDeskId",
      "requestTypeId",
      "requestFieldValues"
    ]
  }
  ```
</Expandable>

***

## jira-itsm\_list\_customer\_requests

List customer requests with optional filtering and pagination

**Parameters:**

| Parameter          | Type   | Required | Default | Description                                                 |
| ------------------ | ------ | -------- | ------- | ----------------------------------------------------------- |
| `start`            | number | No       | `0`     | Starting index for pagination (default: 0)                  |
| `limit`            | number | No       | `50`    | Maximum number of requests to return (default: 50)          |
| `requestOwnership` | string | No       | —       | Filter by request ownership (e.g., "owned", "participated") |
| `requestStatus`    | string | No       | —       | Filter by request status (e.g., "open", "closed")           |
| `searchTerm`       | string | No       | —       | Search term to filter requests by content                   |
| `serviceDeskId`    | string | No       | —       | Filter requests by specific service desk ID                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "start": {
        "type": "number",
        "default": 0,
        "description": "Starting index for pagination (default: 0)"
      },
      "limit": {
        "type": "number",
        "default": 50,
        "description": "Maximum number of requests to return (default: 50)"
      },
      "requestOwnership": {
        "type": "string",
        "description": "Filter by request ownership (e.g., \"owned\", \"participated\")"
      },
      "requestStatus": {
        "type": "string",
        "description": "Filter by request status (e.g., \"open\", \"closed\")"
      },
      "searchTerm": {
        "type": "string",
        "description": "Search term to filter requests by content"
      },
      "serviceDeskId": {
        "type": "string",
        "description": "Filter requests by specific service desk ID"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## jira-itsm\_get\_customer\_request

Retrieve a specific customer request by its ID or key

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                             |
| -------------- | ------ | -------- | ------- | ------------------------------------------------------- |
| `issueIdOrKey` | string | Yes      | —       | The issue ID or key of the customer request to retrieve |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "issueIdOrKey": {
        "type": "string",
        "description": "The issue ID or key of the customer request to retrieve"
      }
    },
    "required": [
      "PCID",
      "issueIdOrKey"
    ]
  }
  ```
</Expandable>

***

## jira\_itsm\_get\_request\_status

Get status history for a specific customer request

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                              |
| -------------- | ------ | -------- | ------- | -------------------------------------------------------- |
| `issueIdOrKey` | string | Yes      | —       | The issue ID or key of the customer request              |
| `start`        | number | No       | `0`     | Starting index for pagination (default: 0)               |
| `limit`        | number | No       | `50`    | Maximum number of status entries to return (default: 50) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "issueIdOrKey": {
        "type": "string",
        "description": "The issue ID or key of the customer request"
      },
      "start": {
        "type": "number",
        "default": 0,
        "description": "Starting index for pagination (default: 0)"
      },
      "limit": {
        "type": "number",
        "default": 50,
        "description": "Maximum number of status entries to return (default: 50)"
      }
    },
    "required": [
      "PCID",
      "issueIdOrKey"
    ]
  }
  ```
</Expandable>

***

## jira\_itsm\_get\_request\_types

Get all request types available for a specific service desk

**Parameters:**

| Parameter       | Type   | Required | Default | Description                                         |
| --------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `serviceDeskId` | string | Yes      | —       | The ID of the service desk to get request types for |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "serviceDeskId": {
        "type": "string",
        "description": "The ID of the service desk to get request types for"
      }
    },
    "required": [
      "PCID",
      "serviceDeskId"
    ]
  }
  ```
</Expandable>

***

## jira\_itsm\_get\_request\_type\_by\_id

Get details of a specific request type

**Parameters:**

| Parameter       | Type   | Required | Default | Description                            |
| --------------- | ------ | -------- | ------- | -------------------------------------- |
| `serviceDeskId` | string | Yes      | —       | The ID of the service desk             |
| `requestTypeId` | string | Yes      | —       | The ID of the request type to retrieve |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "serviceDeskId": {
        "type": "string",
        "description": "The ID of the service desk"
      },
      "requestTypeId": {
        "type": "string",
        "description": "The ID of the request type to retrieve"
      }
    },
    "required": [
      "PCID",
      "serviceDeskId",
      "requestTypeId"
    ]
  }
  ```
</Expandable>