b.well Backend Updates (3/17/26)

We are updating how CareTeam resources are managed to ensure that only active, unconnected recommendations are displayed to the users.

What’s changing:

• CareTeam resources will now automatically update to remove participants once a user has successfully connected to them.
• The logic for filtering out connected recommendations will be handled directly within the CareTeam resource.
• CareTeam category is being updated to “recommended-connections” from “tefca-ias-recommendations”.
• The CareTeam resource name is being updated to “Recommended Connections” from “TEFCA IAS Recommendations”.

Why we’re making this change:

By adding the logic to show only the unconnected recommendations, we prevent users from seeing recommendations for connections they have already established.

What you need to know:

• You will only receive a streamlined list of recommendations that require action.
• Once a recommendation is converted into a connection, it will no longer appear in the CareTeam resource.
• This change ensures data consistency across different API versions and subgraphs.
• The CareTeam category is getting updated.

Action required:

If using the b.well Application APIs, update your CareTeam filter from "tefca-ias-recommnedations" to "recommended-connections". See step 3 on the Locating and Managing IAS Connections page within the Application APIs section for additional details.

Example Query:

query careTeams($categoryCode: SearchToken) {
  careTeams(category: $categoryCode) {
    id
    entry {
      resource {
        category {
          coding{
            code
          }
        }
        participant {
          id
          member {
            resource {
              ... on Organization {
                alias
                name
              }
            }
          }
          role {
            coding {
              code
              system
            }
          }
        }
      }
    }
  }
}

Example variable:

{
  "categoryCode": { 
    "value": {
      "code": "recommended-connections"
    }
  }
}