JIRA 7.6.1
  1. Projects
JIRA 7.6.1
  • Announcement banner
    • Get announcement banner configuration
      GET
    • Update announcement banner configuration
      PUT
  • Issue custom field values (apps)
    • Update custom fields
      POST
    • Update custom field value
      PUT
  • Issue custom field configuration (apps)
    • Get custom field configurations
      GET
    • Update custom field configurations
      PUT
  • Jira settings
    • Get application property
      GET
    • Get advanced settings
      GET
    • Set application property
      PUT
    • Get global settings
      GET
  • Application roles
    • Get all application roles
      GET
    • Get application role
      GET
  • Issue attachments
    • Get attachment content
    • Get Jira attachment settings
    • Get attachment thumbnail
    • Get attachment metadata
    • Delete attachment
    • Get all metadata for an expanded attachment
    • Get contents metadata for an expanded attachment
    • Add attachment
  • Audit records
    • Get audit records
  • Avatars
    • Get system avatars by type
    • Get avatars
    • Load avatar
    • Delete avatar
    • Get avatar image by type
    • Get avatar image by ID
    • Get avatar image by owner
  • Issue comments
    • Get comments by IDs
    • Get comments
    • Add comment
    • Get comment
    • Update comment
    • Delete comment
  • Issue comment properties
    • Get comment property keys
    • Get comment property
    • Set comment property
    • Delete comment property
  • Project components
    • Create component
    • Get component
    • Update component
    • Delete component
    • Get component issues count
    • Get project components paginated
    • Get project components
  • Time tracking
    • Get selected time tracking provider
    • Select time tracking provider
    • Get all time tracking providers
    • Get time tracking settings
    • Set time tracking settings
  • Issue custom field options
    • Get custom field option
    • Get custom field options (context)
    • Update custom field options (context)
    • Create custom field options (context)
    • Reorder custom field options (context)
    • Delete custom field options (context)
  • Dashboards
    • Get all dashboards
    • Create dashboard
    • Get available gadgets
    • Search for dashboards
    • Get gadgets
    • Add gadget to dashboard
    • Update gadget on dashboard
    • Remove gadget from dashboard
    • Get dashboard item property keys
    • Get dashboard item property
    • Set dashboard item property
    • Delete dashboard item property
    • Get dashboard
    • Update dashboard
    • Delete dashboard
    • Copy dashboard
  • Issues
    • Get events
    • Create issue
    • Bulk create issue
    • Get create issue metadata
    • Get issue
    • Edit issue
    • Delete issue
    • Assign issue
    • Get changelogs
    • Get changelogs by IDs
    • Get edit issue metadata
    • Send notification for issue
    • Get transitions
    • Transition issue
  • Jira expressions
    • Analyse Jira expression
    • Evaluate Jira expression
  • Issue fields
    • Get fields
    • Create custom field
    • Get fields paginated
    • Get fields in trash paginated
    • Update custom field
    • Get contexts for a field
    • Delete custom field
    • Restore custom field from trash
    • Move custom field to trash
  • Issue custom field contexts
    • Get custom field contexts
    • Create custom field context
    • Get custom field contexts default values
    • Set custom field contexts default values
    • Get issue types for custom field context
    • Get custom field contexts for projects and issue types
    • Get project mappings for custom field context
    • Update custom field context
    • Delete custom field context
    • Add issue types to context
    • Remove issue types from context
    • Assign custom field context to projects
    • Remove custom field context from projects
  • Screens
    • Get screens for a field
    • Get screens
    • Create screen
    • Add field to default screen
    • Update screen
    • Delete screen
    • Get available screen fields
  • Issue custom field options (apps)
    • Get all issue field options
    • Create issue field option
    • Get selectable issue field options
    • Get visible issue field options
    • Get issue field option
    • Update issue field option
    • Delete issue field option
    • Replace issue field option
  • Issue field configurations
    • Get all field configurations
    • Create field configuration
    • Update field configuration
    • Delete field configuration
    • Get field configuration items
    • Update field configuration items
    • Get all field configuration schemes
    • Create field configuration scheme
    • Get field configuration issue type items
    • Get field configuration schemes for projects
    • Assign field configuration scheme to project
    • Update field configuration scheme
    • Delete field configuration scheme
    • Assign issue types to field configurations
    • Remove issue types from field configuration scheme
  • Filters
    • Create filter
    • Get favorite filters
    • Get my filters
    • Search for filters
    • Get filter
    • Update filter
    • Delete filter
    • Get columns
    • Set columns
    • Reset columns
    • Add filter as favorite
    • Remove filter as favorite
    • Change filter owner
  • Filter sharing
    • Get default share scope
    • Set default share scope
    • Get share permissions
    • Add share permission
    • Get share permission
    • Delete share permission
  • Groups
    • Get group
    • Create group
    • Remove group
    • Bulk get groups
    • Get users from group
    • Add user to group
    • Remove user from group
    • Find groups
  • Group and user picker
    • Find users and groups
  • License metrics
    • Get license
    • Get approximate license count
    • Get approximate application license count
  • Issue search
    • Get issue picker suggestions
    • Check issues against JQL
    • Search for issues using JQL (GET)
    • Search for issues using JQL (POST)
  • Issue properties
    • Bulk set issues properties by list
    • Bulk set issue properties by issue
    • Bulk set issue property
    • Bulk delete issue property
    • Get issue property keys
    • Get issue property
    • Set issue property
    • Delete issue property
  • Issue watchers
    • Get is watching issue bulk
    • Get issue watchers
    • Add watcher
    • Delete watcher
  • Issue remote links
    • Get remote issue links
    • Create or update remote issue link
    • Delete remote issue link by global ID
    • Get remote issue link by ID
    • Update remote issue link by ID
    • Delete remote issue link by ID
  • Issue votes
    • Get votes
    • Add vote
    • Delete vote
  • Issue worklogs
    • Get issue worklogs
    • Add worklog
    • Get worklog
    • Update worklog
    • Delete worklog
    • Get IDs of deleted worklogs
    • Get worklogs
    • Get IDs of updated worklogs
  • Issue worklog properties
    • Get worklog property keys
    • Get worklog property
    • Set worklog property
    • Delete worklog property
  • Issue links
    • Create issue link
    • Get issue link
    • Delete issue link
  • Issue link types
    • Get issue link types
    • Create issue link type
    • Get issue link type
    • Update issue link type
    • Delete issue link type
  • Issue security schemes
    • Get issue security schemes
    • Create issue security scheme
    • Get issue security levels
    • Set default issue security levels
    • Get issue security level members
    • Get projects using issue security schemes
    • Associate security scheme to project
    • Search issue security schemes
    • Get issue security scheme
    • Update issue security scheme
    • Delete issue security scheme
    • Add issue security levels
    • Update issue security level
    • Remove issue security level
    • Add issue security level members
    • Remove member from issue security level
  • Issue security level
    • Get issue security level members
    • Get issue security level
  • Issue types
    • Get all issue types for user
    • Create issue type
    • Get issue types for project
    • Get issue type
    • Update issue type
    • Delete issue type
    • Get alternative issue types
    • Load issue type avatar
  • Issue type properties
    • Get issue type property keys
    • Get issue type property
    • Set issue type property
    • Delete issue type property
  • Issue type schemes
    • Get all issue type schemes
    • Create issue type scheme
    • Get issue type scheme items
    • Get issue type schemes for projects
    • Assign issue type scheme to project
    • Update issue type scheme
    • Delete issue type scheme
    • Add issue types to issue type scheme
    • Change order of issue types
    • Remove issue type from issue type scheme
  • Issue type screen schemes
    • Get issue type screen schemes
    • Create issue type screen scheme
    • Get issue type screen scheme items
    • Get issue type screen schemes for projects
    • Assign issue type screen scheme to project
    • Update issue type screen scheme
    • Delete issue type screen scheme
    • Append mappings to issue type screen scheme
    • Update issue type screen scheme default screen scheme
    • Remove mappings from issue type screen scheme
    • Get issue type screen scheme projects
  • JQL
    • Get field reference data (GET)
    • Get field reference data (POST)
    • Get field auto complete suggestions
    • Parse JQL query
    • Convert user identifiers to account IDs in JQL queries
    • Sanitize JQL queries
  • JQL functions (apps)
    • Get precomputations (apps)
    • Update precomputations (apps)
  • Labels
    • Get all labels
  • Permissions
    • Get my permissions
    • Get all permissions
    • Get bulk permissions
    • Get permitted projects
  • Myself
    • Get preference
    • Set preference
    • Delete preference
    • Get locale
    • Set locale
    • Delete locale
    • Get current user
  • Issue notification schemes
    • Get notification schemes paginated
    • Create notification scheme
    • Get projects using notification schemes paginated
    • Get notification scheme
    • Update notification scheme
    • Add notifications to notification scheme
    • Delete notification scheme
    • Remove notification from notification scheme
  • Permission schemes
    • Get all permission schemes
    • Create permission scheme
    • Get permission scheme
    • Update permission scheme
    • Delete permission scheme
    • Get permission scheme grants
    • Create permission grant
    • Get permission scheme grant
    • Delete permission scheme grant
  • Issue priorities
    • Get priorities
    • Create priority
    • Set default priority
    • Move priorities
    • Search priorities
    • Get priority
    • Update priority
    • Delete priority
  • Projects
    • Get all projects
      GET
    • Create project
      POST
    • Get recent projects
      GET
    • Get projects paginated
      GET
    • Get project
      GET
    • Update project
      PUT
    • Delete project
      DELETE
    • Archive project
      POST
    • Delete project asynchronously
      POST
    • Restore deleted or archived project
      POST
    • Get all statuses for project
      GET
    • Get project issue type hierarchy
      GET
    • Get project notification scheme
      GET
  • Project types
    • Get all project types
    • Get licensed project types
    • Get project type by key
    • Get accessible project type by key
  • Project avatars
    • Set project avatar
    • Delete project avatar
    • Load project avatar
    • Get all project avatars
  • Project features
    • Get project features
    • Set project feature state
  • Project properties
    • Get project property keys
    • Get project property
    • Set project property
    • Delete project property
  • Project roles
    • Get project roles for project
    • Get project role for project
    • Get project role details
    • Get all project roles
    • Create project role
    • Get project role by ID
    • Fully update project role
    • Partial update project role
    • Delete project role
  • Project role actors
    • Set actors for project role
    • Add actors to project role
    • Delete actors from project role
    • Get default actors for project role
    • Add default actors to project role
    • Delete default actors from project role
  • Project versions
    • Get project versions paginated
    • Get project versions
    • Create version
    • Get version
    • Update version
    • Delete version
    • Merge versions
    • Move version
    • Get version's related issues count
    • Delete and replace version
    • Get version's unresolved issues count
  • Project email
    • Get project's sender email
    • Set project's sender email
  • Project permission schemes
    • Get project issue security scheme
    • Get assigned permission scheme
    • Assign permission scheme
    • Get project issue security levels
  • Project categories
    • Get all project categories
    • Create project category
    • Get project category by ID
    • Update project category
    • Delete project category
  • Project key and name validation
    • Validate project key
    • Get valid project key
    • Get valid project name
  • Issue resolutions
    • Get resolutions
    • Create resolution
    • Set default resolution
    • Move resolutions
    • Search resolutions
    • Get resolution
    • Update resolution
    • Delete resolution
  • Screen tabs
    • Get all screen tabs
    • Create screen tab
    • Update screen tab
    • Delete screen tab
    • Move screen tab
  • Screen tab fields
    • Get all screen tab fields
    • Add screen tab field
    • Remove screen tab field
    • Move screen tab field
  • Screen schemes
    • Get screen schemes
    • Create screen scheme
    • Update screen scheme
    • Delete screen scheme
  • Server info
    • Get Jira instance info
  • Issue navigator settings
    • Get issue navigator default columns
    • Set issue navigator default columns
  • Workflow statuses
    • Get all statuses
    • Get status
  • Workflow status categories
    • Get all status categories
    • Get status category
  • Status
    • Bulk get statuses
    • Bulk update statuses
    • Bulk create statuses
    • Bulk delete Statuses
    • Search statuses paginated
  • Tasks
    • Get task
    • Cancel task
  • UI modifications (apps)
    • Get UI modifications
    • Create UI modification
    • Update UI modification
    • Delete UI modification
  • Users
    • Get user
    • Create user
    • Delete user
    • Bulk get users
    • Get account IDs for users
    • Get user default columns
    • Set user default columns
    • Reset user default columns
    • Get user email
    • Get user email bulk
    • Get user groups
    • Get all users default
    • Get all users
  • User search
    • Find users assignable to projects
    • Find users assignable to issues
    • Find users with permissions
    • Find users for picker
    • Find users
    • Find users by query
    • Find user keys by query
    • Find users with browse permission
  • User properties
    • Get user property keys
    • Get user property
    • Set user property
    • Delete user property
  • Webhooks
    • Get dynamic webhooks for app
    • Register dynamic webhooks
    • Delete webhooks by ID
    • Get failed webhooks
    • Extend webhook life
  • Workflows
    • Get all workflows
    • Create workflow
    • Get workflows paginated
    • Delete inactive workflow
    • Bulk get workflows
    • Get available workflow capabilities
    • Bulk create workflows
    • Validate create workflows
    • Bulk update workflows
    • Validate update workflows
  • Workflow transition rules
    • Get workflow transition rule configurations
    • Update workflow transition rule configurations
    • Delete workflow transition rule configurations
  • Workflow transition properties
    • Get workflow transition properties
    • Update workflow transition property
    • Create workflow transition property
    • Delete workflow transition property
  • Workflow schemes
    • Get all workflow schemes
    • Create workflow scheme
    • Get workflow scheme
    • Update workflow scheme
    • Delete workflow scheme
    • Get default workflow
    • Update default workflow
    • Delete default workflow
    • Get workflow for issue type in workflow scheme
    • Set workflow for issue type in workflow scheme
    • Delete workflow for issue type in workflow scheme
    • Get issue types for workflows in workflow scheme
    • Set issue types for workflow in workflow scheme
    • Delete issue types for workflow in workflow scheme
  • Workflow scheme project associations
    • Get workflow scheme project associations
    • Assign workflow scheme to project
  • Workflow scheme drafts
    • Create draft workflow scheme
    • Get draft workflow scheme
    • Update draft workflow scheme
    • Delete draft workflow scheme
    • Get draft default workflow
    • Update draft default workflow
    • Delete draft default workflow
    • Get workflow for issue type in draft workflow scheme
    • Set workflow for issue type in draft workflow scheme
    • Delete workflow for issue type in draft workflow scheme
    • Publish draft workflow scheme
    • Get issue types for workflows in draft workflow scheme
    • Set issue types for workflow in workflow scheme
    • Delete issue types for workflow in draft workflow scheme
  • App properties
    • Get app properties
    • Get app property
    • Set app property
    • Delete app property
    • Set app property (Forge)
    • Delete app property (Forge)
  • Dynamic modules
    • Get modules
    • Register modules
    • Remove modules
  • App migration
    • Bulk update custom field value
    • Bulk update entity properties
    • Get workflow transition rule configurations
  1. Projects

Get recent projects

GET
/rest/api/3/project/recent
Returns a list of up to 20 projects recently viewed by the user that are still visible to the user.
This operation can be accessed anonymously.
Permissions required: Projects are returned only where the user has one of:
Browse Projects project permission for the project.
Administer Projects project permission for the project.
Administer Jira global permission.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://jira.local:8080/jira/rest//rest/api/3/project/recent'
Response Response Example
200 - Success
[{"self":"https://your-domain.atlassian.net/rest/api/3/project/EX","id":"10000","key":"EX","name":"Example","avatarUrls":{"48x48":"https://your-domain.atlassian.net/secure/projectavatar?size=large&pid=10000","24x24":"https://your-domain.atlassian.net/secure/projectavatar?size=small&pid=10000","16x16":"https://your-domain.atlassian.net/secure/projectavatar?size=xsmall&pid=10000","32x32":"https://your-domain.atlassian.net/secure/projectavatar?size=medium&pid=10000"},"projectCategory":{"self":"https://your-domain.atlassian.net/rest/api/3/projectCategory/10000","id":"10000","name":"FIRST","description":"First Project Category"},"simplified":false,"style":"classic","insight":{"totalIssueCount":100,"lastIssueUpdateTime":"2023-07-12T06:03:00.831+0000"}},{"self":"https://your-domain.atlassian.net/rest/api/3/project/ABC","id":"10001","key":"ABC","name":"Alphabetical","avatarUrls":{"48x48":"https://your-domain.atlassian.net/secure/projectavatar?size=large&pid=10001","24x24":"https://your-domain.atlassian.net/secure/projectavatar?size=small&pid=10001","16x16":"https://your-domain.atlassian.net/secure/projectavatar?size=xsmall&pid=10001","32x32":"https://your-domain.atlassian.net/secure/projectavatar?size=medium&pid=10001"},"projectCategory":{"self":"https://your-domain.atlassian.net/rest/api/3/projectCategory/10000","id":"10000","name":"FIRST","description":"First Project Category"},"simplified":false,"style":"classic","insight":{"totalIssueCount":100,"lastIssueUpdateTime":"2023-07-12T06:03:00.831+0000"}}]

Request

Query Params
expand
string 
optional
Use expand to include additional information in the response. This parameter accepts a comma-separated list. Expanded options include:
description Returns the project description.
projectKeys Returns all project keys associated with a project.
lead Returns information about the project lead.
issueTypes Returns all issue types associated with the project.
url Returns the URL associated with the project.
permissions Returns the permissions associated with the project.
insight EXPERIMENTAL. Returns the insight details of total issue count and last issue update time for the project.
* Returns the project with all available expand options.
properties
array[string]
optional
EXPERIMENTAL. A list of project properties to return for the project. This parameter accepts a comma-separated list. Invalid property names are ignored.

Responses

🟢200Returned if the request is successful.
application/json
Body
array of:
archived
boolean 
read-onlyoptional
Whether the project is archived.
archivedBy
object 
read-onlyoptional
The user who archived the project.
archivedDate
string <date-time>
read-onlyoptional
The date when the project was archived.
assigneeType
enum<string> 
read-onlyoptional
The default assignee when creating issues for this project.
Allowed values:
PROJECT_LEADUNASSIGNED
avatarUrls
object 
read-onlyoptional
The URLs of the project's avatars.
16x16
string <uri>
optional
The URL of the item's 16x16 pixel avatar.
24x24
string <uri>
optional
The URL of the item's 24x24 pixel avatar.
32x32
string <uri>
optional
The URL of the item's 32x32 pixel avatar.
48x48
string <uri>
optional
The URL of the item's 48x48 pixel avatar.
components
array[object (ProjectComponent) {13}] 
read-onlyoptional
List of the components contained in the project.
assignee
object 
read-onlyoptional
The details of the user associated with assigneeType, if any. See realAssignee for details of the user assigned to issues created with this component.
assigneeType
enum<string> 
optional
The nominal user type used to determine the assignee for issues created with this component. See realAssigneeType for details on how the type of the user, and hence the user, assigned to issues is determined. Can take the following values:
PROJECT_LEAD the assignee to any issues created with this component is nominally the lead for the project the component is in.
COMPONENT_LEAD the assignee to any issues created with this component is nominally the lead for the component.
UNASSIGNED an assignee is not set for issues created with this component.
PROJECT_DEFAULT the assignee to any issues created with this component is nominally the default assignee for the project that the component is in.
Default value: PROJECT_DEFAULT.
Optional when creating or updating a component.
Allowed values:
PROJECT_DEFAULTCOMPONENT_LEADPROJECT_LEADUNASSIGNED
description
string 
optional
The description for the component. Optional when creating or updating a component.
id
string 
read-onlyoptional
The unique identifier for the component.
isAssigneeTypeValid
boolean 
read-onlyoptional
Whether a user is associated with assigneeType. For example, if the assigneeType is set to COMPONENT_LEAD but the component lead is not set, then false is returned.
lead
object 
read-onlyoptional
The user details for the component's lead user.
leadUserName
string 
optional
This property is no longer available and will be removed from the documentation soon. See the deprecation notice for details.
name
string 
optional
The unique name for the component in the project. Required when creating a component. Optional when updating a component. The maximum length is 255 characters.
project
string 
optional
The key of the project the component is assigned to. Required when creating a component. Can't be updated.
projectId
integer <int64>
read-onlyoptional
The ID of the project the component is assigned to.
realAssignee
object 
read-onlyoptional
The user assigned to issues created with this component, when assigneeType does not identify a valid assignee.
realAssigneeType
enum<string> 
read-onlyoptional
The type of the assignee that is assigned to issues created with this component, when an assignee cannot be set from the assigneeType. For example, assigneeType is set to COMPONENT_LEAD but no component lead is set. This property is set to one of the following values:
PROJECT_LEAD when assigneeType is PROJECT_LEAD and the project lead has permission to be assigned issues in the project that the component is in.
COMPONENT_LEAD when assigneeType is COMPONENT_LEAD and the component lead has permission to be assigned issues in the project that the component is in.
UNASSIGNED when assigneeType is UNASSIGNED and Jira is configured to allow unassigned issues.
PROJECT_DEFAULT when none of the preceding cases are true.
Allowed values:
PROJECT_DEFAULTCOMPONENT_LEADPROJECT_LEADUNASSIGNED
self
string <uri>
read-onlyoptional
The URL of the component.
deleted
boolean 
read-onlyoptional
Whether the project is marked as deleted.
deletedBy
object 
read-onlyoptional
The user who marked the project as deleted.
deletedDate
string <date-time>
read-onlyoptional
The date when the project was marked as deleted.
description
string 
read-onlyoptional
A brief description of the project.
email
string 
optional
An email address associated with the project.
expand
string 
read-onlyoptional
Expand options that include additional project details in the response.
favourite
boolean 
optional
Whether the project is selected as a favorite.
id
string 
optional
The ID of the project.
insight
object 
read-onlyoptional
Insights about the project.
lastIssueUpdateTime
string <date-time>
read-onlyoptional
The last issue update time.
totalIssueCount
integer <int64>
read-onlyoptional
Total issue count.
isPrivate
boolean 
read-onlyoptional
Whether the project is private.
issueTypeHierarchy
object 
read-onlyoptional
The issue type hierarchy for the project.
baseLevelId
integer <int64>
optional
The ID of the base level. This property is deprecated, see Change notice: Removing hierarchy level IDs from next-gen APIs.
levels
array[object (SimplifiedHierarchyLevel) {9}] 
read-onlyoptional
Details about the hierarchy level.
issueTypes
array[object (IssueTypeDetails) {10}] 
read-onlyoptional
List of the issue types available in the project.
avatarId
integer <int64>
read-onlyoptional
The ID of the issue type's avatar.
description
string 
read-onlyoptional
The description of the issue type.
entityId
string <uuid>
read-onlyoptional
Unique ID for next-gen projects.
hierarchyLevel
integer <int32>
read-onlyoptional
Hierarchy level of the issue type.
iconUrl
string 
read-onlyoptional
The URL of the issue type's avatar.
id
string 
read-onlyoptional
The ID of the issue type.
name
string 
read-onlyoptional
The name of the issue type.
scope
object 
read-onlyoptional
Details of the next-gen projects the issue type is available in.
self
string 
read-onlyoptional
The URL of these issue type details.
subtask
boolean 
read-onlyoptional
Whether this issue type is used to create subtasks.
key
string 
read-onlyoptional
The key of the project.
landingPageInfo
object 
read-onlyoptional
The project landing page info.
attributes
object 
optional
boardId
integer <int64>
optional
boardName
string 
optional
projectKey
string 
optional
projectType
string 
optional
queueCategory
string 
optional
queueId
integer <int64>
optional
queueName
string 
optional
simpleBoard
boolean 
optional
simplified
boolean 
optional
url
string 
optional
lead
object 
read-onlyoptional
The username of the project lead.
name
string 
read-onlyoptional
The name of the project.
permissions
object 
read-onlyoptional
User permissions on the project
canEdit
boolean 
read-onlyoptional
Whether the logged user can edit the project.
projectCategory
object 
read-onlyoptional
The category the project belongs to.
description
string 
optional
The description of the project category.
id
string 
read-onlyoptional
The ID of the project category.
name
string 
optional
The name of the project category. Required on create, optional on update.
self
string <uri>
read-onlyoptional
The URL of the project category.
projectTypeKey
enum<string> 
read-onlyoptional
The project type of the project.
Allowed values:
softwareservice_deskbusiness
properties
object 
read-onlyoptional
Map of project properties
Additional properties
read-onlyoptional
retentionTillDate
string <date-time>
read-onlyoptional
The date when the project is deleted permanently.
roles
object 
read-onlyoptional
The name and self URL for each role defined in the project. For more information, see Create project role.
Additional properties
string <uri>
read-onlyoptional
self
string <uri>
read-onlyoptional
The URL of the project details.
simplified
boolean 
read-onlyoptional
Whether the project is simplified.
style
enum<string> 
read-onlyoptional
The type of the project.
Allowed values:
classicnext-gen
url
string 
read-onlyoptional
A link to information about this project, such as project documentation.
uuid
string <uuid>
read-onlyoptional
Unique ID for next-gen projects.
versions
array[object (Version) {17}] 
read-onlyoptional
The versions defined in the project. For more information, see Create version.
archived
boolean 
optional
Indicates that the version is archived. Optional when creating or updating a version.
description
string 
optional
The description of the version. Optional when creating or updating a version.
expand
string 
optional
Use expand to include additional information about version in the response. This parameter accepts a comma-separated list. Expand options include:
operations Returns the list of operations available for this version.
issuesstatus Returns the count of issues in this version for each of the status categories to do, in progress, done, and unmapped. The unmapped property contains a count of issues with a status other than to do, in progress, and done.
Optional for create and update.
id
string 
read-onlyoptional
The ID of the version.
issuesStatusForFixVersion
object 
read-onlyoptional
If the expand option issuesstatus is used, returns the count of issues in this version for each of the status categories to do, in progress, done, and unmapped. The unmapped property contains a count of issues with a status other than to do, in progress, and done.
moveUnfixedIssuesTo
string <uri>
optional
The URL of the self link to the version to which all unfixed issues are moved when a version is released. Not applicable when creating a version. Optional when updating a version.
name
string 
optional
The unique name of the version. Required when creating a version. Optional when updating a version. The maximum length is 255 characters.
operations
array[object (SimpleLink) {7}] 
read-onlyoptional
If the expand option operations is used, returns the list of operations available for this version.
overdue
boolean 
read-onlyoptional
Indicates that the version is overdue.
project
string 
optional
Deprecated. Use projectId.
projectId
integer <int64>
optional
The ID of the project to which this version is attached. Required when creating a version. Not applicable when updating a version.
releaseDate
string <date>
optional
The release date of the version. Expressed in ISO 8601 format (yyyy-mm-dd). Optional when creating or updating a version.
released
boolean 
optional
Indicates that the version is released. If the version is released a request to release again is ignored. Not applicable when creating a version. Optional when updating a version.
self
string <uri>
read-onlyoptional
The URL of the version.
startDate
string <date>
optional
The start date of the version. Expressed in ISO 8601 format (yyyy-mm-dd). Optional when creating or updating a version.
userReleaseDate
string 
read-onlyoptional
The date on which work on this version is expected to finish, expressed in the instance's Day/Month/Year Format date format.
userStartDate
string 
read-onlyoptional
The date on which work on this version is expected to start, expressed in the instance's Day/Month/Year Format date format.
🟠400Returned if the request is not valid.
🟠401Returned if the authentication credentials are incorrect or missing.
Modified at 2023-07-13 03:27:27
Previous
Create project
Next
Get projects paginated
Built with