--- name: pp-jira description: "Printing Press CLI for Jira Cloud Platform. Jira Cloud Platform REST API documentation" author: "Nikica Jokic" license: "Apache-2.0" argument-hint: " [args] | install cli|mcp" allowed-tools: "Read Bash" metadata: openclaw: requires: bins: - jira-pp-cli --- # Jira Cloud Platform — Printing Press CLI ## Prerequisites: Install the CLI This skill drives the `jira-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first: 1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows: ```bash npx -y @mvanhorn/printing-press-library install jira --cli-only ``` 2. Verify: `jira-pp-cli --version` 3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill. If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer): ```bash go install github.com/mvanhorn/printing-press-library/library/project-management/jira/cmd/jira-pp-cli@latest ``` If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds. ## Command Reference **announcement-banner** — This resource represents an announcement banner. Use it to retrieve and update banner configuration. - `jira-pp-cli announcement-banner get-banner` — Returns the current announcement banner configuration. **[Permissions](#permissions) required:** *Administer Jira*... - `jira-pp-cli announcement-banner set-banner` — Updates the announcement banner configuration. **[Permissions](#permissions) required:** *Administer Jira* [global... **app** — Manage app - `jira-pp-cli app get-custom-field-configuration` — Returns a [paginated](#pagination) list of configurations for a custom field of a... - `jira-pp-cli app get-custom-fields-configurations` — Returns a [paginated](#pagination) list of configurations for list of custom fields of a... - `jira-pp-cli app update-custom-field-configuration` — Update the configuration for contexts of a custom field of a [type](https://developer.atlassian.com/platform/forge/ma... - `jira-pp-cli app update-custom-field-value` — Updates the value of a custom field on one or more issues. Apps can only perform this operation on [custom... - `jira-pp-cli app update-multiple-custom-field-values` — Updates the value of one or more custom fields on one or more issues. Combinations of custom field and issue should... **application-properties** — Manage application properties - `jira-pp-cli application-properties get-advanced-settings` — Returns the application properties that are accessible on the *Advanced Settings* page. To navigate to the *Advanced... - `jira-pp-cli application-properties get-application-property` — Returns all application properties or an application property. If you specify a value for the `key` parameter, then... - `jira-pp-cli application-properties set-application-property` — Changes the value of an application property. For example, you can change the value of the `jira.clone.prefix` from... **applicationrole** — Manage applicationrole - `jira-pp-cli applicationrole get-all-application-roles` — Returns all application roles. In Jira, application roles are managed using the [Application access... - `jira-pp-cli applicationrole get-application-role` — Returns an application role. **[Permissions](#permissions) required:** *Administer Jira* [global... **atlassian-connect** — Manage atlassian connect - `jira-pp-cli atlassian-connect addon-properties-resource-delete-addon-property-delete` — Deletes an app's property. **[Permissions](#permissions) required:** Only a Connect app whose key matches `addonKey`... - `jira-pp-cli atlassian-connect addon-properties-resource-get-addon-properties-get` — Gets all the properties of an app. The reserved key `connect_client_key_019cdff3-8bfb-71fe-9628-875b700aebb8` is not... - `jira-pp-cli atlassian-connect addon-properties-resource-get-addon-property-get` — Returns the key and value of an app's property. The property key... - `jira-pp-cli atlassian-connect addon-properties-resource-put-addon-property-put` — Sets the value of an app's property. Use this resource to store custom data for your app. The value of the request... - `jira-pp-cli atlassian-connect app-issue-field-value-update-resource-update-issue-fields-put` — Updates the value of a custom field added by Connect apps on one or more issues. The values of up to 200 custom... - `jira-pp-cli atlassian-connect connect-to-forge-migration-fetch-task-resource-fetch-migration-task-get` — Returns the details of a Connect issue field's migration to Forge. When migrating a Connect app to Forge, [Issue... - `jira-pp-cli atlassian-connect connect-to-forge-migration-task-submission-resource-submit-task-post` — Submits a request to trigger migration of connect issue field to its Forge custom field counterpart. When migrating... - `jira-pp-cli atlassian-connect dynamic-modules-resource-get-modules-get` — Returns all modules registered dynamically by the calling app. **[Permissions](#permissions) required:** Only... - `jira-pp-cli atlassian-connect dynamic-modules-resource-register-modules-post` — Registers a list of modules. **[Permissions](#permissions) required:** Only Connect apps can make this request. - `jira-pp-cli atlassian-connect dynamic-modules-resource-remove-modules-delete` — Remove all or a list of modules registered by the calling app. **[Permissions](#permissions) required:** Only... - `jira-pp-cli atlassian-connect migration-resource-update-entity-properties-value-put` — Updates the values of multiple entity properties for an object, up to 50 updates per request. This operation is for... - `jira-pp-cli atlassian-connect migration-resource-workflow-rule-search-post` — Returns configurations for workflow transition rules migrated from server to cloud and owned by the calling Connect app. - `jira-pp-cli atlassian-connect service-registry-resource-services-get` — Retrieve the attributes of given service registries. **[Permissions](#permissions) required:** Only Connect apps can... **attachment** — Manage attachment - `jira-pp-cli attachment get` — Returns the metadata for an attachment. Note that the attachment itself is not returned. This operation can be... - `jira-pp-cli attachment get-content` — Returns the contents of an attachment. A `Range` header can be set to define a range of bytes within the attachment... - `jira-pp-cli attachment get-meta` — Returns the attachment settings, that is, whether attachments are enabled and the maximum attachment size allowed.... - `jira-pp-cli attachment get-thumbnail` — Returns the thumbnail of an attachment. To return the attachment contents, use [Get attachment... - `jira-pp-cli attachment remove` — Deletes an attachment from an issue. This operation can be accessed anonymously. **[Permissions](#permissions)... **auditing** — Manage auditing - `jira-pp-cli auditing` — Returns a list of audit records. The list can be filtered to include items: * where each item in `filter` has at... **avatar** — This resource represents system and custom avatars. Use it to obtain the details of system or custom avatars, add and remove avatars from a project, issue type or priority and obtain avatar images. **bulk** — Manage bulk - `jira-pp-cli bulk get-available-transitions` — Use this API to retrieve a list of transitions available for the specified issues that can be used or bulk... - `jira-pp-cli bulk get-editable-fields` — Use this API to get a list of fields visible to the user to perform bulk edit operations. You can pass single or... - `jira-pp-cli bulk get-operation-progress` — Use this to get the progress state for the specified bulk operation `taskId`. **[Permissions](#permissions)... - `jira-pp-cli bulk submit-delete` — Use this API to submit a bulk delete request. You can delete up to 1,000 issues in a single operation.... - `jira-pp-cli bulk submit-edit` — Use this API to submit a bulk edit request and simultaneously edit multiple issues. There are limits applied to the... - `jira-pp-cli bulk submit-move` — Use this API to submit a bulk issue move request. You can move multiple issues from multiple projects in a single... - `jira-pp-cli bulk submit-transition` — Use this API to submit a bulk issue status transition request. You can transition multiple issues, alongside with... - `jira-pp-cli bulk submit-unwatch` — Use this API to submit a bulk unwatch request. You can unwatch up to 1,000 issues in a single operation.... - `jira-pp-cli bulk submit-watch` — Use this API to submit a bulk watch request. You can watch up to 1,000 issues in a single operation.... **changelog** — Manage changelog - `jira-pp-cli changelog` — Bulk fetch changelogs for multiple issues and filter by fields Returns a paginated list of all changelogs for given... **classification-levels** — This resource represents classification levels. - `jira-pp-cli classification-levels` — Returns all classification levels. **[Permissions](#permissions) required:** None. **comment** — Manage comment - `jira-pp-cli comment` — Returns a [paginated](#pagination) list of comments specified by a list of comment IDs. This operation can be... **component** — Manage component - `jira-pp-cli component create` — Creates a component. Use components to provide containers for issues within a project. Use components to provide... - `jira-pp-cli component delete` — Deletes a component. This operation can be accessed anonymously. **[Permissions](#permissions) required:**... - `jira-pp-cli component find-for-projects` — Returns a [paginated](#pagination) list of all components in a project, including global (Compass) components when... - `jira-pp-cli component get` — Returns a component. This operation can be accessed anonymously. **[Permissions](#permissions) required:** *Browse... - `jira-pp-cli component update` — Updates a component. Any fields included in the request are overwritten. If `leadAccountId` is an empty string ('')... **config** — Manage config - `jira-pp-cli config associate-projects-to-field-association-schemes` — Associate projects to field association schemes. **[Permissions](#permissions) required:** *Administer Jira* [global... - `jira-pp-cli config clone-field-association-scheme` — Endpoint for cloning an existing field association scheme into a new one. **[Permissions](#permissions) required:**... - `jira-pp-cli config create-field-association-scheme` — Endpoint for creating a new field association scheme. **[Permissions](#permissions) required:** *Administer Jira*... - `jira-pp-cli config delete-field-association-scheme` — Delete a specified field association scheme **[Permissions](#permissions) required:** *Administer Jira* [global... - `jira-pp-cli config get-field-association-scheme-by-id` — Endpoint for fetching a field association scheme by its ID **[Permissions](#permissions) required:** *Administer... - `jira-pp-cli config get-field-association-scheme-item-parameters` — Retrieve field association parameters on a field association scheme **[Permissions](#permissions) required:**... - `jira-pp-cli config get-field-association-schemes` — REST endpoint for retrieving a paginated list of field association schemes with optional filtering. This endpoint... - `jira-pp-cli config get-projects-with-field-schemes` — Get projects with field association schemes. This will be a temporary API but useful when transitioning from the... - `jira-pp-cli config remove-field-association-scheme-item-parameters` — Remove field association parameters overrides for work types. **[Permissions](#permissions) required:** *Administer... - `jira-pp-cli config remove-fields-associated-with-schemes` — Remove fields associated with field association schemes. **[Permissions](#permissions) required:** *Administer Jira*... - `jira-pp-cli config search-field-association-scheme-fields` — Search for fields belonging to a given field association scheme. **[Permissions](#permissions) required:**... - `jira-pp-cli config search-field-association-scheme-projects` — REST Endpoint for searching for projects belonging to a given field association scheme **[Permissions](#permissions)... - `jira-pp-cli config update-field-association-scheme` — Endpoint for updating an existing field association scheme. **[Permissions](#permissions) required:** *Administer... - `jira-pp-cli config update-field-association-scheme-item-parameters` — Update field association item parameters in field association schemes. **[Permissions](#permissions) required:**... - `jira-pp-cli config update-fields-associated-with-schemes` — Update fields associated with field association schemes. **[Permissions](#permissions) required:** *Administer Jira*... **configuration** — Manage configuration - `jira-pp-cli configuration get` — Returns the [global settings](https://confluence.atlassian.com/x/qYXKM) in Jira. These settings determine whether... - `jira-pp-cli configuration get-available-time-tracking-implementations` — Returns all time tracking providers. By default, Jira only has one time tracking provider: *JIRA provided time... - `jira-pp-cli configuration get-selected-time-tracking-implementation` — Returns the time tracking provider that is currently selected. Note that if time tracking is disabled, then a... - `jira-pp-cli configuration get-shared-time-tracking` — Returns the time tracking settings. This includes settings such as the time format, default time unit, and others.... - `jira-pp-cli configuration select-time-tracking-implementation` — Selects a time tracking provider. **[Permissions](#permissions) required:** *Administer Jira* [global... - `jira-pp-cli configuration set-shared-time-tracking` — Sets the time tracking settings. **[Permissions](#permissions) required:** *Administer Jira* [global... **custom-field-option** — Manage custom field option - `jira-pp-cli custom-field-option ` — Returns a custom field option. For example, an option in a select list. Note that this operation **only works for... **dashboard** — This resource represents dashboards. Use it to obtain the details of dashboards as well as get, create, update, or remove item properties and gadgets from dashboards. - `jira-pp-cli dashboard bulk-edit` — Bulk edit dashboards. Maximum number of dashboards to be edited at the same time is 100.... - `jira-pp-cli dashboard create` — Creates a dashboard. **[Permissions](#permissions) required:** None. - `jira-pp-cli dashboard delete` — Deletes a dashboard. **[Permissions](#permissions) required:** None The dashboard to be deleted must be owned by the... - `jira-pp-cli dashboard get` — Returns a dashboard. This operation can be accessed anonymously. **[Permissions](#permissions) required:** None.... - `jira-pp-cli dashboard get-all` — Returns a list of dashboards owned by or shared with the user. The list may be filtered to include only favorite or... - `jira-pp-cli dashboard get-all-available-gadgets` — Gets a list of all available gadgets that can be added to all dashboards. **[Permissions](#permissions) required:**... - `jira-pp-cli dashboard get-paginated` — Returns a [paginated](#pagination) list of dashboards. This operation is similar to [Get... - `jira-pp-cli dashboard update` — Updates a dashboard, replacing all the dashboard details with those provided. **[Permissions](#permissions)... **data-policy** — Manage data policy - `jira-pp-cli data-policy get-policies` — Returns data policies for the projects specified in the request. - `jira-pp-cli data-policy get-policy` — Returns data policy for the workspace. **events** — Manage events - `jira-pp-cli events` — Returns all issue events. **[Permissions](#permissions) required:** *Administer Jira* [global... **expression** — Manage expression - `jira-pp-cli expression analyse` — Analyses and validates Jira expressions. As an experimental feature, this operation can also attempt to type-check... - `jira-pp-cli expression evaluate-jira` — Endpoint is currently being removed. [More details](https://developer.atlassian.com/changelog/#CHANGE-2046)... - `jira-pp-cli expression evaluate-jsisjira` — Evaluates a Jira expression and returns its value. The difference between this and `eval` is that this endpoint uses... **field** — Manage field - `jira-pp-cli field create-associations` — Associates fields with projects. Fields will be associated with each issue type on the requested projects. Fields... - `jira-pp-cli field create-custom` — Creates a custom field. **[Permissions](#permissions) required:** *Administer Jira* [global... - `jira-pp-cli field delete-custom` — Deletes a custom field. The custom field is deleted whether it is in the trash or not. See [Edit or delete a custom... - `jira-pp-cli field get` — Returns system and custom issue fields according to the following rules: * Fields that cannot be added to the issue... - `jira-pp-cli field get-paginated` — Returns a [paginated](#pagination) list of fields for Classic Jira projects. The list can include: * all fields *... - `jira-pp-cli field get-trashed-paginated` — Returns a [paginated](#pagination) list of fields in the trash. The list may be restricted to fields whose field... - `jira-pp-cli field remove-associations` — Unassociates a set of fields with a project and issue type context. Fields will be unassociated with all... - `jira-pp-cli field update-custom` — Updates a custom field. **[Permissions](#permissions) required:** *Administer Jira* [global... **fieldconfiguration** — Manage fieldconfiguration - `jira-pp-cli fieldconfiguration create-field-configuration` — Deprecated, use [ Field schemes](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-field-schemes/... - `jira-pp-cli fieldconfiguration delete-field-configuration` — Deprecated, use [ Field schemes](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-field-schemes/... - `jira-pp-cli fieldconfiguration get-all-field-configurations` — Deprecated, use [ Field schemes](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-field-schemes/... - `jira-pp-cli fieldconfiguration update-field-configuration` — Deprecated, use [ Field schemes](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-field-schemes/... **fieldconfigurationscheme** — Manage fieldconfigurationscheme - `jira-pp-cli fieldconfigurationscheme assign-field-configuration-scheme-to-project` — Deprecated, use [ Field schemes](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-field-schemes/... - `jira-pp-cli fieldconfigurationscheme create-field-configuration-scheme` — Deprecated, use [ Field schemes](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-field-schemes/... - `jira-pp-cli fieldconfigurationscheme delete-field-configuration-scheme` — Deprecated, use [ Field schemes](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-field-schemes/... - `jira-pp-cli fieldconfigurationscheme get-all-field-configuration-schemes` — Deprecated, use [ Field schemes](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-field-schemes/... - `jira-pp-cli fieldconfigurationscheme get-field-configuration-scheme-mappings` — Deprecated, use [ Field schemes](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-field-schemes/... - `jira-pp-cli fieldconfiguration