[SOLVED] How do you create a project in a specific group via GitLab API?

Issue

I tried to use GitLab API to create a new project. This worked, but this is in my user space:

        curl \
            --header "Authorization: Bearer ${GITLAB_API_TOKEN}" \
            --request POST \
            "https://gitlab.com/api/v4/projects/?name=$test-proj"

But I wanted to do it under a specific group with group_id <group_id> (I blanked it here). The most sensible approach that occured to me was:

        curl \
            --header "Authorization: Bearer ${GITLAB_API_TOKEN}" \
            --request POST \
            "https://gitlab.com/api/v4/groups/<group_id>/projects/?name=test-proj

But this did not work. Are there any suggestions on how I could achieve this?

I consulted the following references

• https://forum.gitlab.com/t/create-a-new-project-in-a-group-using-api/1552
• https://docs.gitlab.com/ee/api/projects.html#create-project

The GitLab documentation mentions the path or namespace_id attribute (although I would actually be in search of a group_id attribute). I am not sure about path and how to specify that. I tried - without success - to retrieve the namespace_id via

curl --header "PRIVATE-TOKEN: ${GITLAB_API_TOKEN}" "https://gitlab.example.com/api/v4/namespaces"

It is well possible that I might not have the rights to do the required operation. Therefore a reference to an official (GitLab) documentation together with a test curl command that works would be very helpful to me - thank you!

Solution

Both users and groups are considered "namespaces" as far as the Gitlab API is concerned, so you can use either a group ID or a username in the namespace_id field. You can see this in use by getting a single namespace with either a Group ID (that you can see in the /groups API call, or from a Group's "profile" page) or a username:

# this will show the namespace details of the Group with ID 54
curl --header "PRIVATE-TOKEN: ${TOKEN}" "https://gitlab.com/api/v4/namespaces/54

# this will show the namespace details of the User with username my-username
curl --header "PRIVATE-TOKEN: ${TOKEN}" "https://gitlab.com/api/v4/namespace/my-username

Answered By - Adam Marshall