Task 2 - Choose a Product Pool
In this task, you list the product pools available to your team and choose the product to assign.
By the end of this task you will be able to:
- List the product pools of a team.
- Read a pool’s seat counts and dates.
- Choose the product ID to assign.
You will use the following operation in this task:
| Operation | HTTP request |
|---|---|
| List Product Pools | GET /teams/{team-id}/product-pools |
Step 1 - List the product pools
In Postman, run the List product pools request.
The request
Postman sends this request with the collection’s authorization adding your access token. The following cURL command shows the structure of the request. You don’t need to run it.
curl -X GET \
'https://developer.api.autodesk.com/team-admin/v1/teams/<YOUR_TEAM_ID>/product-pools?limit=50' \
-H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'
Response
Postman shows a response like this:
{
"data": [
{
"productId": "prod_8f3a1c9d7b2e",
"teamId": "100001",
"totalQuantity": 25,
"assignedQuantity": 18,
"unlimited": false,
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2027-01-01T00:00:00.000Z",
"productName": "Example Product Premium"
}
],
"pagination": {
"cursor": null,
"hasMore": false
}
}
Show More
Each product pool has these fields:
productId: the ID of the product. You use it to assign the product.productName: the name of the product.totalQuantityandassignedQuantity: the number of seats in the pool, and the number currently assigned.unlimited:truewhen the pool has an unlimited number of seats.startDateandendDate: the dates between which the pool is usable.
The response lists only supported pools whose seats you can assign to users.
Step 2 - Read the seat counts and dates
Before you choose a pool, check the following:
- Unlimited pools: when
unlimitedistrue,totalQuantityandassignedQuantityare bothnull. The pool has no seat limit. - Future-dated pools: the response includes pools that haven’t started yet. For such a pool,
assignedQuantitycan benulleven when the pool has a fixed number of seats. Don’t readnullas zero. ComparestartDateandendDatewith today’s date to see whether the pool is usable now. - Seat counts change: another request can use a seat between the time you read the pool and the time you assign the product. Be ready for the assignment in the next task to be rejected, even when the pool showed free seats.
Note the productId of the pool you want. In later requests, this ID replaces <YOUR_PRODUCT_ID>. In Postman, set the product_id variable to it.
See also
- Continue with Task 3 - Assign the Product.