List all projects starred by a user

GET

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

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

Authorizations

http
oauth2

Parameters

Path Parameters

user_id

required

string

The ID or username of the user

Query Parameters

order_by

string

default: created_at nullable

Allowed values: 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

string

default: desc nullable

Allowed values: asc desc

Return projects sorted in ascending and descending order

archived

boolean

nullable

Limit by archived status

visibility

string

nullable

Allowed values: private internal public

Limit by visibility

search

string

nullable

Return list of projects matching the search criteria

search_namespaces

boolean

nullable

Include ancestor namespaces when matching search criteria

owned

boolean

nullable

Limit by owned by authenticated user

starred

boolean

nullable

Limit by starred status

imported

boolean

nullable

Limit by imported by authenticated user

membership

boolean

nullable

Limit by projects that the current user is a member of

with_issues_enabled

boolean

nullable

Limit by enabled issues feature

with_merge_requests_enabled

boolean

nullable

Limit by enabled merge requests feature

with_programming_language

string

nullable

Limit to repositories which use the given programming language

min_access_level

integer

nullable

Allowed values: 10 15 20 25 30 40 50

Limit by minimum access level of authenticated user

id_after

integer

nullable

Limit results to projects with IDs greater than the specified ID

id_before

integer

nullable

Limit results to projects with IDs less than the specified ID

last_activity_after

string format: date-time

nullable

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

last_activity_before

string format: date-time

nullable

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

repository_storage

string

nullable

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

topic

Array<string>

nullable

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

topic_id

integer

nullable

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

updated_before

string format: date-time

nullable

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

updated_after

string format: date-time

nullable

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

include_pending_delete

boolean

nullable

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

marked_for_deletion_on

string format: date

nullable

Date when the project was marked for deletion

active

boolean

nullable

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

wiki_checksum_failed

boolean

nullable

Limit by projects where wiki checksum is failed

repository_checksum_failed

boolean

nullable

Limit by projects where repository checksum is failed

include_hidden

boolean

nullable

Include hidden projects. Can only be set by admins

page

integer

default: 1 nullable

Current page number

Example

per_page

integer

default: 20 nullable

Number of items per page

Example

simple

boolean

nullable

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

statistics

boolean

nullable

Include project statistics

Responses

200

application/json

object

integer format: int64

description

string

name

string

name_with_namespace

string

path

string

path_with_namespace

string

created_at

string format: date-time

default_branch

string

tag_list

Array<string>

topics

Array<string>

ssh_url_to_repo

string

http_url_to_repo

string

web_url

string

readme_url

string

forks_count

integer

license_url

string

license

object

key

string

name

string

nickname

string

html_url

string

source_url

string

avatar_url

string

star_count

integer

last_activity_at

string format: date-time

visibility

string

namespace

object

integer format: int64

name

string

path

string

kind

string

full_path

string

parent_id

integer format: int64

avatar_url

string

web_url

string

custom_attributes

object

key

string

value

string

repository_storage

string

Example

{
  "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"
}

400

Bad Request

404

404 User Not Found