- Prerequisites
- Get the add-on purchase ID
- Assign a GitLab Duo seat to specific users
- Use GraphiQL
- Related topics
Assign GitLab Duo seats by using GraphQL
Tier: Premium, Ultimate
Offering: GitLab.com
Use the GraphQL API to assign GitLab Duo seats to users.
Prerequisites
- You must have the Owner role for the group you want to assign seats to.
- You must have a personal access token with the
api
scope.
Get the add-on purchase ID
To start, retrieve the purchase ID for the GitLab Duo add-on:
query {
addOnPurchases (namespaceId: "gid://gitlab/Group/YOUR_NAMESPACE_ID")
{
name
purchasedQuantity
assignedQuantity
id
}
}
Assign a GitLab Duo seat to specific users
Then assign seats to specific users:
mutation {
userAddOnAssignmentBulkCreate(input: {
addOnPurchaseId: "gid://gitlab/GitlabSubscriptions::AddOnPurchase/YOUR_ADDON_PURCHASE_ID",
userIds: [
"gid://gitlab/User/USER_ID_1",
"gid://gitlab/User/USER_ID_2",
"gid://gitlab/User/USER_ID_3"
]
}) {
addOnPurchase {
id
name
assignedQuantity
purchasedQuantity
}
users {
nodes {
id
username
}
}
errors
}
}
Use GraphiQL
You can use GraphiQL to assign seats to users.
- Copy the add-on purchase ID code excerpt.
- Open GraphiQL.
-
In the left window, enter the query:
query { addOnPurchases (namespaceId: "gid://gitlab/Group/YOUR_NAMESPACE_ID") { name purchasedQuantity assignedQuantity id } }
- Select Play.
- Repeat to assign a GitLab Duo seat to specific users.