Get recent projects

GET

/rest/api/3/project/recent

Projects

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 Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://jira.local:8080/jira/rest//rest/api/3/project/recent'

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.

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.

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.

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.

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.

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.

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

Create project

Get projects paginated