Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.junction.com/llms.txt

Use this file to discover all available pages before exploring further.

Lab accounts encapsulate the information needed to place orders and receive results for a particular lab. They are tied to Orgs and can be dynamically linked to as many Teams within the Org as desired. When an active lab account is linked to a Team, that Team can place orders using that lab account. A Team can have multiple lab accounts linked, even for a single lab, but an individual order must be placed with a single lab account. The Create Order endpoint accepts a lab_account_id to specify the lab account.
If lab_account_id is not provided when placing an order, we will try to determine an appropriate lab account based on available information, but if we cannot unambiguously find one lab account that should be used, we might not be able to place the order. We recommend including the lab_account_id when possible.
Lab accounts for an Org can be viewed using the Get Lab Accounts (Org-level) endpoint. Teams can fetch their available lab accounts using Get Lab Accounts (Team-level). Team linkage is managed only through the Update Lab Account Teams (Org-level) endpoint.

​
Which endpoint should I use?

Use both endpoints for different jobs. They are complementary, not interchangeable.
TopicOrg-level Get Lab AccountsTeam-level Get Lab Accounts
ScopeReturns lab accounts for the Org, across teamsReturns lab accounts available to one team context
Typical userOrg admin or platform integratorTeam-scoped integration
Best use caseOrg-wide visibility and managementTeam-specific runtime operations
Filtering behaviorCan be used to review accounts at the Org level and understand team linkageReturns only accounts available in the current team context
Recommendation:
  • Use the team-level endpoint when operating within one team context.
  • Use the org-level endpoint when you need cross-team, org-level management views.
  • There is no team-level endpoint for updating lab account team linkage.
Practical examples:
  • Org-level endpoint: An operations admin audits all lab accounts in the Org and confirms which teams are linked to each account.
  • Team-level endpoint: A team-specific ordering workflow fetches only the lab accounts that team can use before creating an order.
You can also view lab accounts tied to your Org on the Lab Interface Requests page of your Org Config in the Junction dashboard.