Request

Response

    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:

    OperationHTTP 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.
    • totalQuantity and assignedQuantity: the number of seats in the pool, and the number currently assigned.
    • unlimited: true when the pool has an unlimited number of seats.
    • startDate and endDate: 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 unlimited is true, totalQuantity and assignedQuantity are both null. The pool has no seat limit.
    • Future-dated pools: the response includes pools that haven’t started yet. For such a pool, assignedQuantity can be null even when the pool has a fixed number of seats. Don’t read null as zero. Compare startDate and endDate with 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