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.
Related topics
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support