GIgitlab
projects

List all projects starred by a user

Lists all visible projects starred by a specified user. Unauthenticated requests return only public projects.

get/api/v4/users/{user_id}/starred_projects

Request

  • Base URL
    https://gitlab.com
  • Auth
    none declared

Path parameters

user_idstring required

The ID or username of the user

Query parameters

order_by'id' | 'name' | 'path' | 'created_at' | 'updated_at' | 'last_activity_at' | 'similarity' | 'star_count' | 'storage_size' | 'repository_size' | 'wiki_size' | 'packages_size'

Return projects ordered by field. storage_size, repository_size, wiki_size, packages_size are only available to admins. Similarity is available when searching and is limited to projects the user has access to.

sort'asc' | 'desc'

Return projects sorted in ascending and descending order

archivedboolean

Limit by archived status

visibility'private' | 'internal' | 'public'

Limit by visibility

searchstring

Return list of projects matching the search criteria

search_namespacesboolean

Include ancestor namespaces when matching search criteria

ownedboolean

Limit by owned by authenticated user

starredboolean

Limit by starred status

importedboolean

Limit by imported by authenticated user

membershipboolean

Limit by projects that the current user is a member of

with_issues_enabledboolean

Limit by enabled issues feature

with_merge_requests_enabledboolean

Limit by enabled merge requests feature

with_programming_languagestring

Limit to repositories which use the given programming language

min_access_level10 | 15 | 20 | 25 | 30 | 40 | 50

Limit by minimum access level of authenticated user

id_afterinteger

Limit results to projects with IDs greater than the specified ID

id_beforeinteger

Limit results to projects with IDs less than the specified ID

last_activity_afterstring date-time

Limit results to projects with last_activity after specified time. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ

last_activity_beforestring date-time

Limit results to projects with last_activity before specified time. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ

repository_storagestring

Which storage shard the repository is on. Available only to admins

topicstring[]

Comma-separated list of topics. Limit results to projects having all topics

topic_idinteger

Limit results to projects with the assigned topic given by the topic ID

updated_beforestring date-time

Return projects updated before the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ

updated_afterstring date-time

Return projects updated after the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ

include_pending_deleteboolean

Include projects in pending delete state. Can only be set by admins

marked_for_deletion_onstring date

Date when the project was marked for deletion

activeboolean

Limit by projects that are not archived and not marked for deletion

wiki_checksum_failedboolean

Limit by projects where wiki checksum is failed

repository_checksum_failedboolean

Limit by projects where repository checksum is failed

include_hiddenboolean

Include hidden projects. Can only be set by admins

pageinteger

Current page number

per_pageinteger

Number of items per page

simpleboolean

Return only the ID, URL, name, and path of each project

statisticsboolean

Include project statistics

Response

List all projects starred by a user

idinteger required
descriptionstring required
namestring required
name_with_namespacestring required
pathstring required
path_with_namespacestring required
created_atstring date-time required
default_branchstring
tag_liststring[] required
topicsstring[] required
ssh_url_to_repostring required
http_url_to_repostring required
web_urlstring required
readme_urlstring
forks_countinteger
license_urlstring
avatar_urlstring required
star_countinteger required
last_activity_atstring date-time required
visibilitystring required
repository_storagestring

Example response

[
  {
    "id": 1,
    "description": "desc",
    "name": "project1",
    "name_with_namespace": "John Doe / project1",
    "path": "project1",
    "path_with_namespace": "namespace1/project1",
    "created_at": "2020-05-07T04:27:17.016Z",
    "default_branch": "main",
    "tag_list": [
      "tag"
    ],
    "topics": [
      "topic"
    ],
    "ssh_url_to_repo": "git@gitlab.example.com:gitlab/gitlab.git",
    "http_url_to_repo": "https://gitlab.example.com/gitlab/gitlab.git",
    "web_url": "https://gitlab.example.com/gitlab/gitlab",
    "readme_url": "https://gitlab.example.com/gitlab/gitlab/blob/master/README.md",
    "forks_count": 1,
    "license_url": "https://gitlab.example.com/gitlab/gitlab/blob/master/LICENCE",
    "license": {
      "key": "gpl-3.0",
      "name": "GNU General Public License v3.0",
      "nickname": "GNU GPLv3",
      "html_url": "http://choosealicense.com/licenses/gpl-3.0"
    },
    "avatar_url": "http://example.com/uploads/project/avatar/3/uploads/avatar.png",
    "star_count": 1,
    "last_activity_at": "2013-09-30T13:46:02Z",
    "visibility": "public",
    "namespace": {
      "id": 2,
      "name": "project",
      "path": "my_project",
      "kind": "project",
      "full_path": "group/my_project",
      "parent_id": 1,
      "avatar_url": "https://example.com/avatar/12345",
      "web_url": "https://example.com/group/my_project"
    },
    "custom_attributes": {
      "key": "foo",
      "value": "bar"
    },
    "repository_storage": "default"
  }
]

Changes

No recorded changes to this operation across all 5 revisions of this API.