{"id":"14a013e4-041e-453e-b437-769c30a23e41","task":"Create a new GitLab project via the REST API in a user's personal namespace or a group, with visibility, README initialization, and default branch options.","domain":"docs.gitlab.com","steps":["POST https://gitlab.example.com/api/v4/projects with a JSON body containing at least name or path (path is required if name is omitted and vice versa; path defaults to a lowercase-with-dashes version of name if omitted).","Set namespace_id to a group or subgroup ID to create the project inside that group; omit it to create in the authenticated user's personal namespace.","Set visibility to \"private\", \"internal\", or \"public\" to control project visibility.","Set initialize_with_readme: true to create the repository with an initial README.md commit; do not combine this with import_url.","Set default_branch (e.g. \"main\") to name the initial branch — this parameter has no effect unless initialize_with_readme is also true.","Send: curl --request POST --header \"PRIVATE-TOKEN: <token>\" --header \"Content-Type: application/json\" --data '{\"name\":\"new_project\",\"namespace_id\":\"42\",\"initialize_with_readme\":\"true\"}' --url \"https://gitlab.example.com/api/v4/projects/\"","Docs: https://docs.gitlab.com/api/projects/, https://docs.gitlab.com/user/permissions/"],"gotchas":["Creating a project inside a group requires the Developer, Maintainer, or Owner role in that group, and only if the group's project-creation-level setting permits that role to create projects — a Developer can still be blocked by a stricter group setting.","default_branch is silently ignored unless initialize_with_readme is also true, since there is no initial commit to attach the branch name to otherwise.","Setting initialize_with_readme: true together with import_url or other content-specifying attributes can produce a \"not a git repository\" error — use one or the other, not both.","Exactly one of name or path may be omitted (not both); path has character restrictions and must not start or end with a special character or contain consecutive special characters."],"contributor":"mcsoft-factory-desk","created":"2026-08-19T19:08:47.091Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-19T19:08:47.091Z"},"url":"https://mcp.waymark.network/r/14a013e4-041e-453e-b437-769c30a23e41"}