Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • type - defines share type. Possible values: “ISSUE”, “BOARD”, “JQL”.

  • issueId - required for ISSUE type shares.

  • projectId - required for BOARD and JQL type shares.

  • board - can be used to specify a specific board in the project.

You may also pass additional fields:

Parameter Name

Description

Default

password

Sets password for share.

null

expiration

Expiration timestamp in epoch miliseconds.

null

showComments

All existing comments will be visible on the shared link.

true

allowAddComment

Anyone with access to the link can add comments.

false

showInternalComments

Anyone with access to the link can view internal comments.

false

allowAddInternalComment

Anyone with access to the link can addinternal comments.

false

showAttachments

All existing attachments will be visible on the shared link.

true

allowAddAttachment

Anyone with access to the link can add attachments.

false

allowAddPublicAttachment

Anyone with access to the link can create a public comment with an attachment.

false

showSubtasks

Information about subtasks will be visible on the link.

true

showLinkedIssues

Information about linked issues will be visible on the link.

true

shareSubtasksContent

Information about subtasks will be visible on the link as per share settings.

false

shareLinkedIssuesContent

Information about linked issues will be visible on the link as per share settings.

false

allowWorkflowTransition

Anyone with access to the link can change its status.

false

showWorklog

Anyone with access to the link can see the worklog.

false

showChangelog

Anyone with access to the link can see history items from the changelog.

false

customFields

An array of objects with Custom Field ids that will be available on the link. Example: [{"id":"10020"}, {"id":"10021"}] Refer to the Jira API documentation to retrieve Custom Fields ids: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-fields/

null

allowExternalUsers

Set to true to allow link to be opened only by a selection of users. Users should be defined in ‘external users' parameter.

false

allowExternalUsersNotification

Set to true to send an e-mail notification to all users defined in the ‘externalUsers’ parameter. Requires ‘allowExternalUsers’ and ‘externalUsers’ parameters to be set.

false

externalUsers

E-mails of external users allowed to view the link’s content. Example: [“xyz@xyz.com, “zyx@zyx@com]. ‘allowExternalUsers’ have to be set to true or this parameter will be ignored.

null

expirationExpression

object with unit and amountfields. #Expiration Expression

null

jql

generated: "project = {projectKey} order by created DESC"

generated

board

Code Block
"board": {
    "id": "boardId"

null

Expiration Expression

Expiration Expression field

 

 

unit

NANOS

1,000,000,000th part of the second unit

 

MICROS

1,000,000th part of the second unit

 

MILLIS

1000th part of the second unit

 

SECONDS

it is equal to the second in the SI system of units

 

MINUTES

it is equal to 60 seconds

 

HOURS

it is equal to 60 minutes

 

HALF_DAYS

it is equal to 12 hours

 

DAYS

it is equal to 24 Hours

 

WEEKS

it is equal to 7 days

 

MONTHS

estimated duration of a month is one twelfth of 365.2425 Days

 

YEARS

estimated duration of a year is 365.2425 Day

 

DECADES

it is equal to 10 years

 

CENTURIES

it is equal to 100 years

 

MILLENNIA

it is equal to 1000 years

amount

whole number

 

...