---
title: "Unstar a project"
method: POST
path: "/api/v4/projects/{id}/unstar"
tags: ["projects"]
---

# Unstar a project

`POST /api/v4/projects/{id}/unstar`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/projects/{id}/unstar`
- Auth: none declared

Unstars a specified project.

## Path parameters

- `id` string, required

## Response `201`

Unstar a project

- APIEntitiesProject: API_Entities_Project model
  - `id` integer, required
  - `description` string, required
  - `name` string, required
  - `name_with_namespace` string, required
  - `path` string, required
  - `path_with_namespace` string, required
  - `created_at` string, date-time, required
  - `default_branch` string
  - `tag_list` string[], required
  - `topics` string[], required
  - `ssh_url_to_repo` string, required
  - `http_url_to_repo` string, required
  - `web_url` string, required
  - `readme_url` string
  - `forks_count` integer
  - `license_url` string
  - `license` APIEntitiesLicenseBasic
    - `key` string, required
    - `name` string, required
    - `nickname` string, required
    - `html_url` string, required
    - `source_url` string, required
  - `avatar_url` string, required
  - `star_count` integer, required
  - `last_activity_at` string, date-time, required
  - `visibility` string, required
  - `namespace` APIEntitiesNamespaceBasic, required
    - `id` integer, required
    - `name` string, required
    - `path` string, required
    - `kind` string, required
    - `full_path` string, required
    - `parent_id` integer, required
    - `avatar_url` string, required
    - `web_url` string, required
  - `custom_attributes` APIEntitiesCustomAttribute: API_Entities_CustomAttribute model
    - `key` string, required
    - `value` string, required
  - `repository_storage` string
  - `forked_from_project` APIEntitiesBasicProjectDetails: API_Entities_BasicProjectDetails model
    - `id` integer, required
    - `description` string, required
    - `name` string, required
    - `name_with_namespace` string, required
    - `path` string, required
    - `path_with_namespace` string, required
    - `created_at` string, date-time, required
    - `default_branch` string
    - `tag_list` string[], required
    - `topics` string[], required
    - `ssh_url_to_repo` string, required
    - `http_url_to_repo` string, required
    - `web_url` string, required
    - `readme_url` string
    - `forks_count` integer
    - `license_url` string
    - `license` APIEntitiesLicenseBasic
      - `key` string, required
      - `name` string, required
      - `nickname` string, required
      - `html_url` string, required
      - `source_url` string, required
    - `avatar_url` string, required
    - `star_count` integer, required
    - `last_activity_at` string, date-time, required
    - `visibility` string, required
    - `namespace` APIEntitiesNamespaceBasic, required
      - `id` integer, required
      - `name` string, required
      - `path` string, required
      - `kind` string, required
      - `full_path` string, required
      - `parent_id` integer, required
      - `avatar_url` string, required
      - `web_url` string, required
    - `custom_attributes` APIEntitiesCustomAttribute: API_Entities_CustomAttribute model
      - `key` string, required
      - `value` string, required
    - `repository_storage` string
  - `container_registry_image_prefix` string
  - `_links` object, required
    - `self` string, required
    - `issues` string
    - `merge_requests` string
    - `repo_branches` string, required
    - `labels` string, required
    - `events` string, required
    - `members` string, required
    - `cluster_agents` string, required
  - `marked_for_deletion_at` string, date-time, required
  - `marked_for_deletion_on` string, date-time, required
  - `packages_enabled` boolean, required
  - `empty_repo` boolean, required
  - `archived` boolean, required
  - `owner` APIEntitiesUserBasic: API_Entities_UserBasic model
    - `id` integer, required
    - `username` string, required
    - `public_email` string, required
    - `name` string, required
    - `state` string, required
    - `locked` boolean, required
    - `avatar_url` string, required
    - `avatar_path` string
    - `custom_attributes` APIEntitiesCustomAttribute[]
      - `key` string, required
      - `value` string, required
    - `web_url` string, required
  - `resolve_outdated_diff_discussions` boolean, required
  - `container_expiration_policy` APIEntitiesContainerExpirationPolicy
    - `cadence` string, required
    - `enabled` string, required
    - `keep_n` string, required
    - `older_than` string, required
    - `name_regex` string, required
    - `name_regex_keep` string, required
    - `next_run_at` string, required
  - `repository_object_format` string, required
  - `issues_enabled` boolean, required
  - `merge_requests_enabled` boolean, required
  - `wiki_enabled` boolean, required
  - `jobs_enabled` boolean, required
  - `snippets_enabled` boolean, required
  - `container_registry_enabled` boolean, required
  - `service_desk_enabled` boolean, required
  - `service_desk_address` string
  - `can_create_merge_request_in` boolean, required
  - `issues_access_level` string, required
  - `repository_access_level` string, required
  - `merge_requests_access_level` string, required
  - `forking_access_level` string, required
  - `wiki_access_level` string, required
  - `builds_access_level` string, required
  - `snippets_access_level` string, required
  - `pages_access_level` string, required
  - `analytics_access_level` string, required
  - `container_registry_access_level` string, required
  - `security_and_compliance_access_level` string, required
  - `releases_access_level` string, required
  - `environments_access_level` string, required
  - `feature_flags_access_level` string, required
  - `infrastructure_access_level` string, required
  - `monitor_access_level` string, required
  - `model_experiments_access_level` string, required
  - `model_registry_access_level` string, required
  - `package_registry_access_level` string, required
  - `emails_disabled` boolean, required
  - `emails_enabled` boolean, required
  - `show_diff_preview_in_email` boolean, required
  - `shared_runners_enabled` boolean, required
  - `lfs_enabled` boolean, required
  - `creator_id` integer, required
  - `mr_default_target_self` boolean
  - `import_url` string
  - `import_type` string
  - `import_status` string, required
  - `import_error` string
  - `open_issues_count` integer
  - `description_html` string, required
  - `updated_at` string, date-time, required
  - `ci_default_git_depth` integer
  - `ci_delete_pipelines_in_seconds` integer
  - `ci_forward_deployment_enabled` boolean
  - `ci_forward_deployment_rollback_allowed` boolean
  - `ci_job_token_scope_enabled` boolean
  - `ci_separated_caches` boolean
  - `ci_allow_fork_pipelines_to_run_in_parent_project` boolean
  - `ci_id_token_sub_claim_components` string[]
  - `build_git_strategy` string
  - `keep_latest_artifact` boolean
  - `restrict_user_defined_variables` boolean
  - `ci_pipeline_variables_minimum_override_role` string
  - `runner_token_expiration_interval` integer
  - `group_runners_enabled` boolean
  - `resource_group_default_process_mode` string
  - `auto_cancel_pending_pipelines` string
  - `build_timeout` integer
  - `auto_devops_enabled` boolean
  - `auto_devops_deploy_strategy` string
  - `ci_push_repository_for_job_token_allowed` boolean
  - `protect_merge_request_pipelines` boolean
  - `ci_display_pipeline_variables` boolean
  - `runners_token` string
  - `ci_config_path` string
  - `public_jobs` boolean, required
  - `shared_with_groups` object[], required
  - `only_allow_merge_if_pipeline_succeeds` boolean, required
  - `allow_merge_on_skipped_pipeline` boolean, required
  - `request_access_enabled` boolean, required
  - `only_allow_merge_if_all_discussions_are_resolved` boolean, required
  - `remove_source_branch_after_merge` boolean, required
  - `printing_merge_request_link_enabled` boolean, required
  - `merge_method` string, required
  - `squash_option` string, required
  - `enforce_auth_checks_on_uploads` boolean, required
  - `suggestion_commit_message` string, required
  - `merge_commit_template` string, required
  - `squash_commit_template` string, required
  - `mr_default_title_template` string, required
  - `issue_branch_template` string, required
  - `statistics` APIEntitiesProjectStatistics
    - `commit_count` integer, required
    - `storage_size` integer, required
    - `repository_size` integer, required
    - `wiki_size` integer, required
    - `lfs_objects_size` integer, required
    - `job_artifacts_size` integer, required
    - `pipeline_artifacts_size` integer, required
    - `packages_size` integer, required
    - `snippets_size` integer, required
    - `uploads_size` integer, required
    - `container_registry_size` integer, required
  - `warn_about_potentially_unwanted_characters` boolean, required
  - `autoclose_referenced_issues` boolean, required
  - `max_artifacts_size` integer, required
  - `approvals_before_merge` string
  - `mirror` string
  - `mirror_user_id` string
  - `mirror_trigger_builds` string
  - `only_mirror_protected_branches` string
  - `mirror_overwrites_diverged_branches` string
  - `external_authorization_classification_label` string
  - `requirements_enabled` string, required
  - `requirements_access_level` string, required
  - `security_and_compliance_enabled` string, required
  - `secret_push_protection_enabled` boolean
  - `pre_receive_secret_detection_enabled` boolean
  - `compliance_frameworks` string, required
  - `issues_template` string
  - `merge_requests_template` string
  - `ci_restrict_pipeline_cancellation_role` string
  - `merge_pipelines_enabled` string
  - `merge_trains_enabled` string
  - `merge_trains_skip_train_allowed` string
  - `merge_train_enforcement` string
  - `max_pipelines_per_merge_train` string
  - `only_allow_merge_if_all_status_checks_passed` string
  - `allow_pipeline_trigger_approve_deployment` boolean
  - `prevent_merge_without_jira_issue` string
  - `auto_duo_code_review_enabled` string
  - `reviewer_assignment_strategy` string
  - `duo_remote_flows_enabled` string
  - `duo_foundational_flows_enabled` string
  - `duo_sast_fp_detection_enabled` string
  - `duo_secret_detection_fp_enabled` string
  - `duo_dependency_bump_breaking_changes_enabled` string
  - `duo_sast_vr_workflow_enabled` string
  - `web_based_commit_signing_enabled` string
  - `spp_repository_pipeline_access` boolean: The spp_repository_pipeline_access setting is only visible if the security_orchestration_policies feature is available.
  - `security_policy_pipeline_must_succeed` boolean: Require all security policy pipelines to succeed before merge requests can be merged.
  - `merge_request_title_regex` string
  - `merge_request_title_regex_description` string

## Other responses

- `304`: Not modified
- `403`: Unauthenticated

---

[API](https://skmtc.dev/gitlab/apis/gitlab-api.md) - [All operations](https://skmtc.dev/gitlab/apis/gitlab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitlab/apis/gitlab-api/revisions/b234947ef3f2?raw)