jira-users

Server path: /jira-users | Type: Application | PCID required: Yes

Tools

Tool	Description
`jira_users_find_assignable_users`	Find users assignable to issues
`jira_users_find_users`	Find users
`jira_users_find_users_and_groups`	Find users and groups
`jira_users_find_users_for_picker`	Find users for picker
`jira_users_get_bulk_permissions`	Get bulk permissions
`jira_users_get_current_user`	Get current user
`jira_users_get_my_permissions`	Get my permissions
`jira_users_get_user`	Get user

jira_users_find_assignable_users

Find users assignable to issues Parameters:

Parameter	Type	Required	Default	Description
`query`	string	No	—	A query string that is matched against user attributes, such as `displayName`, and `emailAddress`, to find relevant users. The string can match the prefix of the attribute’s value. For example, query=john matches a user with a `displayName` of John Smith and a user with an `emailAddress` of johnson@example.com. Required, unless `username` or `accountId` is specified.
`sessionId`	string	No	—	The sessionId of this request. SessionId is the same until the assignee is set.
`username`	string	No	—	This parameter is no longer available. See the deprecation notice for details.
`accountId`	string	No	—	A query string that is matched exactly against user `accountId`. Required, unless `query` is specified.
`project`	string	No	—	The project ID or project key (case sensitive). Required, unless `issueKey` or `issueId` is specified.
`issueKey`	string	No	—	The key of the issue. Required, unless `issueId` or `project` is specified.
`issueId`	string	No	—	The ID of the issue. Required, unless `issueKey` or `project` is specified.
`startAt`	integer	No	—	The index of the first item to return in a page of results (page offset).
`maxResults`	integer	No	—	The maximum number of items to return. This operation may return less than the maximum number of items even if more are available. The operation fetches users up to the maximum and then, from the fetched users, returns only the users that can be assigned to the issue.
`actionDescriptorId`	integer	No	—	The ID of the transition.
`recommend`	boolean	No	—	recommend
`accountType`	any[]	No	—	accountType
`appType`	any[]	No	—	appType

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "query": {
      "type": "string",
      "description": "A query string that is matched against user attributes, such as `displayName`, and `emailAddress`, to find relevant users. The string can match the prefix of the attribute's value. For example, *query=john* matches a user with a `displayName` of *John Smith* and a user with an `emailAddress` of *johnson@example.com*. Required, unless `username` or `accountId` is specified."
    },
    "sessionId": {
      "type": "string",
      "description": "The sessionId of this request. SessionId is the same until the assignee is set."
    },
    "username": {
      "type": "string",
      "description": "This parameter is no longer available. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details."
    },
    "accountId": {
      "type": "string",
      "description": "A query string that is matched exactly against user `accountId`. Required, unless `query` is specified."
    },
    "project": {
      "type": "string",
      "description": "The project ID or project key (case sensitive). Required, unless `issueKey` or `issueId` is specified."
    },
    "issueKey": {
      "type": "string",
      "description": "The key of the issue. Required, unless `issueId` or `project` is specified."
    },
    "issueId": {
      "type": "string",
      "description": "The ID of the issue. Required, unless `issueKey` or `project` is specified."
    },
    "startAt": {
      "type": "integer",
      "description": "The index of the first item to return in a page of results (page offset)."
    },
    "maxResults": {
      "type": "integer",
      "description": "The maximum number of items to return. This operation may return less than the maximum number of items even if more are available. The operation fetches users up to the maximum and then, from the fetched users, returns only the users that can be assigned to the issue."
    },
    "actionDescriptorId": {
      "type": "integer",
      "description": "The ID of the transition."
    },
    "recommend": {
      "type": "boolean",
      "description": "recommend"
    },
    "accountType": {
      "type": "array",
      "description": "accountType"
    },
    "appType": {
      "type": "array",
      "description": "appType"
    }
  },
  "required": [
    "PCID"
  ]
}

jira_users_find_users

Find users Parameters:

Parameter	Type	Required	Default	Description
`query`	string	No	—	A query string that is matched against user attributes ( `displayName`, and `emailAddress`) to find relevant users. The string can match the prefix of the attribute’s value. For example, query=john matches a user with a `displayName` of John Smith and a user with an `emailAddress` of johnson@example.com. Required, unless `accountId` or `property` is specified.
`username`	string	No	—	username
`accountId`	string	No	—	A query string that is matched exactly against a user `accountId`. Required, unless `query` or `property` is specified.
`startAt`	integer	No	—	The index of the first item to return in a page of filtered results (page offset).
`maxResults`	integer	No	—	The maximum number of items to return per page.
`property`	string	No	—	A query string used to search properties. Property keys are specified by path, so property keys containing dot (.) or equals (=) characters cannot be used. The query string cannot be specified using a JSON object. Example: To search for the value of `nested` from `{"something":{"nested":1,"other":2}}` use `thepropertykey.something.nested=1`. Required, unless `accountId` or `query` is specified.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "query": {
      "type": "string",
      "description": "A query string that is matched against user attributes ( `displayName`, and `emailAddress`) to find relevant users. The string can match the prefix of the attribute's value. For example, *query=john* matches a user with a `displayName` of *John Smith* and a user with an `emailAddress` of *johnson@example.com*. Required, unless `accountId` or `property` is specified."
    },
    "username": {
      "type": "string",
      "description": "username"
    },
    "accountId": {
      "type": "string",
      "description": "A query string that is matched exactly against a user `accountId`. Required, unless `query` or `property` is specified."
    },
    "startAt": {
      "type": "integer",
      "description": "The index of the first item to return in a page of filtered results (page offset)."
    },
    "maxResults": {
      "type": "integer",
      "description": "The maximum number of items to return per page."
    },
    "property": {
      "type": "string",
      "description": "A query string used to search properties. Property keys are specified by path, so property keys containing dot (.) or equals (=) characters cannot be used. The query string cannot be specified using a JSON object. Example: To search for the value of `nested` from `{\"something\":{\"nested\":1,\"other\":2}}` use `thepropertykey.something.nested=1`. Required, unless `accountId` or `query` is specified."
    }
  },
  "required": [
    "PCID"
  ]
}

jira_users_find_users_and_groups

Find users and groups Parameters:

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	The search string.
`maxResults`	integer	No	—	The maximum number of items to return in each list.
`showAvatar`	boolean	No	—	Whether the user avatar should be returned. If an invalid value is provided, the default value is used.
`fieldId`	string	No	—	The custom field ID of the field this request is for.
`projectId`	any[]	No	—	The ID of a project that returned users and groups must have permission to view. To include multiple projects, provide an ampersand-separated list. For example, `projectId=10000&projectId=10001`. This parameter is only used when `fieldId` is present.
`issueTypeId`	any[]	No	—	The ID of an issue type that returned users and groups must have permission to view. To include multiple issue types, provide an ampersand-separated list. For example, `issueTypeId=10000&issueTypeId=10001`. Special values, such as `-1` (all standard issue types) and `-2` (all subtask issue types), are supported. This parameter is only used when `fieldId` is present.
`avatarSize`	string	No	—	The size of the avatar to return. If an invalid value is provided, the default value is used.
`caseInsensitive`	boolean	No	—	Whether the search for groups should be case insensitive.
`excludeConnectAddons`	boolean	No	—	Whether Connect app users and groups should be excluded from the search results. If an invalid value is provided, the default value is used.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "query": {
      "type": "string",
      "description": "The search string."
    },
    "maxResults": {
      "type": "integer",
      "description": "The maximum number of items to return in each list."
    },
    "showAvatar": {
      "type": "boolean",
      "description": "Whether the user avatar should be returned. If an invalid value is provided, the default value is used."
    },
    "fieldId": {
      "type": "string",
      "description": "The custom field ID of the field this request is for."
    },
    "projectId": {
      "type": "array",
      "description": "The ID of a project that returned users and groups must have permission to view. To include multiple projects, provide an ampersand-separated list. For example, `projectId=10000&projectId=10001`. This parameter is only used when `fieldId` is present."
    },
    "issueTypeId": {
      "type": "array",
      "description": "The ID of an issue type that returned users and groups must have permission to view. To include multiple issue types, provide an ampersand-separated list. For example, `issueTypeId=10000&issueTypeId=10001`. Special values, such as `-1` (all standard issue types) and `-2` (all subtask issue types), are supported. This parameter is only used when `fieldId` is present."
    },
    "avatarSize": {
      "type": "string",
      "description": "The size of the avatar to return. If an invalid value is provided, the default value is used.",
      "enum": [
        "xsmall",
        "xsmall@2x",
        "xsmall@3x",
        "small",
        "small@2x",
        "small@3x",
        "medium",
        "medium@2x",
        "medium@3x",
        "large",
        "large@2x",
        "large@3x",
        "xlarge",
        "xlarge@2x",
        "xlarge@3x",
        "xxlarge",
        "xxlarge@2x",
        "xxlarge@3x",
        "xxxlarge",
        "xxxlarge@2x",
        "xxxlarge@3x"
      ]
    },
    "caseInsensitive": {
      "type": "boolean",
      "description": "Whether the search for groups should be case insensitive."
    },
    "excludeConnectAddons": {
      "type": "boolean",
      "description": "Whether Connect app users and groups should be excluded from the search results. If an invalid value is provided, the default value is used."
    }
  },
  "required": [
    "PCID",
    "query"
  ]
}

jira_users_find_users_for_picker

Find users for picker Parameters:

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	A query string that is matched against user attributes, such as `displayName`, and `emailAddress`, to find relevant users. The string can match the prefix of the attribute’s value. For example, query=john matches a user with a `displayName` of John Smith and a user with an `emailAddress` of johnson@example.com.
`maxResults`	integer	No	—	The maximum number of items to return. The total number of matched users is returned in `total`.
`showAvatar`	boolean	No	—	Include the URI to the user’s avatar.
`exclude`	any[]	No	—	This parameter is no longer available. See the deprecation notice for details.
`excludeAccountIds`	any[]	No	—	A list of account IDs to exclude from the search results. This parameter accepts a comma-separated list. Multiple account IDs can also be provided using an ampersand-separated list. For example, `excludeAccountIds=5b10a2844c20165700ede21g,5b10a0effa615349cb016cd8&excludeAccountIds=5b10ac8d82e05b22cc7d4ef5`. Cannot be provided with `exclude`.
`avatarSize`	string	No	—	avatarSize
`excludeConnectUsers`	boolean	No	—	excludeConnectUsers

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "query": {
      "type": "string",
      "description": "A query string that is matched against user attributes, such as `displayName`, and `emailAddress`, to find relevant users. The string can match the prefix of the attribute's value. For example, *query=john* matches a user with a `displayName` of *John Smith* and a user with an `emailAddress` of *johnson@example.com*."
    },
    "maxResults": {
      "type": "integer",
      "description": "The maximum number of items to return. The total number of matched users is returned in `total`."
    },
    "showAvatar": {
      "type": "boolean",
      "description": "Include the URI to the user's avatar."
    },
    "exclude": {
      "type": "array",
      "description": "This parameter is no longer available. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details."
    },
    "excludeAccountIds": {
      "type": "array",
      "description": "A list of account IDs to exclude from the search results. This parameter accepts a comma-separated list. Multiple account IDs can also be provided using an ampersand-separated list. For example, `excludeAccountIds=5b10a2844c20165700ede21g,5b10a0effa615349cb016cd8&excludeAccountIds=5b10ac8d82e05b22cc7d4ef5`. Cannot be provided with `exclude`."
    },
    "avatarSize": {
      "type": "string",
      "description": "avatarSize"
    },
    "excludeConnectUsers": {
      "type": "boolean",
      "description": "excludeConnectUsers"
    }
  },
  "required": [
    "PCID",
    "query"
  ]
}

jira_users_get_bulk_permissions

Get bulk permissions Parameters:

Parameter	Type	Required	Default	Description
`accountId`	string	No	—	The account ID of a user.
`globalPermissions`	any[]	No	—	Global permissions to look up.
`projectPermissions`	any[]	No	—	Project permissions with associated projects and issues to look up.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "accountId": {
      "type": "string",
      "description": "The account ID of a user."
    },
    "globalPermissions": {
      "type": "array",
      "description": "Global permissions to look up."
    },
    "projectPermissions": {
      "type": "array",
      "description": "Project permissions with associated projects and issues to look up."
    }
  },
  "required": [
    "PCID"
  ]
}

jira_users_get_current_user

Get current user Parameters:

Parameter	Type	Required	Default	Description
`expand`	string	No	—	Use expand to include additional information about user in the response. This parameter accepts a comma-separated list. Expand options include: * `groups` Returns all groups, including nested groups, the user belongs to. * `applicationRoles` Returns the application roles the user is assigned to.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "expand": {
      "type": "string",
      "description": "Use [expand](#expansion) to include additional information about user in the response. This parameter accepts a comma-separated list. Expand options include:   *  `groups` Returns all groups, including nested groups, the user belongs to.  *  `applicationRoles` Returns the application roles the user is assigned to."
    }
  },
  "required": [
    "PCID"
  ]
}

jira_users_get_my_permissions

Get my permissions Parameters:

Parameter	Type	Required	Default	Description
`projectKey`	string	No	—	The key of project. Ignored if `projectId` is provided.
`projectId`	string	No	—	The ID of project.
`issueKey`	string	No	—	The key of the issue. Ignored if `issueId` is provided.
`issueId`	string	No	—	The ID of the issue.
`permissions`	string	No	—	A list of permission keys. (Required) This parameter accepts a comma-separated list. To get the list of available permissions, use Get all permissions.
`projectUuid`	string	No	—	projectUuid
`projectConfigurationUuid`	string	No	—	projectConfigurationUuid
`commentId`	string	No	—	The ID of the comment.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "projectKey": {
      "type": "string",
      "description": "The key of project. Ignored if `projectId` is provided."
    },
    "projectId": {
      "type": "string",
      "description": "The ID of project."
    },
    "issueKey": {
      "type": "string",
      "description": "The key of the issue. Ignored if `issueId` is provided."
    },
    "issueId": {
      "type": "string",
      "description": "The ID of the issue."
    },
    "permissions": {
      "type": "string",
      "description": "A list of permission keys. (Required) This parameter accepts a comma-separated list. To get the list of available permissions, use [Get all permissions](#api-rest-api-3-permissions-get)."
    },
    "projectUuid": {
      "type": "string",
      "description": "projectUuid"
    },
    "projectConfigurationUuid": {
      "type": "string",
      "description": "projectConfigurationUuid"
    },
    "commentId": {
      "type": "string",
      "description": "The ID of the comment."
    }
  },
  "required": [
    "PCID"
  ]
}

jira_users_get_user

Get user Parameters:

Parameter	Type	Required	Default	Description
`accountId`	string	No	—	The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5. Required.
`username`	string	No	—	This parameter is no longer available. See the deprecation notice for details.
`key`	string	No	—	This parameter is no longer available. See the deprecation notice for details.
`expand`	string	No	—	Use expand to include additional information about users in the response. This parameter accepts a comma-separated list. Expand options include: * `groups` includes all groups and nested groups to which the user belongs. * `applicationRoles` includes details of all the applications to which the user has access.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "accountId": {
      "type": "string",
      "description": "The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, *5b10ac8d82e05b22cc7d4ef5*. Required."
    },
    "username": {
      "type": "string",
      "description": "This parameter is no longer available. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide) for details."
    },
    "key": {
      "type": "string",
      "description": "This parameter is no longer available. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide) for details."
    },
    "expand": {
      "type": "string",
      "description": "Use [expand](#expansion) to include additional information about users in the response. This parameter accepts a comma-separated list. Expand options include:   *  `groups` includes all groups and nested groups to which the user belongs.  *  `applicationRoles` includes details of all the applications to which the user has access."
    }
  },
  "required": [
    "PCID"
  ]
}

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

Tools

jira_users_find_assignable_users

jira_users_find_users

jira_users_find_users_and_groups

jira_users_find_users_for_picker

jira_users_get_bulk_permissions

jira_users_get_current_user

jira_users_get_my_permissions

jira_users_get_user

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

​Tools

​jira_users_find_assignable_users

​jira_users_find_users

​jira_users_find_users_and_groups

​jira_users_find_users_for_picker

​jira_users_get_bulk_permissions

​jira_users_get_current_user

​jira_users_get_my_permissions

​jira_users_get_user

Tools

jira_users_find_assignable_users

jira_users_find_users

jira_users_find_users_and_groups

jira_users_find_users_for_picker

jira_users_get_bulk_permissions

jira_users_get_current_user

jira_users_get_my_permissions

jira_users_get_user