bomAssemblies

Requires permission biddesk:assembly:read.

The organisation's assemblies (products with a live bill of materials), sorted by name, with released and draft version numbers. Filter by name and by version state. Requires Bid Desk with engineered products and permission to read assemblies.

Errors: a failed call returns a GraphQL errors entry, not a field on the result, and data may be null or partial. Read the entry's extensions.code and message; every shape and code is in the Error reference.

Example:

GraphQL

query BomAssemblies {
  bomAssemblies {
    hasMore
    totalCount
    items {
      name
      draftVersionNo
      lastChangedAt
      productId
      productStatus
      releasedVersionNo
    }
  }
}

cURL

curl -X POST "https://<api-host>/graphql" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data @- <<'EOF'
{
  "query": "query BomAssemblies {\n  bomAssemblies {\n    hasMore\n    totalCount\n    items {\n      name\n      draftVersionNo\n      lastChangedAt\n      productId\n      productStatus\n      releasedVersionNo\n    }\n  }\n}"
}
EOF

Response:

{
  "data": {
    "bomAssemblies": {
      "hasMore": true,
      "totalCount": 0,
      "items": [
        {
          "name": "string",
          "draftVersionNo": 0,
          "lastChangedAt": "2025-01-15T00:00:00Z",
          "productId": "id",
          "productStatus": "ACTIVE",
          "releasedVersionNo": 0
        }
      ]
    }
  }
}

bomAssemblies(
  filter: BomAssembliesFilterInput
): BomAssemblyPage!

Arguments

bomAssemblies.filter ● BomAssembliesFilterInput input

Search, version state and paging.

Type

BomAssemblyPage object

One page of assemblies, sorted by name.