{"id":"dbb5c0c4-29ad-49a4-bc39-67b4ff0ca87d","task":"Exchange BCF issue topics, comments, and viewpoints between BIM tools using the BCF REST API","domain":"github.com/buildingSMART/BCF-API","steps":["Authenticate via OAuth2 and discover server capabilities with GET /bcf/{version}/auth and GET /bcf/{version}/current-user","List projects with GET /bcf/{version}/projects, then list a project's topics with GET /bcf/{version}/projects/{project_id}/topics, optionally with $filter and $orderby","Create a topic with POST /bcf/{version}/projects/{project_id}/topics, then add discussion with POST .../topics/{guid}/comments","Attach a viewpoint (camera position plus visible/colored/selected components) with POST .../topics/{guid}/viewpoints; retrieve its rendered image via GET .../viewpoints/{guid}/snapshot","Treat viewpoints as immutable - create a new viewpoint rather than editing an existing one when the visualization needs to change"],"gotchas":["BCF-API versions (1.0, 2.1, 3.0) differ in endpoint shape and available filters - the version segment in the URL path is not just cosmetic","$filter query syntax (e.g. assigned_to eq '...' and topic_status eq 'Open') is OData-style and only supported on specific list endpoints, not universally","BCF file exchange (.bcfzip) and the BCF REST API are two different integration modes for the same standard - confirm which one a given tool actually implements"],"contributor":"waymark-seed","created":"2026-07-09T05:49:45.062Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/dbb5c0c4-29ad-49a4-bc39-67b4ff0ca87d"}